OpenSCAD User Manual

Introduction
editOpenSCAD is an opensource application for modelling and animating Solid CAD objects in three dimensions.
It is offered as free software and is available for several platforms.
OpenSCAD provides a functional descriptive language that may be used to numerically describe a 3D object using primitive shapes assembled and combined using 3D boolean operations. It is well suited to Computer-aided design tasks that will lead to production using CNC machining or 3D Printing processes.
OpenSCAD is not an interactive modelling tool in the way that Blender or AutoCAD's apps are. Rather it uses a compiler to generate a run-time process to draw the 3D shapes specified by the instructions in an OpenSCAD file. Its user interface does offer a feature rich editing panel for the .scad programs currently loaded, an on-screen preview, a rendering engine to produce images, and a limited animation function.
OpenSCAD renders in two modes, Preview and Render.
Preview uses OpenCSG and OpenGL to perform fast, frame buffer based rendering for the on-screen preview. This is a clever way of painting pixels without the effort of generating the mesh that a more rigorous rendering engine would want. There are some known issues with artifacts in preview rendering but they can be bypassed by doing a "full render" of the model.
The CGAL geometry engine is used to generate an accurate, polygonal mesh from the model that is then rendered into an image and displayed.
More recently development versions have replaced CGAL with Manifold for rendering.
OpenSCAD is available via the common distribution methods as listed on the downloads page.
Participation
editInformation about OpenSCAD development is available on GitHub.
The ways to participate in the community include the mailing list, and chatting on IRC.
Suggestions for features, feedback and bug reports may be written using GitHub Issues, but please read the preferred Way of Work before submitting.
Operations Manual
editThese pages were originally created as part of the OpenSCAD User Manual, now in the process of being restructured.
The OpenSCAD Language Reference
edit- The OpenSCAD Language
- General - READ THIS FIRST
- values and data types
- variables
- vectors
- vector initialization
- 3D Object Modules -
- 2D Object Modules
- 2D Primitives - square, circle, polygon
- Text draw text objects using fonts.
- 2D to 3D - extrusions
- Importing 2D Geometry
- Transforms and Modification Operator Modules
- Boolean Combinations
- Flow of Control Statements
- Expressions
- Other Language Features - Special '$' variables, echo, render, surface, search , version(), version_num(), parent_module(n) and $parent_modules, assert
- User-Defined Functions and Modules - Functions, Modules, Children
- Debugging aids - % # ! * echo
- External libraries and code files
- include - SCAD, CSG
- use - SCAD
- import - STL, OFF, DXF
- import_dxf - Deprecated
- import_stl - Deprecated
- export - STL, OFF, AMF, 3MF, DXF, SVG, PNG, CSG
- surface - PNG
Work in progress
editThis section is about experimental features in the development snapshots of OpenSCAD.
The status of particular fixes and features may be seen in the GitHub project. Look for :
Libraries
editExamples
editBuild Manual
editNotes on Building OpenSCAD from Sources
Choose your Platform:
Additional Resources
edit- Command Glossary - Very short name and syntax reference
- Frequently Asked Questions
- Tips and Tricks
A clear guided introduction to using OpenSCAD and to the OpenSCAD language is available in the OpenSCAD Tutorial.
For Teachers: a basic 25-slide presentation from 2014 is available under GNUFDL to walk your students through the process of using OpenSCAD here.
Fablab Lannion (France) edited a nice French-language interactive tutorial that you might appreciate.
A "cheat sheet" is a useful quick reference for the OpenSCAD language, with each item linking back to this Wikibook.
A list of books can be found here.
History
editPeriodically the two manuals below get cleaned up or have major transitions. Consider archiving the manuals prior to starting a major update.
This can be done for the two 'printable version' links below to the Internet Archive
- 2018-04-25 The OpenSCAD User Manual - Print Version & The OpenSCAD Language - Print Version
- 2019-07-22 The OpenSCAD User Manual Which includes links to the archives of the above two printed versions (as of this date).
The Wayback Machine no longer has a free user requested site archive, so below is just the two 'printable version' manuals