cad_measure
Read-onlyIdempotent
Get distance between two points or calculate area/volume of a CAD object. Use for quick measurement queries in 2D/3D models.
Instructions
Measure a distance or an object's area/volume.
聚合测量操作。按 ``action`` 派发：distance / area。
- ``distance``: Euclidean distance between ``point_a`` and ``point_b``
(2D ``[x, y]`` or 3D ``[x, y, z]``), returns ``distance``.
- ``area``: measure an existing object by ``object_id`` — 2D kinds
(circle / rectangle / polygon) return area (``mm^2``), 3D kinds
(box / cylinder / sphere / cone) return volume (``mm^3``); ``kind``
in the output reports which.
When not to use: ``cad_measure`` reads existing geometry. To query
object position / bounding box use ``cad_object`` (action=read) or
``cad_status`` (target=object); to validate mesh validity use
``cad_validate`` (action=geometry).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| measure | Yes | Measurement to perform, discriminated by `action`: distance or area. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Measurement kind: area / volume | |
| unit | No | mm^2 for area, mm^3 for volume | |
| value | No | Measured value | |
| action | Yes | Measurement action executed | |
| status | Yes | Operation status | |
| message | No | Status description | |
| distance | No | Distance between the two points |