openscad_cpp_evaluator
A C++20 port of openscad_evaluator (Python): an AST-walking
geometry engine that takes a parsed OpenSCAD AST and produces Manifold
CSG geometry, ready to export to STL/OBJ/OFF/3MF or hand off to a renderer.
Built on:
openscad_cpp_parser(git submodule) for lexing/parsing/AST/scope resolution.- Manifold v3.5.2 for the actual CSG boolean/mesh engine.
- Boost.Polygon for
roof()'s Voronoi-diagram construction. nothings/stb(header-only) forsurface()'s image loader and the built-in font provider's TrueType parsing/rasterization.
All fetched automatically via CMake FetchContent — no manual dependency installation beyond the
toolchain below.
Status
All planned phases (0–9) are complete: the full primitive/transform/boolean/modifier/control-flow
language surface, every builtin function, STL/OBJ/OFF/3MF import and export, hull()/minkowski()/
linear_extrude()/rotate_extrude()/roof()/offset()/surface()/DXF & SVG import/text(), an
opt-in content-hash geometry cache, per-call-site profiling, and a gdb-style --debug REPL. See
CLAUDE.md for the full phase-by-phase history and architecture notes.
Build
Requires:
- CMake ≥ 3.24
- A C++20 compiler (Clang, GCC, or MSVC — all three are covered by CI)
- Bison ≥ 3.8 and Flex
- macOS:
brew install bison flex(the system bison is too old; CMake auto-detects Homebrew's) - Linux:
sudo apt-get install bison flex - Windows: MSYS2's
bison/flex(pacman -S bison flex) — GitHub'swindows-latestrunner ships MSYS2 pre-installed atC:\msys64; CMake auto-detects it there too
- macOS:
GoogleTest and every other C++ dependency are fetched automatically.
git clone --recurse-submodules <this-repo>
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
(Omitting -DCMAKE_BUILD_TYPE=Release builds unoptimized — pass it explicitly for anything
performance-sensitive.)
On Windows, CMake defaults to the multi-config Visual Studio generator, which ignores
CMAKE_BUILD_TYPE; pass --config Release to cmake --build (and -C Release to ctest)
instead.
Test
ctest --test-dir build --output-on-failure
Run a single binary or filter:
build/tests/oscad_eval_tests
build/tests/oscad_eval_tests --gtest_filter='FormatNumber.*'
The suite runs twice in CI — once with the bytecode VM on (the default) and once with it off
(OSCAD_BYTECODE_VM=0) — so a regression in either the compiled or interpreted expression-eval
path is caught.
CLI
build/tools/cli/openscad-cpp-evaluator <input.scad> -o <output.{stl,obj,off,3mf}> [--format stl|obj|off|3mf] [--debug]
The output format is inferred from -o's extension, or set explicitly with --format.
--debug drops into a gdb-style REPL (break/run/continue/step/next/finish/print/
backtrace/set/list/quit/help) before and during evaluation.
build/tools/cli/openscad-cpp-evaluator model.scad -o model.stl
Architecture
See CLAUDE.md for the full per-file architecture map, the Python-reference cross-check history,
and the rationale behind every non-obvious design choice (the two-pass resolve/generate CSG
pipeline, the FontProvider injection seam, the closure-detection rule, etc.).
CI
GitHub Actions builds and tests on Linux, macOS, and Windows on every push/PR (.github/workflows/ci.yml).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openscad_cpp_evaluator-0.21.0.tar.gz.
File metadata
- Download URL: openscad_cpp_evaluator-0.21.0.tar.gz
- Upload date:
- Size: 763.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
52362dfe656624b47a394e2f6aa30ef1f7fc590965d582cebcadaf3a77e2bec3
|
|
| MD5 |
3a4cd4361e933c47f9437846f646c52c
|
|
| BLAKE2b-256 |
650b5140e921e71d52ce291ad4b2bf738bddeae1837d6d8885991b5abaaeb07f
|
File details
Details for the file openscad_cpp_evaluator-0.21.0-cp312-abi3-win_amd64.whl.
File metadata
- Download URL: openscad_cpp_evaluator-0.21.0-cp312-abi3-win_amd64.whl
- Upload date:
- Size: 5.1 MB
- Tags: CPython 3.12+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4fd67cc29da086de2ee628ca7dae2bafd8de0cd3d1b3992222b0478e359fcfb9
|
|
| MD5 |
f9036a3480247efc7103a2f603540b8d
|
|
| BLAKE2b-256 |
76b4df97b4702634990265a6362de6852a5ba0631c76c3a401052790b9b9a2ce
|
File details
Details for the file openscad_cpp_evaluator-0.21.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: openscad_cpp_evaluator-0.21.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 3.3 MB
- Tags: CPython 3.12+, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c66d9d023be031c09815f06a791340d616b9b50281fe574b1ff22514a7c831a0
|
|
| MD5 |
75503e43df04e40b6c835d9eb892cce4
|
|
| BLAKE2b-256 |
5e251f65d68a62cd49de01ee50c047afc1dea6f6eb5882f333599629a1b595c6
|
File details
Details for the file openscad_cpp_evaluator-0.21.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.
File metadata
- Download URL: openscad_cpp_evaluator-0.21.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
- Upload date:
- Size: 3.0 MB
- Tags: CPython 3.12+, manylinux: glibc 2.27+ ARM64, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4cc552129e2d48d3b234a4a6e35c32ebbd3e82b25b3bb8fc7bc8f800d8cd9b68
|
|
| MD5 |
152d2b1c0d276be2c35b8a1bde501e1c
|
|
| BLAKE2b-256 |
3a767e2329ec36feecd89117ece8a4dba63c62758cee7ea7b705995e10e82e1f
|
File details
Details for the file openscad_cpp_evaluator-0.21.0-cp312-abi3-macosx_13_0_x86_64.whl.
File metadata
- Download URL: openscad_cpp_evaluator-0.21.0-cp312-abi3-macosx_13_0_x86_64.whl
- Upload date:
- Size: 2.3 MB
- Tags: CPython 3.12+, macOS 13.0+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
095fe8ea188ce1e6f93f8a43d6eedb61ee0fdbf6a563decd115ec77893c2d61a
|
|
| MD5 |
14f9e9431fad950b592592f6d9f26867
|
|
| BLAKE2b-256 |
72243a2ecee52dc2b1e3e4f06ccb4cb97b3384c6332a42810f86a9e874144c73
|
File details
Details for the file openscad_cpp_evaluator-0.21.0-cp312-abi3-macosx_13_0_arm64.whl.
File metadata
- Download URL: openscad_cpp_evaluator-0.21.0-cp312-abi3-macosx_13_0_arm64.whl
- Upload date:
- Size: 2.1 MB
- Tags: CPython 3.12+, macOS 13.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb1b4cfccb1f18d8b3cdc4ecf302b426c66b3a1f1196a48cfdc4abfe5d6945c8
|
|
| MD5 |
efabc627c6b514779fc693ff0abb74dd
|
|
| BLAKE2b-256 |
8dded52b633617912c0ba565094151971bc925fae09c3e9309c33d7107d7fd9f
|
