OCP-Tessellate
Tessellate OCP (Python bindings for OpenCascade) shapes into a JSON-friendly format suitable for three-cad-viewer and downstream tooling such as ocp_vscode.
It accepts geometry from CadQuery, build123d, and raw OCP TopoDS_* shapes, walks the structure, computes triangulations / discretized edges, and emits a hierarchical group of meshed instances.
Installation
pip install ocp-tessellate
Requires Python 3.10+ and OCP 7.8 or 7.9.
Quick start
Programmatic pipeline
For embedding in a tool (the path used by ocp_vscode):
from build123d import Box, Sphere, Compound
from ocp_tessellate.convert import to_ocpgroup, tessellate_group
box = Box(1, 2, 3)
sphere = Sphere(0.5)
sphere.label = "ball"
assembly = Compound(label="root", children=[box, sphere])
# Step 1: convert to an OcpGroup hierarchy + instance list
group, instances = to_ocpgroup(assembly)
# Step 2: tessellate the instances
meshed_instances, shapes, mapping = tessellate_group(group, instances)
# `shapes` is a JSON-serializable tree consumable by three-cad-viewer
Direct export to three-cad-viewer
The simplest path — emit a .js file that a three-cad-viewer page can load directly:
from build123d import Box
from ocp_tessellate.convert import export_three_cad_viewer_js
box = Box(1, 2, 3)
export_three_cad_viewer_js("box", box, filename="box.js")
# writes box.js with `var box = {...}` ready for three-cad-viewer/examples
This is the bridge to three-cad-viewer: bundles tessellated instances + scene tree into a single JSON payload assigned to a JS variable.
Public API
Three entry points in ocp_tessellate.convert:
export_three_cad_viewer_js(var, *objs, names=None, colors=None, alphas=None, modes=None, filename=None, keep_instances=False)— runs the full pipeline (to_ocpgroup→tessellate_group→ JSON encode) and writes avar <name> = {...};JS file. The direct integration point with three-cad-viewer.to_ocpgroup(*objs, names=None, colors=None, alphas=None, modes=None, ...)— converts CAD objects (build123d / CadQuery / OCP / nested dicts and lists) into anOcpGrouphierarchy plus an instance list. Accepts per-objectnames,colors,alphas,materials,modes((state_faces, state_edges)2-tuples), and adefault_color. Renderer-control flags includehelper_scale,render_joints,render_mates,show_parent,show_locals.tessellate_group(group, instances, kwargs=None, progress=None, timeit=False)— meshes the instances and returns the structures consumed by three-cad-viewer.kwargscan carry tessellation parameters likedeviation,angular_tolerance,edge_accuracy, andrender_normals.
For lower-level use, OcpConverter exposes to_ocp(...), which is what to_ocpgroup calls internally.
What gets shown
Inputs are walked recursively. The resulting tree mirrors the input structure:
| input | result |
|---|---|
| build123d / CadQuery / OCP shape | a single OcpObject |
dict |
a Dict group with one named child per key |
list / tuple |
a List group with default-named children |
ShapeList |
a ShapeList group exposing each item individually |
Compound(children=[...]) (assembly) |
a group preserving the assembly hierarchy |
Compound(...) (standard, no children) |
unwrapped to its inner shape |
BuildPart / BuildSketch / BuildLine |
a single OcpObject for the builder result; BuildSketch adds a sketch_local sibling unless disabled |
Compatibility
- Python 3.10+
- OCP 7.8 and 7.9
- build123d (current)
- CadQuery 2.x
License
Apache 2.0. See LICENSE.
Changelog
See CHANGELOG.md.
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 Distribution
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 ocp_tessellate-3.4.1.tar.gz.
File metadata
- Download URL: ocp_tessellate-3.4.1.tar.gz
- Upload date:
- Size: 76.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
63ff387d65b7a8d9a0a54968aba7420bfdb1d36f628b62889a981c5558f11b90
|
|
| MD5 |
fe7353de50e8d9981e904c7f6f8d2641
|
|
| BLAKE2b-256 |
26935497c58730e5103a12a1e1678c95869067bb1bdfa361d878183ef4dfc15b
|
File details
Details for the file ocp_tessellate-3.4.1-py3-none-any.whl.
File metadata
- Download URL: ocp_tessellate-3.4.1-py3-none-any.whl
- Upload date:
- Size: 86.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b61217c2af500e6ce38bb8d142a87a449a6b496a65b223539b3b5c5bb84e8097
|
|
| MD5 |
a9be200e4411916ee2fa40cd8038f287
|
|
| BLAKE2b-256 |
bbd3dfa96118ddcdf22e94893cbef40912c8fad784eb1506d66760eedbe556db
|
