Std MeasureDistance: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Revised. 'In progress' for now.)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>

{{Docnav
|[[Std_ProjectUtil|Std ProjectUtil]]
|[[Std_TextDocument|Std TextDocument]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=
|IconR=Std_TextDocument.svg
|IconC=Freecad.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Std MeasureDistance
|Name=Std MeasureDistance
|MenuLocation={{StdMenu|[[Std Tools Menu|Tools]]}} → Measure distance
|MenuLocation=Tools → Measure distance
|Workbenches=All
|Workbenches=All
|Shortcut=
|SeeAlso=[[Std Measure Menu|Measure Tools]], [[Draft Dimension|Draft Dimension]], [[Arch Survey|Arch Survey]]
|SeeAlso=[[Std Measure Menu|Measure Tools]], [[Draft Dimension|Draft Dimension]], [[Arch Survey|Arch Survey]]
}}
}}


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

This tool measures and displays the absolute distance between two points in 3D space.
The '''Std MeasureDistance''' command creates a Distance object that measures and displays the distance between two points in 3D space.


==Usage== <!--T:4-->
==Usage== <!--T:4-->
# There are a couple ways to invoke the MeasureDistance command:
#* Press on [[Image:Std_MeasureDistance.svg|16px]] button in the toolbar
#* Use {{MenuCommand|{{StdMenu|[[Std Tools Menu|Tools]]}} [[Image:Std_MeasureDistance.svg|16px]] [[Std MeasureDistance|Measure Distance]]}} entry from the top menu
# Select first point in [[3D view]].
# Select second point in 3D view.
# The absolute distance between the two points will be calculated and displayed in the 3D view.
# A distance object will be created in the [[tree view]].


# There are several ways to invoke the command:
==Limitations== <!--T:5-->
#* Press the {{Button|[[Image:Std_MeasureDistance.svg|16px]] [[Std_MeasureDistance|Std MeasureDistance]]}} button.
The tool lets you only select points by clicking in the 3D view.
#* Select the {{MenuCommand|Tools → [[Image:Std_MeasureDistance.svg|16px]] Measure distance}} option from the menu.
You can't use the snap tools from the draft workbench to allow specific selecting of special points.
# Select the first dimension point in the [[3D_view|3D view]].
# Select the second dimension point in the 3D view.
# The selection order of the points can have an impact on the position of the dimension line. The position can also be flipped by changing the {{PropertyView|Mirror}} property of the distance object.


==Notes== <!--T:6-->
==Notes== <!--T:6-->
For more possibilities related to measuring/dimensioning see the following tools:
* [[Image:Std_Measure_Menu.png|32px]] [[Std Measure Menu|Measure Tools]] from [[Image:Workbench_Part.svg|24px]] [[Part Workbench]]
* [[Image:Draft_Dimension.svg|24px]] [[Draft Dimension|Draft Dimension]] tool from [[Image:Workbench_Draft.svg|24px]] [[Draft Workbench]]
* [[Image:Arch Survey.svg|24px]] [[Arch Survey|Arch Survey]] tool from [[Image:Workbench_Arch.svg|24px]] [[Arch Module|Arch Workbench]]


* You cannot use the [[Draft_Workbench|Draft]] snap tools with this command.
<!--T:3-->
* To add dimensions to drawings use the dimension tools from the [[TechDraw_Module|TechDraw Workbench]].
{{Std Base navi}}

==Properties==

* {{PropertyData|Label}}: by default the label contains the measured distance, but this distance is not updated when P1 or P2 are later changed.
* {{PropertyData|P1}}: the first dimension point.
* {{PropertyData|P2}}: the second dimension point.
* {{PropertyData|Distance}}: (read-only) the measured distance between P1 and P2.
* {{PropertyView|Dist Factor}}: this factor, multiplied by the measured distance, determines the dimension line offset.
* {{PropertyView|Font Size}}: the height of the letters.
* {{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.

==Scripting==

* Todo.

{{Docnav
|[[Std_ProjectUtil|Std ProjectUtil]]
|[[Std_TextDocument|Std TextDocument]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=
|IconR=Std_TextDocument.svg
|IconC=Freecad.svg
}}


<!--T:7-->
{{Userdocnavi}}
</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 08:55, 21 April 2020

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.


Std MeasureDistance

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

Description

The Std MeasureDistance command creates a Distance object that measures and displays the distance between two points in 3D space.

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 in the 3D view.
  3. Select the second dimension point in the 3D view.
  4. The selection order of the points can have an impact on the position of the dimension line. The position can also be flipped by changing the ViewMirror property of the distance object.

Notes

  • You cannot use the Draft snap tools with this command.
  • To add dimensions to drawings use the dimension tools from the TechDraw Workbench.

Properties

  • DataLabel: by default the label contains the measured distance, but this distance is not updated when P1 or P2 are later changed.
  • DataP1: the first dimension point.
  • DataP2: the second dimension point.
  • DataDistance: (read-only) the measured distance between P1 and P2.
  • ViewDist Factor: this factor, multiplied by the measured distance, determines the dimension line offset.
  • ViewFont Size: the height of the letters.
  • ViewMirror: if set to true the position of the dimension line relative to P1 and P2 is flipped.
  • ViewOn Top When Selected: has no effect.

Scripting

  • Todo.