Std MeasureDistance: Difference between revisions
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= |
|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--> |
||
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--> |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
# 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]]. |
|||
⚫ | |||
==Limitations== <!--T:5--> |
|||
⚫ | |||
The tool lets you only select points by clicking in the 3D view. |
|||
⚫ | |||
You can't use the snap tools from the draft workbench to allow specific selecting of special points. |
|||
⚫ | |||
⚫ | |||
# 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]]. |
|||
⚫ | |||
==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--> |
|||
⚫ | |||
</translate> |
</translate> |
||
⚫ | |||
⚫ | |||
{{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
- There are several ways to invoke the command:
- Press the Std MeasureDistance button.
- Select the Tools → Measure distance option from the menu.
- Select the first dimension point in the 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 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.
Std Base
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub