Literatur und Lesepfad: die OpenSCAD-Dokumentation
Begriffe vorab
- Tutorial: Schrittweise Einführung in mehreren Kapiteln.
- User Manual: Ausführliches Handbuch zur Bedienung und Sprache.
- Language Reference: Teil des Handbuchs, der die Sprache im Detail beschreibt.
- Cheat Sheet: Kompakte Übersicht aller Befehle auf einer Seite.
- Library: Wiederverwendbare Sammlung von Modulen und Funktionen.
Die Landkarte der offiziellen Doku
Die Seite openscad.org/documentation.html verweist auf vier Hauptbereiche und weitere Quellen:
- OpenSCAD Tutorial (Wikibooks): neun Kapitel von den Grundlagen bis zu fortgeschrittener Geometrie.
- OpenSCAD User Manual (Wikibooks): Oberfläche, Einrichtung, Praxis und die vollständige Sprachreferenz.
- Cheat Sheet (openscad.org/cheatsheet): Kurzreferenz für Syntax, Module und Funktionen; bezieht sich auf Version 2021.01.
- Bücher, Videos, Artikel in eigenen Unterseiten, Bibliotheken auf libraries.html.
Aufbau des User Manuals
Das Handbuch gliedert sich in zwei Teile. Der erste umfasst Einführung, erste Schritte, Oberfläche, Eingabegeräte, Customizer, Import, Export, Beispielprojekte, Pfade, externe Editoren, Integration mit anderen Anwendungen, Kommandozeile, Kompilieren aus Quellen, FAQ, Bibliotheken, Tipps und Tricks sowie das Befehlsglossar. Der zweite Teil ist die Sprachreferenz: die Sprache selbst, 3D-Objekte, 2D-Objekte, Transformationen, boolesche Kombinationen, weitere Funktionen und Operatoren (Bedingungen und Schleifen, Mathematik, Zeichenketten, Typtests, List Comprehensions, weitere Sprachmerkmale), benutzerdefinierte Funktionen und Module, Debugging-Hilfen sowie externe Bibliotheken und Codedateien.
Wo findest du was?
| Frage | Seite im User Manual |
|---|---|
| Welche Form brauche ich? | Primitive Solids, 2D Primitives |
| Wie verschiebe oder drehe ich? | Transformations |
| Wie ziehe ich etwas ab? | CSG Modelling |
| Wie programmiere ich Wiederholungen? | Conditional and Iterator Functions, List Comprehensions |
| Wie baue ich eigene Bausteine? | User-Defined Functions and Modules |
| Wie finde ich Fehler? | Modifier Characters, FAQ |
| Wie exportiere ich? | Export, Using OpenSCAD in a command line environment |
Ein Lesepfad für Einsteiger
- Erste Schritte und Oberfläche; ein eigenes Würfel-und-Kugel-Modell bauen.
- Primitive Solids, Transformationen, CSG Modelling.
- 2D Primitives und Extrusion.
- Variablen, Schleifen, Module (Sprachreferenz).
- FAQ und Modifier Characters zur Fehlersuche.
- Cheat Sheet als tägliches Nachschlagewerk.
- Customizer und Kommandozeile für Weitergabe und Automatisierung.
Hinweis zu Versionen
Die Doku markiert Funktionen, die nur in Entwicklungs-Snapshots vorhanden sind. Das Cheat Sheet führt „2021.01“; das User Manual vermerkt zu manchen Funktionen die Version, ab der sie verfügbar sind (zum Beispiel 2015.03, 2019.05, 2021.01). Prüfe in deiner Installation mit --version oder version(), was du hast.
Lies zuerst die Sprachreferenz-Seite zu dem Befehl, den du brauchst – meist steht dort schon ein Beispiel, das du anpassen kannst.
Zum Selbermachen
- Öffne das Cheat Sheet und markiere alle Befehle, die du in dieser Themenwelt gesehen hast.
- Suche im User Manual einen Befehl, der hier nicht behandelt wurde, und teste ihn.
Verwandte Themen
OpenSCAD → alle Lektionen dieser Themenwelt. Informatik: Grundlagen und Security haben eigene Literaturlektionen.
Prüfstatus: Belegt (Stand 1. Oktober 2026): Die genannten Bereiche der Dokumentationsseite, die Gliederung des User Manuals (Hauptteil und Sprachreferenz mit allen genannten Abschnitten) und die Versionsangaben wurden gegen openscad.org/documentation.html, die Wikibooks-Startseite des User Manuals und das Cheat Sheet 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 Zuordnungstabelle „Frage → Seite“ und der Lesepfad (meine Empfehlung); die Wikibooks-Startseite vermerkt das Manual als „75 % entwickelt“ – die Vollständigkeit ist daher nicht garantiert. Außerdem nicht einzeln belegt: die Erklärungen in eigenen Worten, die Beispiele als solche (konstruiert) und die Wertungen.
Quellen
- OpenSCAD – Dokumentation (openscad.org/documentation.html)
- OpenSCAD User Manual – Startseite (en.wikibooks.org/wiki/OpenSCAD_User_Manual)
- OpenSCAD Tutorial (en.wikibooks.org/wiki/OpenSCAD_Tutorial)
- OpenSCAD Cheat Sheet (openscad.org/cheatsheet)
- OpenSCAD – Bibliotheken (openscad.org/libraries.html)