TechDraw DiameterDimension/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav|[[TechDraw_Dimension_Radius|New Radius]]|[[TechDraw_Dimension_Angle|New Angle]]|[[TechDraw_Module|TechDraw]]|IconL=Techdraw_Dimension_Radius.png|IconC=Workbench_TechDraw.svg|IconR=Techdraw_Dimension_Angle.png}}
{{Docnav
|[[TechDraw_RadiusDimension|RadiusDimension]]
|[[TechDraw_AngleDimension|AngleDimension]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_RadiusDimension.svg
|IconR=TechDraw_AngleDimension.svg
|IconC=Workbench_TechDraw.svg
}}


{{GuiCommand
{{GuiCommand
|Name=TechDraw Dimension Diameter
|Name=TechDraw DiameterDimension
|MenuLocation=TechDraw → Dimension Diameter
|MenuLocation=TechDraw → Dimensions → Insert Diameter Dimension
|Workbenches=[[TechDraw Module|TechDraw]]
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|SeeAlso=[[TechDraw Dimension Radius]]
|SeeAlso=[[TechDraw_RadiusDimension|TechDraw RadiusDimension]]
}}
}}


==Description==
==Description==


The Dimension Diameter tool adds a diameter dimension to a View. The dimension may be applied to any circular in the drawing. The distance will initially be the projected distance (ie as shown on the drawing), but this may be changed to the actual 3D distance using the {{Button|[[Image:TechDraw_Dimension_Link.svg|16px]] [[TechDraw_Dimension_Link|Link Dimension]]}} tool.
The Diameter Dimension tool adds a diameter dimension to a View. The dimension may be applied to any circular in the drawing. The distance will initially be the projected distance (ie as shown on the drawing), but this may be changed to the actual 3D distance using the {{Button|[[Image:TechDraw_LinkDimension.svg|16px]] [[TechDraw_LinkDimension|TechDraw LinkDimension]]}} tool.


[[Image:TechDraw_Dimension_Diameter_example.png]]
[[Image:TechDraw_Dimension_Diameter_example.png|130px]]
{{Caption|Measuring a circle, indicating the diameter}}
{{Caption|Measuring a circle, indicating the diameter}}


==How to use==
==Usage==


# Select a circular edge in the drawing. (Note some arcs which appear to be circular are actually ellipses or BSplines. You cannot make a diameter dimension in these cases)
# Select a circular edge in the drawing. (Note some arcs which appear to be circular are actually ellipses or BSplines. You cannot make a diameter dimension in these cases)
# Press the {{Button|[[Image:Dimension_Diameter.png|16px]] [[TechDraw Dimension Diameter|Dimension Diameter]]}} button
# Press the {{Button|[[Image:TechDraw_DiameterDimension.svg|16px]] [[TechDraw_DiameterDimension|Diameter Dimension]]}} button
# A dimension will be added to the View. The dimension may be dragged to the desired position.
# A dimension will be added to the View. The dimension may be dragged to the desired position.
# If needed, add tolerances as described in [[TechDraw_Geometric_dimensioning_and_tolerancing#Tolerances|this page]].

To change the properties of a dimension object either double-clicking it in the drawing or in the [[Tree_view|Tree view]]. This will open the [[TechDraw_LengthDimension#Dimension_dialog|dimension dialog]].


== Limitations ==
== Limitations ==


Dimension objects are vulnerable to "topological naming" issues. See the information in the [[TechDraw Dimension Length]] tool for more information.
Dimension objects are vulnerable to the "[[Topological_naming_problem|topological naming problem]]". See [[TechDraw_LengthDimension|TechDraw LengthDimension]] for more information.


==Properties==
==Properties==


See [[TechDraw_LengthDimension#Properties|TechDraw LengthDimension]].
This object has the same properties as the [[TechDraw Dimension Length]] tool. See that tool for details.


==Scripting==
==Scripting==


{{Emphasis|See also:}} [[TechDraw API]] and [[FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[TechDraw_API|TechDraw API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


The Dimension Diameter tool can be used in [[macros]] and from the [[Python]] console by using the following functions:
The Diameter Dimension tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:


{{Code|code=
{{Code|code=
Line 44: Line 55:




{{Docnav
{{Docnav|[[TechDraw_Dimension_Radius|New Radius]]|[[TechDraw_Dimension_Angle|New Angle]]|[[TechDraw_Module|TechDraw]]|IconL=Techdraw_Dimension_Radius.png|IconC=Workbench_TechDraw.svg|IconR=Techdraw_Dimension_Angle.png}}
|[[TechDraw_RadiusDimension|RadiusDimension]]

|[[TechDraw_AngleDimension|AngleDimension]]
{{TechDraw Tools navi}}
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_RadiusDimension.svg
|IconR=TechDraw_AngleDimension.svg
|IconC=Workbench_TechDraw.svg
}}


{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 19:28, 15 September 2021

TechDraw DiameterDimension

Menu location
TechDraw → Dimensions → Insert Diameter Dimension
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
TechDraw RadiusDimension

Description

The Diameter Dimension tool adds a diameter dimension to a View. The dimension may be applied to any circular in the drawing. The distance will initially be the projected distance (ie as shown on the drawing), but this may be changed to the actual 3D distance using the TechDraw LinkDimension tool.

Measuring a circle, indicating the diameter

Usage

  1. Select a circular edge in the drawing. (Note some arcs which appear to be circular are actually ellipses or BSplines. You cannot make a diameter dimension in these cases)
  2. Press the Diameter Dimension button
  3. A dimension will be added to the View. The dimension may be dragged to the desired position.
  4. If needed, add tolerances as described in this page.

To change the properties of a dimension object either double-clicking it in the drawing or in the Tree view. This will open the dimension dialog.

Limitations

Dimension objects are vulnerable to the "topological naming problem". See TechDraw LengthDimension for more information.

Properties

See TechDraw LengthDimension.

Scripting

See also: TechDraw API and FreeCAD Scripting Basics.

The Diameter Dimension tool can be used in macros and from the Python console by using the following functions:

dim1 = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewDimension','Dimension')
dim1.Type = "Diameter"
dim1.References2D=[(view1, 'Edge1')]
rc = page.addView(dim1)