Std Measure

Std Measure
Menu location
Tools → Measure
Workbenches
All
Default shortcut
None
Introduced in version
1.0
See also
Draft Dimension

Description

The Std Measure command gives access to the Unified Measurement Facility. It replaces several previous measurement commands, providing a versatile measurement functionality.

All the measurement types

Usage

1. Optionally preselect the entities to be measured.
2. There are several ways to invoke the command:
   • Press the Std Measure button.
   • Select the Tools → Measure option from the menu.
3. The Measurement task panel opens. See Options for more information.
4. If no geometrical entities were preselected, do one of the following:
   • Select the geometrical entities while leaving the Mode as Auto so that the mode will be automatically determined based on the selection.
   • Choose a Mode other than Auto and then select the geometrical entities (clicking on them again will deselect them):
     • Distance - the shortest distance between the selected entities, if circular/arc edges are selected then the distance between the centers of the circles/arcs is measured,
     • Distance Free - distance between two freely selected points (belonging to different entities - edges, faces),
     • Angle - angle between the selected entities,
     • Length - length of the selected edge,
     • Position - coordinates of the selected vertex,
     • Area - area of the selected face,
     • Diameter - introduced in 1.2: diameter of the selected circular/arc edge,
     • Radius - radius of the selected circular/arc edge,
     • Center of Mass - COM of the selected edge, face or solid (only if preselected in the tree).
5. The measurement result will be shown in the Result field and on a label displayed in the 3D View. That label will also include an icon indicating the type of measurement. The labels can be customized in the Preferences. They can be moved in the 3D View by dragging them with a cursor.
6. Press the Reset button to delete the measurement or the Save button to keep it. Saved measurements are put in a Measurements group in the Tree View.
7. Press Esc or the Close button to finish the command.

Options

• introduced in 1.1 Press the button to change the settings:
  • Auto Save - if checked, the last measurement is saved when starting a new measurement (holding Shift can temporarily disable this behavior),
  • Additive Selection - if checked, clicking on subsequent geometrical entities adds them as selections for the same measurement, otherwise Ctrl must be pressed to do this.
• For the Distance and Distance Free modes the Show Delta checkbox is displayed. If this checkbox is checked, the ViewShow Delta property of the measurement is set to true and 3 additional projected measurements are shown in the 3D View.

Properties

Data

Measurement

• DataElement1 (LinkSub): First element of the measurement.
• DataElement2 (LinkSub): Second element of the measurement.
• DataDistance (Distance): Distance between the two elements.
• DataDistance X (Distance): Distance in the X direction (only for Distance and Distance Free measurements).
• DataDistance Y (Distance): Distance in the Y direction (idem).
• DataDistance Z (Distance): Distance in the Z direction (idem).
• Data (Hidden)Position1 (Vector): Position of the first measured point (read-only).
• Data (Hidden)Position2 (Vector): Position of the second measured point (read-only).

View

Appearance

• ViewFont Size (Integer): Defines the font size for the label of the saved dimension.
• ViewLine Color (Color): Defines the color of the dimension lines displayed in 3D View.
• ViewShow Delta (Bool): If true, projected distance measurements are displayed in 3D View (only for Distance and Distance Free measurements).
• ViewText Background Color (Color): Defines the background color of the dimension label.
• ViewText Color (Color): Defines the color of the dimension label text and symbol.

Notes

• This command is the result of a GSoC 2023 project.
• As elsewhere in FreeCAD you must hold down Ctrl to select multiple objects.