Draft Dimension/cs: Difference between revisions

From FreeCAD Documentation
(Created page with "==Použití== # Stiskněte tlačítko {{KEY|16px Kóta}} nebo klávesy {{KEY|D}} a pak {{KEY|I}} # Klikněte na bod ve 3D pohledu nebo zadejt...")
(Updating to match new version of source page)
 
(50 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Draft Dimension|Workbenches=[[Draft Module|Kreslení]], [[Arch Module|Architektura]]|MenuLocation=Draft -> Dimension|Shortcut=D I}}

{{Docnav
|[[Draft_Text|Text]]
|[[Draft_Label|Label]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Text.svg
|IconR=Draft_Label.svg
|IconC=Workbench_Draft.svg
}}

<div class="mw-translate-fuzzy">
{{GuiCommand/cs|Name=Draft Dimension|Name/cs=Draft Dimension|Workbenches=[[Draft_Workbench/cs|Kreslení]], [[Arch_Workbench/cs|Architektura]]|MenuLocation=Draft → Dimension|Shortcut=D I|SeeAlso=[[Draft FlipDimension/cs|FlipDimension]]}}
</div>

==Description==


<div class="mw-translate-fuzzy">
==Popis==
==Popis==
Nástroj Kóta kreslí kóty v aktuálním dokumentu podle dvou bodů definujících měřenou vzdálenost a třetího bodu, který určuje kudy bude kóta procházet.
Nástroj Kóta kreslí kóty v aktuálním dokumentu podle dvou bodů definujících měřenou vzdálenost a třetího bodu, který určuje kudy bude kóta procházet.
</div>


Linear dimensions based on edges and radial dimensions are parametric. This means that they will update if the measured edge is modified. Measured edges can belong to Draft objects but also to solid bodies. Angular dimensions are not parametric.

Draft Dimensions can be displayed on a [[TechDraw_Workbench|TechDraw Workbench]] page using the [[TechDraw_DraftView|TechDraw DraftView]] or [[TechDraw_ArchView|TechDraw ArchView]] commands. Alternatively the [[TechDraw_Workbench|TechDraw Workbench]] offer its own dimension commands. But these create dimensions that are only displayed on the drawing page and not in the [[3D_view|3D view]].

[[Image:Screenshot_Draft_Dimension.jpg|400px]]
<div class="mw-translate-fuzzy">
[[Image:Screenshot_Draft_Dimension.jpg|400px]]
[[Image:Screenshot_Draft_Dimension.jpg|400px]]
</div>


== Create ==

See also: [[Draft_Tray|Draft Tray]], [[Draft_Snap|Draft Snap]] and [[Draft_Constrain|Draft Constrain]].

=== Usage linear dimension ===

<div class="mw-translate-fuzzy">
==Použití==
==Použití==
# Stiskněte tlačítko {{KEY|[[Image:Draft Dimension.png|16px]] [[Kóta]]}} nebo klávesy {{KEY|D}} a pak {{KEY|I}}
# Stiskněte tlačítko {{KEY|[[Image:Draft Dimension.png|16px]] [[Draft Dimension/cs|Kóta]]}} nebo klávesy {{KEY|D}} a pak {{KEY|I}}
# Klikněte na bod ve 3D pohledu nebo zadejte [[Draft_Coordinates|souřadnice]]
# Klikněte na bod ve 3D pohledu nebo zadejte souřadnice
# Klikněte na druhý bod ve 3D pohledu nebo zadejte [[Draft_Coordinates|souřadnice]]
# Klikněte na druhý bod ve 3D pohledu nebo zadejte souřadnice
# Klikněte na třetí bod ve 3D pohledu nebo zadejte [[Draft_Coordinates|souřadnice]]
# Klikněte na třetí bod ve 3D pohledu nebo zadejte souřadnice
</div>


==Available dimension types==
=== Usage radial dimension ===
* '''Linear dimensions''': by picking any 2 points or any straight edge with {{KEY|ALT}} pressed.
* '''Horizontal/vertical dimensions''': by pressing {{KEY|SHIFT}} after the first point is selected.
* '''Diameter dimensions''': by picking a curved edge with {{KEY|ALT}} pressed.
* '''Radius dimensions''': by picking a curved edge with {{KEY|ALT}} pressed, then pressing {{KEY|SHIFT}}.
* '''Angular dimensions''': by picking 2 straight edges with {{KEY|ALT}} pressed.


# Optionally select a circular edge in the [[3D_view|3D view]].
==Options==
# There are several ways to invoke the command:
* Press {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}} after a point to constrain the next point on the given axis.
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button.
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu.
* Press {{KEY|CTRL}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}.
* Pressing {{KEY|SHIFT}} will [[Draft_Constrain|constrain]] the dimension horizontally or vertically, or, when working on a circular edge, switches between diameter and radius modes.
# The {{MenuCommand|Dimension}} task panel opens. See [[#Options|Options]] for more information.
* Press {{KEY|R}} or click the checkbox to check/uncheck the {{KEY|'''Relative'''}} button. If relative mode is on, the coordinates of the next point are relative to the last one. If not, they are absolute, taken from the (0,0,0) origin point.
# If you have not yet selected an edge do one of the following:
* Press {{KEY|T}} or click the checkbox to check/uncheck the {{KEY|'''Continue'''}} button. If continue mode is on, you will be able to draw continued dimensions, one after the other, that share the same baseline.
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button to abort the current Line command.
#* Press {{KEY|E}} or the {{Button|[[Image:view-select.svg|16px]] Select edge}} button and select a circular edge in the [[3D_view|3D view]].
#* Hold down the {{KEY|Alt}} key, select a circular edge in the [[3D_view|3D view]] and release the {{KEY|Alt}} key.
* By picking an existing edge with {{KEY|ALT}}, instead of entering measurement points, the dimension will become '''parametric''' and remember which edge it is bound to. If the endpoints of that edge move later on, the dimension will follow them.
# To position the dimension line do one of the following:
#* For a diameter dimension:
#** Pick a point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button.
#* For a radial dimension:
#** Hold down the {{KEY|Shift}} key and pick a point in the [[3D_view|3D view]].


=== Usage angular dimension ===
==Properties==

* {{PropertyData|Start}}: The start point of the distance to measure
# There are several ways to invoke the command:
* {{PropertyData|End}}: The end point of the distance to measure
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button.
* {{PropertyData|Dimline}}: A point through which the dimension line must pass
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu.
* {{PropertyView|Display Mode}}: Specifies if the text is aligned to the dimension lines or always faces the camera
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}.
* {{PropertyView|Font Size}}: The size of the letters
# The {{MenuCommand|Dimension}} task panel opens. See [[#Options|Options]] for more information.
* {{PropertyView|Ext Lines}}: The size of the extension lines (between the measurement points and the dimension line)
# Do one of the following:
* {{PropertyView|Text Position}}: Can be used to force the text to be displayed at a certain position
#* Press {{KEY|E}} or the {{Button|[[Image:view-select.svg|16px]] Select edge}} button and select a first straight edge in the [[3D_view|3D view]]. Repeat this to select a second straight edge.
* {{PropertyView|Override}}: Specifies a text to display instead of the measurement. Use the word "dim", inside that text, to display the measurement
#* Hold down the {{KEY|Alt}} key, select two straight edges in the [[3D_view|3D view]] and release the {{KEY|Alt}} key.
* {{PropertyView|Font Name}}: The font to use to draw the text. It can be a font name, such as "Arial", a default style such as "sans", "serif" or "mono", or a family such as "Arial,Helvetica,sans" or a name with a style such as "Arial:Bold". If the given font is not found on the system, a generic one is used instead.
# To position the dimension arc pick a point in the [[3D_view|3D view]].
# The displayed angle depends on the edges and the picked point.

=== Options ===

The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts (for version 0.22).

<div class="mw-translate-fuzzy">
==Volby==
* Stiskněte klávesu {{KEY|X}}, {{KEY|Y}} nebo {{KEY|Z}} po zadání bodu pro určení osy, na které bude ležet další bod.
* Pro ruční zadání souřadnic jednoduše vložte číslo a {{KEY|ENTER}} mezi každou z komponent X, Y a Z.
* Stiskněte při kreslení klávesu {{KEY|CTRL}} pro [[Draft_Snap|přichycení]] Vašeho bodu k nejbližšímu uchopovacímu místu, nezávisle na vzdálenosti od něho.
* Stiskněte při kreslení klávesu {{KEY|SHIFT}} pro nastavení [[Draft_Constrain|vazby]] kóty vodorovně nebo svisle nebo pokud pracujete na zakřivené hraně, přepíná mezi módem průměru a poloměru.
* Stiskněte klávesu {{KEY|R}} nebo klikněte/odklikněte zaklikávací políčko {{KEY|'''Relativní'''}}. Je-li nastaven relativní mód jsou souřadnice následujícího bodu relativní k předchozímu bodu. Je-li mód absolutní souřadnice jsou vztaženy k počátečnímu bodu (0,0,0).
* Stiskněte klávesu {{KEY|T}} nebo klikněte/odklikněte zaklikávací políčko {{KEY|'''Pokračovat'''}}. Je-li nastaven pokračovací mód, můžete kreslit pokračovací kóty jednu za druhou při sdílení stejné základny.
* Stiskněte klávesu {{KEY|ESC}} nebo tlačítko {{KEY|'''Cancel'''}} pro ukončení aktuálního příkazu.
* Výběrem existující hrany se stisknutou klávesou {{KEY|ALT}}, místo vložení měřeného bodu se kóta stane '''parametrickou''' a bude si pamatovat ke které hraně patří. Jestli se později některý z koncových bodů hrany posune, bude jej kóta následovat.
* Směr kóty může být změněn později úpravou vlastnosti "Směr".
</div>

== Convert ==

=== Usage ===

# Select one or more [[Std_MeasureDistance|Std MeasureDistance]] objects.
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}.
# Each selected object is replaced by a non-parametric linear Draft Dimension.

==Notes==

* Linear and radial Draft Dimensions can be edited with the [[Draft_Edit|Draft Edit]] command.
* Draft Dimensions created or saved with [[Release_notes_0.21|FreeCAD version 0.21]] are not backward compatible.

<span id="Properties"></span>
<div class="mw-translate-fuzzy">
==Vlastnosti==
* {{PropertyData|Začátek}}: Počáteční bod měření
* {{PropertyData|Konec}}: Konečný bod měření
* {{PropertyData|PřímkaKóty}}: Bod, kterým musí procházet kótovací čára
* {{PropertyView|Mód zobrazení}}: Určuje zda je text zarovnán podle kótovací čáry nebo stále natočen ke kameře
* {{PropertyView|Velikost fontu}}: Velikost fontu textu
* {{PropertyView|Vynášecí čáry}}: rozměr vynášecích čar (mezi měřenými body a kótovací čárou)
* {{PropertyView|Pozice textu}}: Může být využita pro určení pozice, kde má být text zobrazen
* {{PropertyView|Odsazení textu}}: Specifikuje mezeru mezi textem a kótovací čárou
* {{PropertyView|Override}}: Specifikuje text, který se má zobrazit místo míry. Chcete-li aby se v textu objevil i údaj o míře, použijte v požadovaném místě textu slovo "$dim"
* {{PropertyView|Název fontu}}: Font použitý při vykreslení textu. Může to být název fontu jako je "Arial", defaultní styl jako je "sans", "serif" nebo "mono" nebo family jako je "Arial,Helvetica,sans" nebo jméno se stylem jako třeba "Arial:Bold". Není-li zadaný font nalezen v systému, je místo něj použit obecný font.
* {{PropertyView|Typ šipky}}: Použitý typ šipky
* {{PropertyView|Velikost šipky}}: Rozměr šipky
* {{PropertyView|Desetiná místa}}: Zobrazovaný počet desetinných míst
* {{PropertyView|Obrátit šipky}}: Obrátí orientaci šipek
</div>

See also: [[Property_editor|Property editor]].

A Draft Dimension object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. The following properties are additional unless otherwise stated:

=== Data linear and radial dimension ===

{{TitleProperty|Dimension}}

* {{PropertyData|Dimline|VectorDistance}}: specifies the point through which the dimension line passes.
* {{PropertyData|Linked Geometry|LinkSubList}}: specifies the object and its subelement(s) the dimension is linked to.
* {{PropertyData|Normal|Vector}}: specifies the normal of the plane of the text.
* {{PropertyData|Support|Link|hidden}}: specifies the measured object.

{{TitleProperty|Linear/radial dimension}}

* {{PropertyData|Direction|Vector}}: specifies the direction of the measurement.
* {{PropertyData|Distance|Length}}: (read-only) specifies the value of the measurement.
* {{PropertyData|End|VectorDistance}}: specifies the end point of the measurement.
* {{PropertyData|Start|VectorDistance}}: specifies the start point of the measurement.

{{TitleProperty|Radial dimension}}

* {{PropertyData|Diameter|Bool}}: specifies if a radial dimension is displayed as a diameter dimension. Not used for linear dimensions.

=== Data angular dimension ===

{{TitleProperty|Angular dimension}}

* {{PropertyData|Angle|Angle}}: (read-only) specifies the value of the measurement.
* {{PropertyData|Center|VectorDistance}}: specifies the center of the measurement.
* {{PropertyData|First Angle|Angle}}: specifies the start angle of the measurement.
* {{PropertyData|Last Angle|Angle}}: specifies the end angle of the measurement.

{{TitleProperty|Dimension}}

* {{PropertyData|Dimline|VectorDistance}}: specifies the point through which the dimension arc passes.
* {{PropertyData|Linked Geometry|LinkSubList|hidden}}: not used.
* {{PropertyData|Normal|Vector|hidden}}: specifies the normal of the plane of the dimension.
* {{PropertyData|Support|Link|hidden}}: not used.

=== View ===

{{TitleProperty|Annotation}}

* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the dimension. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]].
* {{PropertyView|Scale Multiplier|Float}}: specifies the general scaling factor applied to the dimension.

{{TitleProperty|Display Options}}

* {{PropertyView|Display Mode|Enumeration}}: specifies how the text is displayed. If it is {{value|World}} the text will be displayed on a plane defined by the {{PropertyData|Normal}} of the measurement. If it is {{value|Screen}} the text will always face the screen. This is an inherited property. The mentioned options are the renamed options ({{Version|0.21}}).

{{TitleProperty|Graphics}}

* {{PropertyView|Arrow Size|Length}}: specifies the size of the symbols displayed at the ends of the dimension line or arc.
* {{PropertyView|Arrow Type|Enumeration}}: specifies the type of symbol displayed at the ends of the dimension line or arc, which can be {{value|Dot}}, {{value|Circle}}, {{value|Arrow}}, {{value|Tick}} or {{value|Tick-2}}.
* {{PropertyView|Dim Overshoot|Distance}}: specifies the additional length added to the dimension line. Not used for angular dimensions.
* {{PropertyView|Ext Lines|Distance}}: specifies the length of the extension lines that go from the dimension line to the measured points. Use {{Value|0}} for full extension lines. A negative value defines the gap between the ends of the extension lines and the measured points. A positive value defines the maximum length of the extension lines. Only used for linear dimensions.
* {{PropertyView|Ext Overshoot|Distance}}: specifies the additional length of the extension lines beyond the dimension line. Not used for angular dimensions.
* {{PropertyView|Flip Arrows|Bool}}: specifies whether to flip the orientation of the symbols at the ends of the dimension line or arc. Only works if the symbols are arrows.
* {{PropertyView|Line Color|Color}}: specifies the color of the dimension line or arc, and the arrows.
* {{PropertyView|Line Width|Float}}: specifies the width of the lines or arc belonging to the dimension.
* {{PropertyView|Show Line|Bool}}: specifies whether to display the dimension line. Does not affect the display of extension lines and overshoots. Not used for angular dimensions.

{{TitleProperty|Text}}

* {{PropertyView|Flip Text|Bool}}: specifies whether to flip the orientation of the text.
* {{PropertyView|Font Name|Font}}: specifies the font used to draw the text. It can be a font name, such as {{value|Arial}}, a default style such as {{value|sans}}, {{value|serif}} or {{value|mono}}, a family such as {{value|Arial,Helvetica,sans}}, or a name with a style such as {{value|Arial:Bold}}. If the given font is not found on the system, a default font is used instead.
* {{PropertyView|Font Size|Length}}: specifies the size of the letters. The text can be invisible in the [[3D_view|3D view]] if this value is very small.
* {{PropertyView|Override|String}}: specifies a custom text to display instead of the actual measurement. Use the string {{value|$dim}} inside the text to include the measurement.
* {{PropertyView|Text Color|Color}}: specifies the color of the text. {{Version|0.21}}
* {{PropertyView|Text Position|VectorDistance}}: specifies the position of the text in absolute coordinates. {{Value|[0, 0, 0]}} will display the text in its default position near the dimension line or arc.
* {{PropertyView|Text Spacing|Length}}: specifies the space between the text and the dimension line or arc.

{{TitleProperty|Units}}

* {{PropertyView|Decimals|Integer}}: specifies the number of decimal places to display for the measurement.
* {{PropertyView|Show Unit|Bool}}: specifies whether to display the unit next to the numerical value of the measurement. Not used for angular dimensions.
* {{PropertyView|Unit Override|String}}: specifies the unit in which to express the measurement, for example, {{value|km}}, {{value|m}}, {{value|cm}}, {{value|mm}}, {{value|mi}}, {{value|ft}}, {{value|in}} or {{value|arch}} for arch units. Leave this blank to use the default unit. Not used for angular dimensions.


==Scripting==
==Scripting==
The Dimension tool can by used in [[macros]] and from the python console by using the following functions:
<syntaxhighlight>


<div class="mw-translate-fuzzy">
'''makeDimension (p1,p2,[p3])''' or '''makeDimension (object,i1,i2,p3)''' or '''makeDimension (objlist,indices,p3)'''
==Skriptování==
</syntaxhighlight>
Nástroj Kóta může být využit v [[macros|makrech]] a z konzoly Pythonu použitím následující funkce:
</div>
* Creates a Dimension object with the dimension line passign through p3.
* The Dimension object takes the [[Draft Linestyle|Draft linewidth and color]] set in the command bar.
* There are multiple ways to create a dimension, depending on the arguments you pass to it:
# (p1,p2,p3): creates a standard dimension from p1 to p2.
# (object,i1,i2,p3): creates a linked dimension to the given object, measuring the distance between its vertices indexed i1 and i2.
# (object,i1,mode,p3): creates a linked dimension to the given object, i1 is the index of the (curved) edge to measure, and mode is either "radius" or "diameter". Returns the newly created object.
<syntaxhighlight>
'''makeAngularDimension (center,[angle1,angle2],p3)'''
</syntaxhighlight>
* creates an angular Dimension from the given center, with the given list of angles, passing through p3.
* Returns the newly created object.


To create a Draft Dimension use the {{incode|make_dimension}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makeDimension}} method.
Example:
<syntaxhighlight>
import FreeCAD,Draft
p1 = FreeCAD.Vector(0,0,0)
p2 = FreeCAD.Vector(1,1,0)
p3 = FreeCAD.Vector(2,0,0)
Draft.makeDimension(p1,p2,p3)
</syntaxhighlight>
==Links==
[http://www.youtube.com/watch?v=nxNT0KychcY Tutorial Projecting dimensions on a Drawing Page]


{{Code|code=
<languages/>
dimension = make_dimension(p1, p2, p3=None, p4=None)}}

There are various ways to invoke this method, depending on the arguments passed to it:

{{Code|code=
dimension = make_dimension(p1, p2, p3=None)
dimension = make_dimension(object, i1, i2, p4=None)
dimension = make_dimension(object, i1, mode, p4=None)
}}

<div class="mw-translate-fuzzy">
* Vytvoří objekt kóty s kótovací čárou procházející přes p3.
* Objekt kóty přebíráe [[Draft Linestyle|tloušťku čáry a barvu]] nastavenou v příkazovém pruhu.
* Je několik způsobů vytvoření kóty v závislosti na předaných argumentech:
# (p1,p2,p3): vytvoří standardní kótu z p1 do p2.
# (object,i1,i2,p3): vytvoří spojenou kótu na daný objekt, která měří vzdálenost mezi vrcholy indexovanými i1 a i2.
# (object,i1,mode,p3): vytvoří spojenou kótu na daný objekt, i1 je index (zakřivené) měřené hrany a mód je buď "poloměr" nebo "průměr". Vrací nově vytvořený objekt.
</div>

To create an angular dimension use the following method:

{{Code|code=
dimension = make_angular_dimension(center, angles, p3, normal=None)
dimension = make_angular_dimension(center, [angle1, angle2], p3, normal=None)
}}

<div class="mw-translate-fuzzy">
* vytvoří úhlovou kótu z daného středu se zadaným seznamem úhlů procházející bodem p3.
* Vrací nově vytvořený objekt.
</div>

The view properties of {{incode|dimension}} can be changed by overwriting its attributes; for example, overwrite {{incode|ViewObject.FontSize}} with the new size in millimeters.

Příklad:

{{Code|code=
import FreeCAD as App
import Draft

doc = App.newDocument()

p1 = App.Vector(0, 0, 0)
p2 = App.Vector(1000, 1000, 0)
p3 = App.Vector(-2500, 0, 0)
dimension1 = Draft.make_dimension(p1, p2, p3)
dimension1.ViewObject.FontSize = 200

polygon = Draft.make_polygon(3, radius=1000)
doc.recompute()

p4 = App.Vector(-2000, 1500, 0)
dimension2 = Draft.make_dimension(polygon, 1, 2, p4)
dimension2.ViewObject.FontSize = 200

center = App.Vector(2000, 0, 0)
p5 = App.Vector(3000, 1000, 0)
angle1 = 45
angle2 = 10
dimension3 = Draft.make_angular_dimension(center, [angle1, angle2], p5)
dimension3.ViewObject.FontSize = 200

dimension4 = Draft.make_angular_dimension(center, [angle2, angle1], p5*1.2)
dimension4.ViewObject.FontSize = 200

doc.recompute()
}}


{{Docnav
|[[Draft_Text|Text]]
|[[Draft_Label|Label]]
|[[Draft_Workbench|Draft]]
|IconL=Draft_Text.svg
|IconR=Draft_Label.svg
|IconC=Workbench_Draft.svg
}}

{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 05:00, 9 January 2024

Draft Dimension

Umístění Menu
Draft → Dimension
Pracovní stoly
Kreslení, Architektura
Výchozí zástupce
D I
Představen ve verzi
-
Viz také
FlipDimension

Description

Popis

Nástroj Kóta kreslí kóty v aktuálním dokumentu podle dvou bodů definujících měřenou vzdálenost a třetího bodu, který určuje kudy bude kóta procházet.

Linear dimensions based on edges and radial dimensions are parametric. This means that they will update if the measured edge is modified. Measured edges can belong to Draft objects but also to solid bodies. Angular dimensions are not parametric.

Draft Dimensions can be displayed on a TechDraw Workbench page using the TechDraw DraftView or TechDraw ArchView commands. Alternatively the TechDraw Workbench offer its own dimension commands. But these create dimensions that are only displayed on the drawing page and not in the 3D view.

Create

See also: Draft Tray, Draft Snap and Draft Constrain.

Usage linear dimension

Použití

  1. Stiskněte tlačítko Kóta nebo klávesy D a pak I
  2. Klikněte na bod ve 3D pohledu nebo zadejte souřadnice
  3. Klikněte na druhý bod ve 3D pohledu nebo zadejte souřadnice
  4. Klikněte na třetí bod ve 3D pohledu nebo zadejte souřadnice

Usage radial dimension

  1. Optionally select a circular edge in the 3D view.
  2. There are several ways to invoke the command:
    • Press the Draft Dimension button.
    • Select the Annotation → Dimension option from the menu.
    • Use the keyboard shortcut: D then I.
  3. The Dimension task panel opens. See Options for more information.
  4. If you have not yet selected an edge do one of the following:
    • Press E or the Select edge button and select a circular edge in the 3D view.
    • Hold down the Alt key, select a circular edge in the 3D view and release the Alt key.
  5. To position the dimension line do one of the following:
    • For a diameter dimension:
      • Pick a point in the 3D view, or type coordinates and press the Enter point button.
    • For a radial dimension:
      • Hold down the Shift key and pick a point in the 3D view.

Usage angular dimension

  1. There are several ways to invoke the command:
    • Press the Draft Dimension button.
    • Select the Annotation → Dimension option from the menu.
    • Use the keyboard shortcut: D then I.
  2. The Dimension task panel opens. See Options for more information.
  3. Do one of the following:
    • Press E or the Select edge button and select a first straight edge in the 3D view. Repeat this to select a second straight edge.
    • Hold down the Alt key, select two straight edges in the 3D view and release the Alt key.
  4. To position the dimension arc pick a point in the 3D view.
  5. The displayed angle depends on the edges and the picked point.

Options

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts (for version 0.22).

Volby

  • Stiskněte klávesu X, Y nebo Z po zadání bodu pro určení osy, na které bude ležet další bod.
  • Pro ruční zadání souřadnic jednoduše vložte číslo a ENTER mezi každou z komponent X, Y a Z.
  • Stiskněte při kreslení klávesu CTRL pro přichycení Vašeho bodu k nejbližšímu uchopovacímu místu, nezávisle na vzdálenosti od něho.
  • Stiskněte při kreslení klávesu SHIFT pro nastavení vazby kóty vodorovně nebo svisle nebo pokud pracujete na zakřivené hraně, přepíná mezi módem průměru a poloměru.
  • Stiskněte klávesu R nebo klikněte/odklikněte zaklikávací políčko Relativní. Je-li nastaven relativní mód jsou souřadnice následujícího bodu relativní k předchozímu bodu. Je-li mód absolutní souřadnice jsou vztaženy k počátečnímu bodu (0,0,0).
  • Stiskněte klávesu T nebo klikněte/odklikněte zaklikávací políčko Pokračovat. Je-li nastaven pokračovací mód, můžete kreslit pokračovací kóty jednu za druhou při sdílení stejné základny.
  • Stiskněte klávesu ESC nebo tlačítko Cancel pro ukončení aktuálního příkazu.
  • Výběrem existující hrany se stisknutou klávesou ALT, místo vložení měřeného bodu se kóta stane parametrickou a bude si pamatovat ke které hraně patří. Jestli se později některý z koncových bodů hrany posune, bude jej kóta následovat.
  • Směr kóty může být změněn později úpravou vlastnosti "Směr".

Convert

Usage

  1. Select one or more Std MeasureDistance objects.
  2. There are several ways to invoke the command:
    • Press the Draft Dimension button.
    • Select the Annotation → Dimension option from the menu.
    • Use the keyboard shortcut: D then I.
  3. Each selected object is replaced by a non-parametric linear Draft Dimension.

Notes

  • Linear and radial Draft Dimensions can be edited with the Draft Edit command.
  • Draft Dimensions created or saved with FreeCAD version 0.21 are not backward compatible.

Vlastnosti

  • ÚdajeZačátek: Počáteční bod měření
  • ÚdajeKonec: Konečný bod měření
  • ÚdajePřímkaKóty: Bod, kterým musí procházet kótovací čára
  • PohledMód zobrazení: Určuje zda je text zarovnán podle kótovací čáry nebo stále natočen ke kameře
  • PohledVelikost fontu: Velikost fontu textu
  • PohledVynášecí čáry: rozměr vynášecích čar (mezi měřenými body a kótovací čárou)
  • PohledPozice textu: Může být využita pro určení pozice, kde má být text zobrazen
  • PohledOdsazení textu: Specifikuje mezeru mezi textem a kótovací čárou
  • PohledOverride: Specifikuje text, který se má zobrazit místo míry. Chcete-li aby se v textu objevil i údaj o míře, použijte v požadovaném místě textu slovo "$dim"
  • PohledNázev fontu: Font použitý při vykreslení textu. Může to být název fontu jako je "Arial", defaultní styl jako je "sans", "serif" nebo "mono" nebo family jako je "Arial,Helvetica,sans" nebo jméno se stylem jako třeba "Arial:Bold". Není-li zadaný font nalezen v systému, je místo něj použit obecný font.
  • PohledTyp šipky: Použitý typ šipky
  • PohledVelikost šipky: Rozměr šipky
  • PohledDesetiná místa: Zobrazovaný počet desetinných míst
  • PohledObrátit šipky: Obrátí orientaci šipek

See also: Property editor.

A Draft Dimension object is derived from an App FeaturePython object and inherits all its properties. The following properties are additional unless otherwise stated:

Data linear and radial dimension

Dimension

  • ÚdajeDimline (VectorDistance): specifies the point through which the dimension line passes.
  • ÚdajeLinked Geometry (LinkSubList): specifies the object and its subelement(s) the dimension is linked to.
  • ÚdajeNormal (Vector): specifies the normal of the plane of the text.
  • Údaje (hidden)Support (Link): specifies the measured object.

Linear/radial dimension

  • ÚdajeDirection (Vector): specifies the direction of the measurement.
  • ÚdajeDistance (Length): (read-only) specifies the value of the measurement.
  • ÚdajeEnd (VectorDistance): specifies the end point of the measurement.
  • ÚdajeStart (VectorDistance): specifies the start point of the measurement.

Radial dimension

  • ÚdajeDiameter (Bool): specifies if a radial dimension is displayed as a diameter dimension. Not used for linear dimensions.

Data angular dimension

Angular dimension

  • ÚdajeAngle (Angle): (read-only) specifies the value of the measurement.
  • ÚdajeCenter (VectorDistance): specifies the center of the measurement.
  • ÚdajeFirst Angle (Angle): specifies the start angle of the measurement.
  • ÚdajeLast Angle (Angle): specifies the end angle of the measurement.

Dimension

  • ÚdajeDimline (VectorDistance): specifies the point through which the dimension arc passes.
  • Údaje (hidden)Linked Geometry (LinkSubList): not used.
  • Údaje (hidden)Normal (Vector): specifies the normal of the plane of the dimension.
  • Údaje (hidden)Support (Link): not used.

View

Annotation

  • PohledAnnotation Style (Enumeration): specifies the annotation style applied to the dimension. See Draft AnnotationStyleEditor.
  • PohledScale Multiplier (Float): specifies the general scaling factor applied to the dimension.

Display Options

  • PohledDisplay Mode (Enumeration): specifies how the text is displayed. If it is World the text will be displayed on a plane defined by the ÚdajeNormal of the measurement. If it is Screen the text will always face the screen. This is an inherited property. The mentioned options are the renamed options (introduced in version 0.21).

Graphics

  • PohledArrow Size (Length): specifies the size of the symbols displayed at the ends of the dimension line or arc.
  • PohledArrow Type (Enumeration): specifies the type of symbol displayed at the ends of the dimension line or arc, which can be Dot, Circle, Arrow, Tick or Tick-2.
  • PohledDim Overshoot (Distance): specifies the additional length added to the dimension line. Not used for angular dimensions.
  • PohledExt Lines (Distance): specifies the length of the extension lines that go from the dimension line to the measured points. Use 0 for full extension lines. A negative value defines the gap between the ends of the extension lines and the measured points. A positive value defines the maximum length of the extension lines. Only used for linear dimensions.
  • PohledExt Overshoot (Distance): specifies the additional length of the extension lines beyond the dimension line. Not used for angular dimensions.
  • PohledFlip Arrows (Bool): specifies whether to flip the orientation of the symbols at the ends of the dimension line or arc. Only works if the symbols are arrows.
  • PohledLine Color (Color): specifies the color of the dimension line or arc, and the arrows.
  • PohledLine Width (Float): specifies the width of the lines or arc belonging to the dimension.
  • PohledShow Line (Bool): specifies whether to display the dimension line. Does not affect the display of extension lines and overshoots. Not used for angular dimensions.

Text

  • PohledFlip Text (Bool): specifies whether to flip the orientation of the text.
  • PohledFont Name (Font): specifies the font used to draw the text. It can be a font name, such as Arial, a default style such as sans, serif or mono, a family such as Arial,Helvetica,sans, or a name with a style such as Arial:Bold. If the given font is not found on the system, a default font is used instead.
  • PohledFont Size (Length): specifies the size of the letters. The text can be invisible in the 3D view if this value is very small.
  • PohledOverride (String): specifies a custom text to display instead of the actual measurement. Use the string $dim inside the text to include the measurement.
  • PohledText Color (Color): specifies the color of the text. introduced in version 0.21
  • PohledText Position (VectorDistance): specifies the position of the text in absolute coordinates. [0, 0, 0] will display the text in its default position near the dimension line or arc.
  • PohledText Spacing (Length): specifies the space between the text and the dimension line or arc.

Units

  • PohledDecimals (Integer): specifies the number of decimal places to display for the measurement.
  • PohledShow Unit (Bool): specifies whether to display the unit next to the numerical value of the measurement. Not used for angular dimensions.
  • PohledUnit Override (String): specifies the unit in which to express the measurement, for example, km, m, cm, mm, mi, ft, in or arch for arch units. Leave this blank to use the default unit. Not used for angular dimensions.

Scripting

Skriptování

Nástroj Kóta může být využit v makrech a z konzoly Pythonu použitím následující funkce:

To create a Draft Dimension use the make_dimension method (introduced in version 0.19) of the Draft module. This method replaces the deprecated makeDimension method.

dimension = make_dimension(p1, p2, p3=None, p4=None)

There are various ways to invoke this method, depending on the arguments passed to it:

dimension = make_dimension(p1, p2, p3=None)
dimension = make_dimension(object, i1, i2, p4=None)
dimension = make_dimension(object, i1, mode, p4=None)
  • Vytvoří objekt kóty s kótovací čárou procházející přes p3.
  • Objekt kóty přebíráe tloušťku čáry a barvu nastavenou v příkazovém pruhu.
  • Je několik způsobů vytvoření kóty v závislosti na předaných argumentech:
  1. (p1,p2,p3): vytvoří standardní kótu z p1 do p2.
  2. (object,i1,i2,p3): vytvoří spojenou kótu na daný objekt, která měří vzdálenost mezi vrcholy indexovanými i1 a i2.
  3. (object,i1,mode,p3): vytvoří spojenou kótu na daný objekt, i1 je index (zakřivené) měřené hrany a mód je buď "poloměr" nebo "průměr". Vrací nově vytvořený objekt.

To create an angular dimension use the following method:

dimension = make_angular_dimension(center, angles, p3, normal=None)
dimension = make_angular_dimension(center, [angle1, angle2], p3, normal=None)
  • vytvoří úhlovou kótu z daného středu se zadaným seznamem úhlů procházející bodem p3.
  • Vrací nově vytvořený objekt.

The view properties of dimension can be changed by overwriting its attributes; for example, overwrite ViewObject.FontSize with the new size in millimeters.

Příklad:

import FreeCAD as App
import Draft

doc = App.newDocument()

p1 = App.Vector(0, 0, 0)
p2 = App.Vector(1000, 1000, 0)
p3 = App.Vector(-2500, 0, 0)
dimension1 = Draft.make_dimension(p1, p2, p3)
dimension1.ViewObject.FontSize = 200

polygon = Draft.make_polygon(3, radius=1000)
doc.recompute()

p4 = App.Vector(-2000, 1500, 0)
dimension2 = Draft.make_dimension(polygon, 1, 2, p4)
dimension2.ViewObject.FontSize = 200

center = App.Vector(2000, 0, 0)
p5 = App.Vector(3000, 1000, 0)
angle1 = 45
angle2 = 10
dimension3 = Draft.make_angular_dimension(center, [angle1, angle2], p5)
dimension3.ViewObject.FontSize = 200

dimension4 = Draft.make_angular_dimension(center, [angle2, angle1], p5*1.2)
dimension4.ViewObject.FontSize = 200

doc.recompute()