Skip to content

Document parallel-face distance and automatic display planes #1069

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
nicboone8 wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Document parallel-face distance and automatic display planes #1069

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 17 additions & 3 deletions ...zoo-design-studio/features/documentation/gdt-annotations-mbd/distance/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,26 +20,40 @@ and edges. Use it when a model-based definition needs the measured value to rema
Select a starting face or edge and an ending face or edge when the annotation should measure spacing
between two entities. `from` and `to` must be used together.

For two parallel planar faces, Distance measures perpendicular to the faces: the minimum distance
between their infinite supporting planes. Moving either face sideways does not change this value,
even when the face boundaries do not overlap. Other pairs of entities use their centers.
Coincident supporting planes cannot display a distance annotation.

## Edges

Select one or more edges when the annotation should display edge length. Edge selection cannot be
combined with `from` and `to`.

## Tolerance

Set the acceptable distance variation in the current unit system.
Optionally set the acceptable distance variation in the current unit system. Skip this field to
show only the measured distance.

## Precision

Choose how many decimal places to display for the measured distance and tolerance.

## Frame Position

Place the distance label relative to the selected geometry.
The label is centered by default, with its setback scaled to the model size. Set `[along, setback]`
to control its position: `along` moves it along the measurement and `setback` chooses the leader
extent perpendicular to the measurement. A negative setback places it on the opposite side.

## Frame Plane

Choose the display plane for the distance annotation.
Leave **Automatic** selected when measuring two parallel planar faces. Zoo chooses a display plane
that contains their common normal, including for rotated faces. The generated KCL omits `framePlane`
so the orientation is recalculated when the model changes.

An explicit display plane must contain the direction perpendicular to the measured faces. Its
origin does not change the measured distance. If the chosen plane is incompatible, choose Automatic
or another plane. Edge lengths and other entity pairs keep their existing display-plane behavior.

## Leader Scale

Expand Down
Loading