Measure Entity
analysis_measure_entityMeasure entity area and geometry from a drawing handle, capturing polyline bulges and reporting exactness, closure assumptions, and self-intersections for reliable results.
Instructions
Measure something already in the drawing, by handle.
Reads the real geometry, so polyline bulges (arc edges) are included — reading vertices back and shoelacing them yourself loses 28% of the area on a semicircular edge, silently.
Measurable: LWPOLYLINE, 2D POLYLINE, CIRCLE, ELLIPSE, SPLINE, HATCH, SOLID,
TRACE, 3DFACE. REGION and 3DSOLID need the live COM backend (their area is
in ACIS data ezdxf cannot evaluate) and refuse with
capability: "measure_area_acis". LINE/TEXT/INSERT bound no area on any
engine and are a plain error, not a capability gap.
The payload states its own accuracy: exact is false when the shape had to
be flattened (then flatten_tolerance says how finely), assumed_closed is
true when an open boundary was closed the way AutoCAD's AREA does, and
self_intersecting warns when the shoelace cancelled crossed lobes — a
bowtie measures 0.0 and that number is worse than useless unflagged.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes | Entity handle (hex string) from create/list/select | |
| flatten_tolerance | No | Max chord deviation when geometry has no closed form (splines, partial ellipses) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||