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
Release files for openscad-cpp-evaluator 1.20.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| openscad_cpp_evaluator-1.20.0.tar.gz | 1.6 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| openscad_cpp_evaluator-1.20.0-cp312-abi3-win_arm64.whl | CPython 3.12 | abi3 | Windows ARM64 | Details |
| openscad_cpp_evaluator-1.20.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| openscad_cpp_evaluator-1.20.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| openscad_cpp_evaluator-1.20.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.27+ ARM64, Linux glibc 2.28+ ARM64 | Details |
| openscad_cpp_evaluator-1.20.0-cp312-abi3-macosx_13_0_x86_64.whl | CPython 3.12 | abi3 | macOS 13.0+ x86-64 | Details |
| openscad_cpp_evaluator-1.20.0-cp312-abi3-macosx_13_0_arm64.whl | CPython 3.12 | abi3 | macOS 13.0+ ARM64 | Details |
Total release size: 48.0 MB
Release files / openscad_cpp_evaluator-1.20.0.tar.gz
| Download URL | openscad_cpp_evaluator-1.20.0.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ed8ceaed34844324e9cbec1e2fd19778d3384ccc0c7fa214f4b3197b5a1ce253
|
|
BLAKE2b-256 checksum How to use checksums |
861414f7e9b96eba770e1887e6b659e7856f90f0e1555e0eed2949f1180d742c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / openscad_cpp_evaluator-1.20.0-cp312-abi3-win_arm64.whl
| Download URL | openscad_cpp_evaluator-1.20.0-cp312-abi3-win_arm64.whl |
|---|---|
| Size | 10.3 MB |
| Tags | CPython 3.12 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
e0a00b5bcff4ab85a452484344a46ef0dfc12f621b45dc069b876e897b76adac
|
|
BLAKE2b-256 checksum How to use checksums |
a2551fd3c86bfc833d99328d0d384e6e864bf1c8d29f75d3be79299b99312174
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / openscad_cpp_evaluator-1.20.0-cp312-abi3-win_amd64.whl
| Download URL | openscad_cpp_evaluator-1.20.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 10.7 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
6b4deafc4be3f9b074c615296a0a4bb2b3c80baeb8979adb1f94227706c15f5e
|
|
BLAKE2b-256 checksum How to use checksums |
de32dce753b98aef1d30f0eeca735b0fe2178c184aabc2d05169b48ed445b246
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / openscad_cpp_evaluator-1.20.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | openscad_cpp_evaluator-1.20.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.2 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
8decee696b80f89cc290fd202c922b7c6105b5f5ac1c1906a41d601c3f962e0a
|
|
BLAKE2b-256 checksum How to use checksums |
c38594ca9d6e932fdc3af2cd6c3c717bc8179e1f70f5897e72ccc75accdd8e7a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / openscad_cpp_evaluator-1.20.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
| Download URL | openscad_cpp_evaluator-1.20.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 6.8 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
e4791b5f7392586c4c62545f5d640b24f91d0a85a2cd23811f61b1fd1ff8966f
|
|
BLAKE2b-256 checksum How to use checksums |
2f9c7e7d18a152b732c5e57babc666b0723da3d263213c2f3735c5dce68eedf0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / openscad_cpp_evaluator-1.20.0-cp312-abi3-macosx_13_0_x86_64.whl
| Download URL | openscad_cpp_evaluator-1.20.0-cp312-abi3-macosx_13_0_x86_64.whl |
|---|---|
| Size | 5.8 MB |
| Tags | CPython 3.12 abi3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
5a9b6fbe8d96964152fba9d89a6c28a6d13a91285b5200405fadd583ba4ea701
|
|
BLAKE2b-256 checksum How to use checksums |
001200e21caff8b7c7a5bbabaf43475954c244398f47ce4a294e6ef072b90326
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / openscad_cpp_evaluator-1.20.0-cp312-abi3-macosx_13_0_arm64.whl
| Download URL | openscad_cpp_evaluator-1.20.0-cp312-abi3-macosx_13_0_arm64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | CPython 3.12 abi3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
51af1c9e56a494c37ca99a47a1743d50898b42b3b8e70dcbc5ca6ebaf225ed62
|
|
BLAKE2b-256 checksum How to use checksums |
f315346d7c611e52aca3c8d0bb2ccbe09a911824b2e1a58438721ec82afb0484
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
