step_mate
Moves an assembly through a list of distance or angle mate values, saves pictures, and counts interferences at each step, returning unfinished values for continuation.
Instructions
Step a distance or angle mate through a list of values, optionally saving a picture (named .png; an existing file is never replaced: the next free name, ' (2).png', is used and reported) and counting interferences at each step: this is how a mechanism is moved and shown. For each value the mate is set, the assembly rebuilt and the mate errors read. The call stops by itself before max_seconds runs out and returns the values still to do, to pass on as first_index; it also stops at the first value the mates do not allow. A PUSHED chain folds if the driven point moves more than one link pitch along its track in one move: set max_change (about half the pitch) and the way between values is walked in smaller moves.
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": {
"name": "<name>",
"values": "<values>"
},
"name": "step_mate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| up | No | With direction: the model direction that points up in the picture | |
| name | Yes | Mate name from list_mates, e.g. 'Distance1' | |
| unit | No | Unit of the values for a distance mate (mm, cm, m, inch or ft) | |
| view | No | View for the pictures | current |
| width | No | Picture width in pixels (64-4096) | |
| height | No | Picture height in pixels (64-4096) | |
| prefix | No | File name prefix (default: the mate name) | |
| values | Yes | Values to step through, in order (distance in unit, or degrees) | |
| direction | No | Instead of view: where the camera is, seen from the model | |
| max_change | No | Never change the mate by more than this at once: the way between two values is walked in smaller equal moves, without pictures. Use about half the link pitch for a chain that is pushed. | |
| first_index | No | Number of the first picture; use it to continue a series | |
| max_seconds | No | Stop before the call has run this long (5-50) | |
| zoom_to_fit | No | Zoom to fit once before the first picture (all pictures then have the same scale) | |
| return_image | No | Send the last picture back, or none | last |
| output_folder | No | Folder on the computer for the pictures. Without it no pictures are saved. | |
| hide_annotations | No | Hide dimensions, planes, axes, origins and sketches in the pictures | |
| white_background | No | Plain white background | |
| check_interference | No | Count interferences at every step |