TechDraw LinkDimension: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(42 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:19-->
<!--T:19-->
{{Docnav
{{Docnav
|[[TechDraw_VerticalExtentDimension|VerticalExtentDimension]]
|[[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]
|[[TechDraw_Balloon|New Ballon]]
|[[TechDraw_Balloon|Balloon]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_VerticalExtentDimension.svg
|IconL=TechDraw_Dimension_Angle3Pt.png
|IconR=TechDraw_Balloon.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw Balloon.svg
}}
}}

<!--T:24-->
{{VeryImportantMessage|The '''TechDraw LinkDimension''' tool is '''[https://en.wikipedia.org/wiki/Deprecation DEPRECATED]''' and will be removed in a future version. It should only be used with old (< v0.19) FreeCAD versions and files.<br>
In newer versions the [[TechDraw_DimensionRepair|TechDraw DimensionRepair]] tool should be used to change both 2D and 3D references.}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=TechDraw Dimension Link
|Name=TechDraw LinkDimension
|MenuLocation=TechDraw → Dimension Link
|MenuLocation=TechDraw → Dimensions → Link Dimension to 3D Geometry
|Workbenches=[[TechDraw Module|TechDraw]]
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|SeeAlso=[[TechDraw NewView|TechDraw NewView]], [[TechDraw NewProjGroup|TechDraw NewProjGroup]]
|SeeAlso=[[TechDraw_View|TechDraw View]], [[TechDraw_ProjectionGroup|TechDraw ProjectionGroup]]
}}
}}


Line 22: Line 27:


<!--T:8-->
<!--T:8-->
The Dimension Link tool creates a link between 3D geometry and 1 or more existing projected Dimensions on a Page. This link allows the Dimension to use actual 3D values instead of 2D projected values.
The '''TechDraw LinkDimension''' tool creates a link between 3D geometry and one or more existing projected Dimensions on a Page. This link allows the Dimension to use actual 3D values instead of 2D projected values.


<!--T:22-->
The Dimension Link tool's most common use is in dimensioning isometric views in a ProjectionGroup. The projected length of an Edge in an isometric view will, of course, not equal the actual length of the Edge. The Dimension Link instructs the Dimension to compute it's value directly from the 3D geometry.
The Link Dimension tool's most common use is in dimensioning isometric views in a ProjectionGroup. The projected length of an Edge in an isometric view will, of course, not necessarily equal the actual length of the Edge. In an orthogonal view the projected and actual lengths will be equal.


==How to use== <!--T:3-->
<!--T:23-->
The link instructs the Dimension to compute it's value directly from the 3D geometry.

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


<!--T:9-->
<!--T:9-->
# Create an appropriate dimension on the drawing page using any of [[TechDraw_Dimension_Length|Dimension Length]], [[TechDraw_Dimension_Horizontal|Dimension Horizontal]], etc. This dimension will be in the right place on the Page, but will show the projected dimension value.
# Create an appropriate dimension on the drawing page using any of [[TechDraw_LengthDimension|TechDraw LengthDimension]], [[TechDraw_HorizontalDimension|TechDraw HorizontalDimension]], etc. This dimension will be in the right place on the Page, but will show the projected dimension value.
# Select the geometry in the 3D view, for example, an edge, that corresponds to the projected geometry of your dimension.
# Select the geometry in the 3D view, for example, an edge, that corresponds to the projected geometry of your dimension.
# There are several ways to invoke the tool:
# Press the {{Button|[[Image:TechDraw_Dimension_Link.svg|16px]] [[TechDraw Dimension Link|Dimension Link]]}} button.
#* Press the {{Button|[[Image:TechDraw_LinkDimension.svg|16px]] [[TechDraw_LinkDimension|Link Dimension to 3D Geometry]]}} button.
# A dialog will open. Select one or more Dimensions to be linked to the selected 3D geometry.
#* Select the {{MenuCommand|TechDraw → Dimensions → [[Image:TechDraw_LinkDimension.svg|16px]] Link Dimension to 3D Geometry}} option from the menu.
# A task panel opens.
# Select one or more Dimensions to be linked to the selected 3D geometry.
# Press {{Button|OK}}.
# Press {{Button|OK}}.


<!--T:10-->
<!--T:10-->
After the link operation is completed the {{PropertyData|MeasureType}} property of the dimension changes from {{incode|Projected}} to {{incode|True}}.
The link operation changes the {{PropertyData|MeasureType}} property of the dimension from {{incode|Projected}} to {{incode|True}}.


==Limitations== <!--T:7-->
==Limitations== <!--T:7-->


<!--T:11-->
<!--T:11-->
Dimension objects are vulnerable to "topological naming" issues. See the information in the [[TechDraw Dimension Length|TechDraw Dimension Length]] tool for more information. It is recommended that linking dimensions be one of the last steps in your drawing process.
Dimension objects are vulnerable to the "[[Topological_naming_problem|topological naming problem]]". See [[TechDraw_LengthDimension|TechDraw LengthDimension]] for more information. It is recommended that linking dimensions be one of the last steps in your drawing process.


<!--T:12-->
<!--T:12-->
Line 50: Line 62:


<!--T:21-->
<!--T:21-->
Note that if the Dimension to be linked is based on two vertices, you should select two vertices in the 3D view. Similarly if the Dimension is based on an edge, you should select an edge in the 3D view.
Note that if the Dimension to be linked is based on two vertices, you should select two vertices in the 3D view. Similarly if the Dimension is based on an edge, you should select an edge in the 3D view.

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

<!--T:14-->
# The MeasureType property of a linked Dimension will be changed from "Projected" to "True".


==Scripting== <!--T:6-->
==Scripting== <!--T:6-->


<!--T:15-->
<!--T:15-->
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:16-->
<!--T:25-->
The Dimension Link tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following functions:
The TechDraw LinkDimension tool is not directly usable in macros, but changing the {{PropertyData|References 3D}} property can accomplish the same result.

</translate>
{{Code|code=
to be defined
}}
<translate>




<!--T:20-->
<!--T:20-->
{{Docnav
{{Docnav
|[[TechDraw_VerticalExtentDimension|VerticalExtentDimension]]
|[[TechDraw_Dimension_Angle3Pt|New Angle3Pt]]
|[[TechDraw_Balloon|New Ballon]]
|[[TechDraw_Balloon|Balloon]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_VerticalExtentDimension.svg
|IconL=TechDraw_Dimension_Angle3Pt.png
|IconR=TechDraw_Balloon.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw Balloon.svg
}}
}}


<!--T:17-->
{{TechDraw Tools navi}}

<!--T:18-->
{{Userdocnavi}}
</translate>
</translate>
{{TechDraw Tools navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 13:43, 18 March 2024

The TechDraw LinkDimension tool is DEPRECATED and will be removed in a future version. It should only be used with old (< v0.19) FreeCAD versions and files.
In newer versions the TechDraw DimensionRepair tool should be used to change both 2D and 3D references.

TechDraw LinkDimension

Menu location
TechDraw → Dimensions → Link Dimension to 3D Geometry
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
TechDraw View, TechDraw ProjectionGroup

Description

The TechDraw LinkDimension tool creates a link between 3D geometry and one or more existing projected Dimensions on a Page. This link allows the Dimension to use actual 3D values instead of 2D projected values.

The Link Dimension tool's most common use is in dimensioning isometric views in a ProjectionGroup. The projected length of an Edge in an isometric view will, of course, not necessarily equal the actual length of the Edge. In an orthogonal view the projected and actual lengths will be equal.

The link instructs the Dimension to compute it's value directly from the 3D geometry.

Usage

  1. Create an appropriate dimension on the drawing page using any of TechDraw LengthDimension, TechDraw HorizontalDimension, etc. This dimension will be in the right place on the Page, but will show the projected dimension value.
  2. Select the geometry in the 3D view, for example, an edge, that corresponds to the projected geometry of your dimension.
  3. There are several ways to invoke the tool:
  4. A task panel opens.
  5. Select one or more Dimensions to be linked to the selected 3D geometry.
  6. Press OK.

The link operation changes the DataMeasureType property of the dimension from Projected to True.

Limitations

Dimension objects are vulnerable to the "topological naming problem". See TechDraw LengthDimension for more information. It is recommended that linking dimensions be one of the last steps in your drawing process.

The link tool will not stop you from making illogical links, so you need to choose the correct edge from the 3D view when creating the link.

There is currently no way to break a link; you can change the DataMeasureType back to Projected so that the dimension will use the projected value instead of the linked value.

Note that if the Dimension to be linked is based on two vertices, you should select two vertices in the 3D view. Similarly if the Dimension is based on an edge, you should select an edge in the 3D view.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

The TechDraw LinkDimension tool is not directly usable in macros, but changing the DataReferences 3D property can accomplish the same result.