Query Faces
query_facesFilters 3D model faces by type, normal direction, radius, or area, returning matching face descriptors for downstream selection or measurement.
Instructions
Filter faces by a structured predicate. Returns matching descriptors.
Predicate fields (all optional, ANDed):
kind / type: 'planar' | 'cylindrical' | 'conical' | 'spherical' | 'toroidal' | 'spline'
normal_dir: [x, y, z] unit vector for planar faces (with normal_tol)
radius_eq: float, matches cylindrical/conical/spherical (with radius_tol)
area_min / area_max: bounds in mm^2 Optional ordering:
centroid_max / centroid_min: 'x' | 'y' | 'z' (sorts result)
order: 'area_desc' | 'area_asc'
Example: {"type": "planar", "normal_dir": [0, 0, 1], "centroid_max": "z"} finds the topmost +Z-facing face.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"handle": "<handle>",
"predicate": "<predicate>"
},
"name": "query_faces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes | ||
| predicate | Yes | ||
| workspace | No | Run this call in this named workspace |