add_sketch_dimension
Adds a driving dimension to the open sketch and optionally sets its value, measuring length, diameter, radius, distance, or angle from selected entities. Rejects conflicting dimensions.
Instructions
Add a driving dimension in the open sketch and optionally set its value. What gets measured follows from the entities: one line = length, circle = diameter, arc = radius, two points / a point and a line / two parallel lines = distance, two non-parallel lines = angle (degrees). The value must be greater than 0. A dimension that over-defines the sketch replaces a size the tools added from the drawing (named DrawnN; the result says which); one that conflicts with the user's own dimensions or relations, or that the sketch cannot satisfy, is rejected and not left in it, naming the conflicting dimensions. Several dimensions in one call: the others in more; if any is rejected, none of the call's stays. Returns the sketch's definition status. A value on a model with more than one configuration needs configurations: without it the call is refused, listing them.
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": {
"entities": "<entities>"
},
"name": "add_sketch_dimension"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| more | No | Further dimensions in this call, e.g. [{'entities': ['origin', '2:start'], 'value': 20, 'orientation': 'horizontal'}]; same unit | |
| unit | No | mm, cm, m, inch or ft | |
| value | No | Value to set (length in unit, or degrees for an angle). Omit to keep the size as drawn. | |
| entities | Yes | Entity references as strings, e.g. ['1'], ['origin', '1:start'], ['2', '3'], or a model edge by a point on it: ['1:center', 'edge:80,40,5'] | |
| orientation | No | For distances between points: measure horizontally, vertically, or aligned (auto) | auto |
| configurations | No | Configuration names to change, or ["all"]. Needed when the model has more than one configuration; with one, leave it out. |