Std MeasureDistance: Difference between revisions

From FreeCAD Documentation
No edit summary
mNo edit summary
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>


<!--T:8-->
{{Docnav
{{Docnav
|[[Std_ProjectUtil|Std ProjectUtil]]
|[[Std_ProjectUtil|ProjectUtil]]
|[[Std_TextDocument|Std TextDocument]]
|[[Std_TextDocument|TextDocument]]
|[[Std_Tools_Menu|Std Tools Menu]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=
|IconL=Std_ProjectUtil.svg
|IconR=Std_TextDocument.svg
|IconR=Std_TextDocument.svg
|IconC=Freecad.svg
|IconC=Freecad.svg
Line 19: Line 17:
|MenuLocation=Tools → Measure distance
|MenuLocation=Tools → Measure distance
|Workbenches=All
|Workbenches=All
|SeeAlso=[[Std_Measure_Menu|Std Measure Tools]], [[Draft_Dimension|Draft Dimension]], [[Arch_Survey|Arch Survey]]
|SeeAlso=[[Part_Measure_Linear|Part Measure Linear]], [[Draft_Dimension|Draft Dimension]]
}}
}}


==Description== <!--T:2-->
==Description== <!--T:2-->


<!--T:9-->
The '''Std MeasureDistance''' command creates a distance object that measures and displays the distance between two points.
The '''Std MeasureDistance''' command creates a distance object that measures and displays the distance between two points.


==Usage== <!--T:4-->
==Usage== <!--T:4-->


<!--T:10-->
# There are several ways to invoke the command:
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Std_MeasureDistance.svg|16px]] [[Std_MeasureDistance|Std MeasureDistance]]}} button.
#* Press the {{Button|[[Image:Std_MeasureDistance.svg|16px]] [[Std_MeasureDistance|Std MeasureDistance]]}} button.
#* Select the {{MenuCommand|Tools → [[Image:Std_MeasureDistance.svg|16px]] Measure distance}} option from the menu.
#* Select the {{MenuCommand|Tools → [[Image:Std_MeasureDistance.svg|16px]] Measure distance}} option from the menu.
# Select the first dimension point on an object in the active [[3D_view|3D view]].
# Select the first dimension point anywhere on an object in the [[3D_view|3D view]].
# Select the second dimension point on an object in the same 3D view.
# Select the second dimension point anywhere on an object in the 3D view.
# The selection order of the points can have an impact on the position of the dimension line.
# The selection order of the points can have an impact on the position of the dimension line.
# Optionally flip the position of the dimension line by changing the {{PropertyView|Mirror}} property of the distance object.
# Optionally flip the position of the dimension line by changing the {{PropertyView|Mirror}} property of the distance object.
Line 38: Line 38:
==Notes== <!--T:6-->
==Notes== <!--T:6-->


<!--T:11-->
* You cannot use the [[Draft_Workbench|Draft]] snap tools with this command.
* You cannot use the [[Draft_Workbench|Draft]] snap tools with this command.
* To add dimensions to drawings use the dimension tools from the [[TechDraw_Module|TechDraw Workbench]].
* To add dimensions to drawings use the dimension tools from the [[TechDraw_Workbench|TechDraw Workbench]].
* For more comprehensive measuring tools, install the [[Image:Manipulator_workbench_icon.svg|24px|link=Manipulator_Workbench]] [[Manipulator_Workbench|Manipulator Workbench]] (an [[External_workbenches|external workbench]]).


==Properties==
==Properties== <!--T:12-->


===Data=== <!--T:13-->

<!--T:14-->
{{TitleProperty|Base}}

<!--T:15-->
* {{PropertyData|Label}}: by default the label contains the measured distance, but this distance is not updated when P1 or P2 are later changed.
* {{PropertyData|Label}}: by default the label contains the measured distance, but this distance is not updated when P1 or P2 are later changed.

<!--T:16-->
{{TitleProperty|Measurement}}

<!--T:17-->
* {{PropertyData|P1}}: the first dimension point.
* {{PropertyData|P1}}: the first dimension point.
* {{PropertyData|P2}}: the second dimension point.
* {{PropertyData|P2}}: the second dimension point.
* {{PropertyData|Distance}}: (read-only) the measured distance between P1 and P2.
* {{PropertyData|Distance}}: (read-only) the measured distance between P1 and P2.

===View=== <!--T:18-->

<!--T:19-->
{{TitleProperty|Base}}

<!--T:20-->
* {{PropertyView|Dist Factor}}: this factor, multiplied by the measured distance, determines the dimension line offset.
* {{PropertyView|Dist Factor}}: this factor, multiplied by the measured distance, determines the dimension line offset.
* {{PropertyView|Font Size}}: the height of the letters.
* {{PropertyView|Font Size}}: the height of the letters (line height in pixels).
* {{PropertyView|Mirror}}: if set to {{TRUE}} the position of the dimension line relative to P1 and P2 is flipped.
* {{PropertyView|Mirror}}: if set to {{TRUE}} the position of the dimension line relative to P1 and P2 is flipped.
* {{PropertyView|On Top When Selected}}: has no effect.



<!--T:21-->
{{Docnav
{{Docnav
|[[Std_ProjectUtil|Std ProjectUtil]]
|[[Std_ProjectUtil|ProjectUtil]]
|[[Std_TextDocument|Std TextDocument]]
|[[Std_TextDocument|TextDocument]]
|[[Std_Tools_Menu|Std Tools Menu]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=
|IconL=Std_ProjectUtil.svg
|IconR=Std_TextDocument.svg
|IconR=Std_TextDocument.svg
|IconC=Freecad.svg
|IconC=Freecad.svg

Latest revision as of 17:16, 14 September 2022

Std MeasureDistance

Menu location
Tools → Measure distance
Workbenches
All
Default shortcut
None
Introduced in version
-
See also
Part Measure Linear, Draft Dimension

Description

The Std MeasureDistance command creates a distance object that measures and displays the distance between two points.

Usage

  1. There are several ways to invoke the command:
    • Press the Std MeasureDistance button.
    • Select the Tools → Measure distance option from the menu.
  2. Select the first dimension point anywhere on an object in the 3D view.
  3. Select the second dimension point anywhere on an object in the 3D view.
  4. The selection order of the points can have an impact on the position of the dimension line.
  5. Optionally flip the position of the dimension line by changing the ViewMirror property of the distance object.

Notes

Properties

Data

Base

  • DataLabel: by default the label contains the measured distance, but this distance is not updated when P1 or P2 are later changed.

Measurement

  • DataP1: the first dimension point.
  • DataP2: the second dimension point.
  • DataDistance: (read-only) the measured distance between P1 and P2.

View

Base

  • ViewDist Factor: this factor, multiplied by the measured distance, determines the dimension line offset.
  • ViewFont Size: the height of the letters (line height in pixels).
  • ViewMirror: if set to true the position of the dimension line relative to P1 and P2 is flipped.