Begriffe vorab
- import(): Lädt externe Geometrie in das Modell.
- STL: Weit verbreitetes Format für 3D-Druck.
- 3MF: Containerformat für 3D-Druck-Modelle.
- DXF / SVG: Zweidimensionale Formate.
- surface(): Erzeugt aus Text- oder PNG-Daten ein Höhenfeld.
import()
import("datei.stl", convexity = 3); lädt externe Geometrie. file ist der Pfad (relativ zur importierenden Datei; unter Windows Schrägstriche oder doppelte Backslashes nutzen). convexity ist die maximale Zahl der Vorder- oder Rückseiten, die ein Strahl durchdringt (meist 10). layer wählt bei DXF und SVG eine Ebene. Weitere Parameter (center, id, $fn/$fa/$fs) nennt die Doku nur für Entwicklungs-Snapshots.
Importierbare Formate laut Doku
- 3D: STL (ASCII und binär), OFF, OBJ, AMF (veraltet), 3MF.
- 2D: DXF, PDF, SVG.
- Daten: JSON (Snapshot).
- Höhenfeld: PNG über
surface().
import_stl() und import_dxf() gelten als veraltet; verwende import().
surface()
surface(file, center, invert, convexity) erzeugt aus einer Text- oder PNG-Datei ein Höhenfeld – die Helligkeit oder der Zahlenwert bestimmt die Höhe.
Export
Welche Formate zur Wahl stehen, hängt davon ab, ob das Ergebnis 2D oder 3D ist. Laut Export-Seite:
- 3D: STL (ASCII), OFF, AMF (ab 2015.03), 3MF (ab 2019.05).
- 2D: DXF, SVG (ab 2015.03), PDF in A4 (ab 2021.01).
- Bild: PNG (ab 2019.05).
- CSG: eine vereinfachte Darstellung des Skripts.
Die Kommandozeile nennt zusätzlich die Varianten asciistl und binstl für STL. Exportiert wird das gerenderte Modell: erst F6, dann Export (Menü „Design“ bzw. Export-Befehle).
Praxis
- Für 3D-Druck sind STL oder 3MF üblich; prüfe, was dein Slicer erwartet.
- Soll ein Profil in ein anderes Programm (z. B. Laserschneider), nutze DXF oder SVG.
- Importierte STL-Dateien müssen manifold sein, sonst scheitert das Rendern (siehe Lektion zur Fehlersuche).
// Ein kleines Teil, das sich als STL exportieren lässt.
// Export im Programm: F6 (Rendern), dann Datei exportieren.
// Auf der Kommandozeile: openscad -o teil.stl dieses_skript.scad
difference() {
cube([30, 20, 8]);
translate([15, 10, -1]) cylinder(h = 10, d = 6, $fn = 48);
}Das Beispiel enthält absichtlich keine Importzeile, damit es ohne externe Dateien läuft. In einem echten Projekt stünde dort etwa import("gehaeuse.stl");.
Importiere nur Modelle, die du selbst auf Manifold-Eigenschaft geprüft hast – sonst verlierst du Zeit beim Rendern.
Zum Selbermachen
- Exportiere ein einfaches Teil als STL und als 3MF und vergleiche die Dateigrößen.
- Exportiere ein 2D-Profil als SVG und öffne es in einem Vektorprogramm.
Verwandte Themen
OpenSCAD → Die übrigen Lektionen dieser Themenwelt; Informatik: Grundlagen → „Algorithmen und Berechenbarkeit“ für das Denken in Schritten.
Prüfstatus: Belegt (Stand 1. Oktober 2026): Parameter von import() inkl. Snapshot-Hinweisen, die Liste der Import- und Exportformate samt Versionsangaben, der Hinweis zu import_stl/import_dxf sowie surface() wurden gegen die Seiten „Importing Geometry“, „Export“ und „Other Language Features“ geprüft. Alle Codebeispiele dieser Lektion wurden mit OpenSCAD 2026.09.18 (lokale Installation) ausgeführt und liefen ohne Fehler und Warnungen. Nicht einzeln belegt: die Angabe der Export-Seite „STL (ASCII only)“ im Verhältnis zu binstl auf der Kommandozeile (beides steht in der Doku, der Widerspruch wurde nicht aufgelöst) und der Hinweis zur Slicer-Eignung (Praxisempfehlung). Außerdem nicht einzeln belegt: die Erklärungen in eigenen Worten, die Beispiele als solche (konstruiert) und die Wertungen.
Quellen
- OpenSCAD User Manual – Importing Geometry (en.wikibooks.org/wiki/OpenSCAD_User_Manual/Importing_Geometry)
- OpenSCAD User Manual – Export (en.wikibooks.org/wiki/OpenSCAD_User_Manual/Export)
- OpenSCAD User Manual – Using OpenSCAD in a command line environment (en.wikibooks.org/wiki/OpenSCAD_User_Manual/Using_OpenSCAD_in_a_command_line_environment)
- OpenSCAD Cheat Sheet (openscad.org/cheatsheet, bezieht sich auf Version 2021.01)