mesh
Queries · api.md § mesh · all operations
definition
mesh(s: Solid, tolerance: Length) -> {positions: list<Point3>, triangles: list<Index[3]>}
Covers the solid's boundary with triangles. No triangle lies farther than tolerance from the boundary. tolerance must be positive.
The mesh is closed. When positions within 10·ε of each other are read as one vertex, every edge between two triangles is used once each way round. The triangles, which are counter-clockwise seen from outside, therefore all face outward. Because positions within 10·ε of each other are read as one vertex, a kernel that meshes each face on its own may repeat the vertices along an edge, once for each face. The volume that the mesh bounds differs from the solid's volume by at most tolerance times the solid's area.
Example. Solid 1 is a 10 × 20 × 30 mm box with one corner at the origin.
> {"cmd": "mesh", "s": 1, "tolerance": 0.5}
< {"ok": {"positions": [[0.0, 0.0, 0.0], [10.0, 0.0, 0.0], [10.0, 20.0, 0.0], [0.0, 20.0, 0.0],
[0.0, 0.0, 30.0], [10.0, 0.0, 30.0], [10.0, 20.0, 30.0], [0.0, 20.0, 30.0]],
"triangles": [[2, 1, 0], [3, 2, 0], [6, 4, 5], [4, 6, 7], [5, 0, 1], [0, 5, 4], … 6 more]}}common to queries
| Function | Fields | Returns |
|---|---|---|
volume | s | Volume |
area | s | Area |
classify | s, points | list<"in" or "on" or "out"> |
closest | s, points | list<Point3> |
normal | s, points | list<Vector3 or null> |
curvature | s, points | list<Number[2] or null> |
check | s | list<string> |
centroid | s | Point3 or null |
inertia | s | Number[3][3] |
distance | a, b | Length |
interference | a, b | {volume: Volume, gap: Length} |
betti | s | Count[3] |
section_area | s, origin, normal | Area |
section | s, origin, normal, tolerance | list<list<Point3>> |
project | s, direction, tolerance | {visible: list<list<Point2>>, hidden: list<list<Point2>>} |
bounding_box | s | Point3[2] |
split | s, origin, normal | Solid[2] |
mesh | s, tolerance | {positions: list<Point3>, triangles: list<Index[3]>} |
display | s, tolerance | {faces: list<Face>, edges: list<list<Point3>>} |
raycast | s, origin, direction; or s, rays | list<Length>; or list<list<Length>> |