Skip to content
ShapeAnywhere Wiki
Parametric editing

Parametric editing: change dimensions deliberately

Complete guide to dimension actions, holes, fixed references and saved replay.

Updated:

Two kinds of parameters

The Parametric Builder keeps selected edit dimensions on an existing body. A dimension action describes what changes relative to a fixed reference when a new target value is applied. This differs from freely scaling the whole model. An MCP program can additionally use numeric variables for a newly constructed design. Program parameters are inputs to the executed job; they do not automatically become editable Builder dimension actions afterward. The complete reference below includes the previous Parametric Builder guide, examples and limits.

Simple dependent features on the base solid

For a simple box or cylinder with a hole, pocket or additive boss, the Parametric Builder conservatively records its placement relationship: through-cuts extend with the carrier height, blind pockets keep their depth, and bosses follow the upper or lower supporting face. Side bosses follow the matching side face when width or depth changes. Moving the carrier also moves recognized local features in X/Y/Z. The panel displays how many relationships were found. Example: increase the height of a drilled plate from 20 to 30 mm; the hole remains open and the boss stays on top. Limits: Only simple native features with unambiguous geometry are recognized. Explicit downstream dimensions take precedence. Freeform and imported BReps, complex chamfers and threads, unrelated sketches and independent pattern copies are not assigned invented dependencies. This is not an equation or complete 3D constraint system; always verify the actual result.

Edits added later and linked sketches

When an edge fillet or chamfer is added after creating a parameter row, a successfully validated native edit is included in the replay baseline. Newly added simple holes and bosses can extend recognized dependencies. Changes to a linked rectangular or circular sketch extrusion propagate unambiguous local downstream features; through-holes also follow extrusion height. Ambiguous changes are rejected rather than silently discarding an operation. Freeform sketches, imports, and complex profiles still require separate verification.

Set existing rows through AI

MCP reads existing row IDs and sets unfrozen rows to absolute values. Register new feature dimension rows in CAD or with cad_add_parameter. Program variables alone do not create persisted dependencies. Analytic round and ring profiles now expose real outer-diameter, inner-diameter and height rows. In the CAD parameter panel Add round-part dimensions registers these directly. For successive MCP registrations, always reuse the most recently returned historyToken. See Rows and sketch links.

Complete reference

Parametric Builder help

Edit models using named dimensions

Add dimensions such as “Leg A” or “Mounting holes” to a CAD body. A stored value can move a selection along a world axis or change recognized holes. Several changed dimensions are applied together.

This help opens in its own tab. Switch back to the existing app tab to continue; your selection and builder inputs remain there.

Your first dimension in six steps

  1. Select a CAD body. Open “Parametric” next to “Mesh → CAD” in the top bar and click + in the window. Drag its title bar to move it out of the way.
  2. Enter a name, such as “Leg A”, and select “Selection distance”. The name helps you identify the right dimension later.
  3. Select the leg’s end face or suitable edges/points on the model. Shift extends the selection. Then click “Use selection as target”.
  4. Choose measurement axis X, Y or Z. Enter the fixed reference point coordinates. Alternatively, now select another point or face and click “Use current selection as reference”. The previously captured targets remain stored.
  5. If additional recognized holes should move with the target, select them under “Move additional holes with target”. Holes in a recognized leg end already follow automatically. Click “Create parameter”: the list initially shows the current dimension.
  6. Change the value in the list, for example from 55 to 60 mm. Click “Apply dimensions together”. The body is checked and applied if the build succeeds.

Capture targets first, then select the reference to define both selections separately. Switching bodies starts a new input draft; existing parameters remain with their respective bodies.

Dimension action types

ActionWhat the dimension changes
Selection distanceMoves the captured faces, edges or points along the chosen world axis. Their center is measured from the fixed reference. An end face can extend a leg this way; the whole body is not scaled.
Feature dimensionChoose a saved feature or edge operation and one of its offered dimensions. No face selection is required. Examples: base extrusion width, hollow thickness or chamfer amount. Saved rows and sketch links persist through saving and loading.
Hole diameterChanges the diameter of one or more recognized analytic holes. Holes selected for a shared control must have the same diameter when creating it. Depth and existing entry chamfers are retained.
Hole distanceMoves the selected holes as a group along a world axis. The dimension is the distance from the group center to the fixed reference. Distances between the holes are retained.
Hole follows cornerBinds selected holes to exactly one editable corner point. Moving the corner retains the full X/Y/Z offset to the hole, including later dimension changes.
60 mm55 mmReference: Z = 0Z
Schematic example: the selected end face is at Z = 55 mm and the fixed reference at Z = 0. A target dimension of 60 mm moves it by 5 mm along +Z. The cyan area shows the extension.

Example: mounting holes

Select “Hole diameter”, choose two recognized 3.5 mm holes and create “Mounting holes”. A new value of 4 mm changes both diameters together. Another analytic circular cut for a counterbore of a different diameter needs its own control. Changing wall thickness does not automatically increase hole depth.

Example: moving a hole group

Two hole centers are at X = 25 and X = 35 mm. With reference X = 0, their group dimension is 30 mm. A new value of 40 mm moves both by 10 mm to X = 35 and X = 45. Their separation remains 10 mm. “Hole distance” here is therefore not a control for the distance between two holes.

Measurement axis and fixed reference

X, Y and Z are workspace axes. They do not depend on your viewing direction. Check the viewport axis indicator; “right on the screen” does not necessarily mean +X.

The reference is a fixed point with X/Y/Z coordinates in millimeters. An X dimension compares only its X coordinate; Y and Z work accordingly. “Use current selection as reference” uses the center of that selection.

Multiple targets are also measured using a shared center. All targets move by the same displacement; the control does not define a separate distance for each point. For an end face with an adjacent chamfer band, the dimension remains anchored to the selected face.

The reference does not follow subsequent model changes. The original side of the reference is retained: a target at X = −55 mm moves to X = −60 mm when its dimension is 60 mm. Use non-negative dimensions; entered coordinates may be negative.

Hole follows corner

Click + in the builder, enter a name and choose “Hole follows corner”. Check the desired holes in the list. Select only the desired corner point in the viewport, click “Capture selected corner point” and create the entry. The hole then follows Direct Edit of that corner. Grab a hole wall or one of its circular rims to move the hole itself; Shift allows multiple selection. This stores a new fixed offset from the corner.

Select and capture exactly one editable corner point. The chosen holes keep their X, Y and Z offsets from this corner. Moving the hole directly sets a new offset. Measured loft points without a stable vertex index are not yet supported.

Change and apply together

You can change several values in the list and calculate them together with “Apply dimensions together”. Typing alone does not change geometry. Dimensions are in millimeters; both commas and periods work as decimal separators.

The combined draft is checked during calculation. On failure, the last valid model and last applied parameter values are retained. The change must still produce exactly one valid, non-empty CAD body.

Values are absolute target dimensions. Repeated changes start from the same saved base: 55 → 60 → 58 mm produces 58 mm, rather than three accumulated displacements. Dimensions must not contradict each other in the combined result.

Save and remove controls

Parameters and their base are saved with the project and available again when loading it. Applied changes can be reverted using Undo. Closing the builder window does not change the model.

Remove parameter · keep shape
The × beside a list entry removes its visible control and retains the current shape. A dimension remains as a fixed step so that later entries retain their basis. For “Hole follows corner”, it releases the following relation instead.
Detach dimension rows
Removes the body’s entire parameter binding and retains its current shape. New parameters use this shape as their new base. Use this to recreate references after edits outside the builder. You can undo the action.

If something does not work

The selection cannot be captured as a target

Select editable profile/model targets on the selected CAD body. A plain imported mesh needs CAD reconstruction first. For imported CAD bodies without profile targets, this version supports only suitable planar, equally oriented faces perpendicular to the chosen world axis. Missing or mixed selections are not applied partially.

No holes are listed

Hole controls need recognized analytic circular cut features. A visible round opening in a mesh or only in an imported CAD body is not yet such a feature. Freeform/loft cuts are also not treated as analytic holes. Select a body with suitable hole features.

The body was changed outside the builder

Supported profile moves in Direct Edit update the parameter base and its dimensions. Other edits or missing profile references can still invalidate it. The builder stops rather than overwriting the new shape. Check the current model, remove all bindings and recreate the desired dimensions.

Dimensions conflict with each other

Two controls can set the same targets to different final dimensions. Check which selections overlap and adjust the values. A removed control can still act as a fixed step; use “Remove all bindings” to completely restart the references.

The rebuild fails

The chosen change may intersect faces, remove material or no longer fit chamfers and adjacent surfaces. Try a smaller dimension or different targets. Diameters must be at least 0.001 mm; distances can start at 0. The last valid model is retained.

What this version supports

  • Named selection distances, hole dimensions and supported saved feature dimensions, revolve angles and fillet/chamfer amounts. Angles use degrees; other dimensions use millimeters. Free-form formulas and equations between rows are not included.
  • Existing profile/loft/Direct Edit targets can be used for selection distances. For imported CAD bodies without those targets, one shared planar face distance is currently available; multiple suitable faces can be included in the same entry.
  • Hole controls use recognized analytic circular cuts. The builder does not automatically recognize every feature in an imported body.
  • There is no general 3D constraint solver yet. The builder connects named dimensions to specific existing editing targets; it does not replace sketch constraints or a full construction with feature dependencies.
Switch back to your existing app tab to try these steps on the model. You can keep the help page open or close it independently.