← Customizer | Handbuch-Inhalt | Export →

Import

Es können Dateien in folgenden Formaten importiert werden: STL, 3MF, OFF, AMF, DXF, SVG, CSG

SVG-Import

OpenSCAD kann die geometrische Struktur von SVG-Dateien importieren.

import("file.svg");
import(file = "file.svg", center = false, dpi = 96);
import("file.svg", $fn = 100);  // {{requires|Development snapshot}}

Parameter

"file": Zeichenkette. Der Name der zu importierenden Datei.

"center": Boolescher Wert. Falls "true", wird die importierte Geometrie am Mittelpunkt ihrer umschließenden Bounding Box zentriert.

"dpi": Gleitkommazahl. Dieser DPI-Wert („dots per inch“) wird zur Berechnung der Größe des ViewBox-Bereichs verwendet, wenn im SVG keine absoluten Einheiten für "width"/"height" angegeben sind.

Falls weder "width"/"height" noch ein ViewBox vorhanden ist (z. B. bei SVG-Dateien aus älteren Versionen von Adobe Illustrator), kannst du über "dpi" die Skalierung beeinflussen. Beispiel: Soll jede Einheit im SVG einer Millimeter entsprechen, setze "dpi = 25.4" (da 1 Zoll = 25,4 mm). Hinweis: Wird im SVG eine absolute Einheit wie "px", "pt", "pc", "in", "mm" oder "cm" verwendet, wird der "dpi"-Wert ignoriert.

"$fn": Gleitkommazahl. Anzahl der Polygonsegmente beim Umwandeln von Kreisen, Bögen und Kurven in Polygone. Vorlage:Requires

"$fa": Gleitkommazahl. Minimaler Winkel-Schritt bei der Polygonisierung von Kreisen und Bögen. Vorlage:Requires

"$fs": Gleitkommazahl. Minimale Segmentlänge bei der Polygonisierung von Kreisen und Bögen. Vorlage:Requires

"id": Zeichenkette. Die ID eines bestimmten Elements oder Gruppe, das importiert werden soll. Vorlage:Requires

"layer": Zeichenkette. Der Name einer Ebene (Layer), die importiert werden soll – kompatibel mit der Art, wie Inkscape Ebenen in SVG-Dateien benennt. Vorlage:Requires

Einschränkungen

Scalable Vector Graphics (SVG) ist, wie der Name schon sagt, primär als skalierbares Grafikformat für Webseiten konzipiert – mit Fokus auf Darstellung, Interaktivität und Animation.

Daher lassen sich viele SVG-Features nicht sinnvoll in ein CAD-Format übertragen. OpenSCAD extrahiert daher nur die grundlegende Geometrie und wandelt sie in geschlossene 2D-Polygone um. Visuelle Effekte und Animationen werden ignoriert.

Folgende Funktionen werden nicht importiert:

Text / Schriftarten
Clipping und Masking
Objekte, die auf Vorlagen („templates“) basieren
Ursprungsposition des Koordinatensystems

Die Parameter "'$fn'", "'$fa'" und "'$fs'" können die Auflösung nur erhöhen, niemals reduzieren – verglichen mit der zuvor festgelegten Standardauflösung.

Umgang mit dem ViewBox-Attribut

Das ViewBox-Attribut definiert das ursprüngliche Koordinatensystem einer SVG-Datei. OpenSCAD unterstützt dabei sowohl die Skalierung als auch die Ausrichtung gemäß des "preserveAspectRatio"-Attributs. Eine hervorragende Einführung dazu bietet der Artikel „Understanding SVG Coordinate Systems and Transformations“.

Umgang mit DPI

(siehe Abschnitt oben unter *Parameter → dpi*)

Offene und geschlossene Formen

OpenSCAD verarbeitet nur geschlossene Polygone. Offene Pfade (z. B. einzelne Linien) können nicht direkt importiert werden. Stattdessen wird bei offenen Pfaden die "stroke-width" (Strichstärke) verwendet, um daraus eine umschließende Fläche zu erzeugen.

Geschlossene Formen (z. B. "<circle>", "<rect>", "<path>" mit geschlossenem Pfad) verwenden stets ihre geometrische Definition – unabhängig von "fill" oder "stroke-width". Ausnahme: Geschlossene "<polyline>"-Elemente werden wie offene Pfade behandelt und basieren auf der "stroke-width".