geometry.meshes — Project an imported asset's renderable surface meshes.
geometry.meshes(asset) returns a one-by-N host cell array of mesh structs ready for patch-style rendering or topology inspection.
Syntax
meshes = geometry.meshes(asset)Inputs
asset- Type
Any- Required
- Yes
- Default
- —
- Description
- A host geometry.Asset returned by geometry.load.
Returns
meshes- Type
Any- Description
- One-by-N cell of surface mesh structs.
Errors
RunMat:geometry:inspect:OperationFailed- When
- The geometry inspection operation fails.
- Message
geometry.inspect: operation failed
RunMat:geometry:inspect:Internal- When
- The inspection result cannot be converted to a RunMat value.
- Message
geometry.inspect: internal error
RunMat:geometry:meshes:TooManyOutputs- When
- More than one output is requested.
- Message
geometry.meshes: too many output arguments
Surface topology
Each cell contains mesh_id, an M-by-3 double vertices matrix, N-by-3 one-based double triangles and faces matrices, and a region_mappings cell. Each mapping includes region_id, entity_kind, and one-based start/count ranges. The outer cell is 1-by-number-of-surface-meshes, including a 1-by-0 empty result.
The receiver is a host geometry.Asset. This projection reads its retained topology; it does not reread the source file, invoke CAD import, or run a numeric provider kernel. asset.meshes() uses the same builtin through typed class method registration.
Example
Inspect imported STL topology
asset = geometry.load('part.stl');
meshes = geometry.meshes(asset);
size(meshes)Expected output:
ans = [1 1]Using geometry.meshes with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how geometry.meshes changes the result.
Run a small geometry.meshes example, explain the result, then change one input and compare the output.
FAQ
Are face indices zero-based?⌄
No. Public triangle and face indices, and mapping starts, are one-based doubles.
Related Geometry functions
Triangulation
DelaunayTri · DelaunayTri.freeBoundary · DelaunayTri.nearestNeighbor · DelaunayTri.pointLocation · freeBoundary · nearestNeighbor · pointLocation
Construction
geometry.box · geometry.chamfer · geometry.cylinder · geometry.edges · geometry.edgesIntroducedBy · geometry.extrude · geometry.faces · geometry.facesIntroducedBy · geometry.fillet · geometry.finish · geometry.hole · geometry.instance · geometry.intersect · geometry.pocket · geometry.revolve · geometry.solid · geometry.sphere · geometry.subtract · geometry.transform · geometry.union · geometry.withRegion
Source you can read
Every RunMat function's source is public. Read exactly how geometry.meshes is executed, line by line, in Rust.
- View the source for geometry.meshes in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.