Title: 2.11. Import 2.11. Import
Course: Library of Things >> Part 1: OpenSCAD Basics Library of Things >> Teil 1: Basiskurs in OpenSCAD > Section: 2. First steps 2. Erste Schritte

- Import is achieved by the command import()
- OpenSCAD supports currently STL, OFF, AMF, and 3MF 3D formats, and DXF, SVG 2D formats
- If you want to import another SCAD file, you need to use include<filename.scad> instead
- If you want to import an image, you can use surface()
- Parameters of import() are:

file >> This is the path to the file including filename (String). It is not absolute, but the relative path to the importing script. When using include<> with a script that uses import(), it is relative to the script using include<>

convexity >> Only used for optimize visualization in preview mode (Integer)

layer >> DXF only, it imports only a particular layer (Integer)

surface()

- Reads Height-map information from text or an image. It can read PNG files
- Parameters of surface() are:

file >> The path to the file, that contains the height-map data (String)

center >>This determines the positioning of the generated object (Boolean - default: false). If true, object is centered in X- and Y-axis. If false, object is placed in the positive quadrant

invert >> Inverts how the color value of images is translated to height (Boolean - default: false)

convexity >> Convexity parameter specifies the maximum number of front sides, or back sides (Integer). A ray intersecting the object might penetrate. This is only used for better preview, when pressing F5, it has no effect on F6.

Exercise:

Create your own busines card or other text graphics in 2D. If you want to use a image to the text, use import. After you finished, export it in dxf format!

import()

Follow the next steps in order to learn how to import an STL files!

- Go to your workshop folder (you did save your files in one folder, right!?)
- Create a folder called files
- Save following file into your files folder >> PotFace
- Use following code in your .scad file

import("files/potFace.stl");

Exercise:

Import your design! First, export it as stl. Then import it again via import()

Import SVG Vector Graphics

Before, download the file BunnySkull, and save it into the same files folder

Import an SVG Format and extrude it into a 3D shape:

linear_extrude(height=5, center=true, convexity=10)

translate([-107, -130, 0]) //It gets the graphic in offset of the coordinate system

import("files/bunnySkull.svg");

Note: you can use Inkscape, another open-source software to create your own graphics in SVG Format

surface() - Import Height-map from a height-map text file:

Again, use this Link to download the text file of height-map data, and save it into your files folder.

scale(5)

rotate([0, 0, -90])

surface(file="files/surface.dat", center=true);

Surface - Import Height-map via an image with PNG format

Download the PNG picture file here, and save it into your files folder.

scale([0.2, 0.2, 0.012])

translate([0, 0, 12])

surface(file="files/escooter_1920.png", center=true);

- Der Import erfolgt über den Befehl import().
- OpenSCAD unterstützt derzeit die 3D-Formate STL, OFF, AMF und 3MF sowie die 2D-Formate DXF, SVG.
- Wenn Sie eine andere SCAD-Datei importieren möchten, müssen Sie stattdessen include verwenden.
- Wenn Sie ein Bild importieren möchten, können Sie surface() verwenden.
- Parameter von import() sind:

file >> Dies ist der relative Pfad zur Datei einschließlich des Dateinamens zum importierenden Skript. Wenn include<> mit einem Skript verwendet wird, das import() verwendet, ist es relativ zu dem Skript, das include<> verwendet. (String)

convexity >> Wird nur zur Optimierung der Visualisierung im Vorschaumodus verwendet (Ganze Zahl)

layer >> Nur DXF, es wird nur ein bestimmter Layer importiert (Ganze Zahl)

surface()

- liest Heightmap-Informationen aus Text oder einem Bild. Es kann PNG-Dateien lesen.
- Parameter von surface() sind:

file >> Der Pfad zu der Datei, die die Heightmap-Daten enthält (String)

center >> Boolean (Default: false) >> Dies bestimmt die Positionierung des generierten Objekts. Wenn wahr, wird das Objekt in der X- und Y-Achse zentriert. Bei false wird das Objekt im positiven Quadranten platziert

invert >> Kehrt um, wie der Farbwert von Bildern in Höhe übersetzt wird. Es hat keine Auswirkungen auf importierte Textdateien (Boolean - default: false)

convexity >> Konvexität Parameter gibt die maximale Anzahl von Vorderseiten (Rückseiten) an ein Strahl, der das Objekt schneidet, könnte durchdringen. Dies wird nur für eine bessere Vorschau verwendet, wenn Sie F5 drücken, hat es keinen Einfluss auf F6

Übung:

Erstelle deine eigene Visitenkarte oder andere Textgrafiken in 2D. Wenn du ein Bild für den Text verwenden möchten, verwende Import. Wenn du fertig bist, exportiere es im dxf-Format!

import()

Folgen Sie den nächsten Schritten, um zu erfahren, wie Sie eine STL-Dateien importieren!

- Gehe in Deinen Werkstattordner (Du hast Deine Dateien in einem Ordner gespeichert, richtig!?)
- Erstelle einen Ordner namens Dateien
- Speichere folgende Datei in diesen Ordner>> PotFace
- Verwende folgenden Code in Deiner .scad Datei

import("Dateien/potFace.stl");

Übung:

Importieren - Importieren Sie Ihre Möbel! Zuerst als stl exportieren, dann über import() wieder importieren:

Import SVG Vector Graphics

Lade als erstes die Datei BunnySkull herunter, und speichere es in das selbe Verzeichnis namens Dateien.

Importiere ein SVG Format und extrudiere es in eine 3D-Form:

linear_extrude(height=5, center=true, convexity=10)

translate([-107, -130, 0]) //It gets the graphic in offset of the coordinate system

import("Dateien/bunnySkull.svg");

Hinweis: Du kannst Inkscape verwenden, eine weitere Open-Source-Software, um Ihre eigenen Grafiken im SVG-Format zu erstellen!

surface() - Importiere Heightmap aus einer Heightmap-Textdatei:

Lade wieder die Datei vom folgenden Link herunter und speichere sie in Dateien

scale(5)

rotate([0, 0, -90])

surface(file="Dateien/surface.dat", center=true);

Surface - Heightmap über ein Bild im PNG-Format importieren

Lade folgendes PNG Bilddatei here herunter und speichere sie unter Dateien

scale([0.2, 0.2, 0.012])

translate([0, 0, 12])

surface(file="files/escooter_1920.png", center=true);