Draft Dimension/es: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
(20 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{Docnav|[[Draft_Text|Text]]|[[Draft_BSpline|BSpline]]|[[Draft_Module|Draft]]|IconL=Draft_Text.svg |IconC=Workbench_Draft.svg|IconR=Draft_BSpline.svg }} |
|||
{{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"> |
<div class="mw-translate-fuzzy"> |
||
{{GuiCommand/es |
|||
{{GuiCommand/es|Name=Draft Dimension|Name/es=Draft Dimension|Workbenches=[[Draft Module/es|Croquis]], [[Arch Module/es|Arquitectura]]|MenuLocation=Croquis → Cotas|Shortcut=D I|SeeAlso=[[Draft FlipDimension/es|FlipDimension]]}} |
|||
|Name=Draft Dimension |
|||
|Name/es=Draft Dimension |
|||
|MenuLocation=Croquis → Cotas |
|||
|Workbenches=[[Draft_Workbench/es|Croquis]], [[Arch_Workbench/es|Arquitectura]] |
|||
|Shortcut={{KEY|D}} {{KEY|I}} |
|||
|SeeAlso=[[Draft FlipDimension/es|FlipDimension]] |
|||
}} |
|||
</div> |
</div> |
||
==Description== |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 12: | Line 29: | ||
</div> |
</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. |
|||
The tool can measure edges or lines directly attached to solid bodies; if the body changes, the dimension updates itself. The tool can also measure a diameter or radius of curvature such as those produced by a [[Draft Arc|Draft Arc]], or by the [[Part Fillet|Part Fillet]], [[Sketcher CreateFillet|Sketcher CreateFillet]], and [[PartDesign Fillet|PartDesign Fillet]] operations. |
|||
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]] |
[[Image:Screenshot_Draft_Dimension.jpg|400px]] |
||
Line 20: | Line 37: | ||
[[Image:Screenshot_Draft_Dimension.jpg|400px]] |
[[Image:Screenshot_Draft_Dimension.jpg|400px]] |
||
</div> |
</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"> |
<div class="mw-translate-fuzzy"> |
||
Line 25: | Line 48: | ||
# Presiona el botón {{KEY|[[Image:Draft Dimension.png|16px]] [[Draft Dimension/es|cota]]}}, o presiona las teclas {{KEY|D}} y {{KEY|I}} |
# Presiona el botón {{KEY|[[Image:Draft Dimension.png|16px]] [[Draft Dimension/es|cota]]}}, o presiona las teclas {{KEY|D}} y {{KEY|I}} |
||
# Designa un punto en la vista 3D, o escribe unas |
# Designa un punto en la vista 3D, o escribe unas coordenadas |
||
# Designa un segundo punto en la vista 3D, o escribe unas |
# Designa un segundo punto en la vista 3D, o escribe unas coordenadas |
||
# Designa un tercer punto en la vista 3D, o escribe unas |
# Designa un tercer punto en la vista 3D, o escribe unas coordenadas |
||
</div> |
</div> |
||
=== Usage radial dimension === |
|||
The dimension can be edited by double clicking on the element in the tree view, or by pressing the {{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit|Draft Edit]]}} button. Then you can move the points to a new position. |
|||
# Optionally select a circular edge in the [[3D_view|3D view]]. |
|||
The measuring points can be changed after creation by changing the start and end properties. |
|||
# 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}}. |
|||
# The {{MenuCommand|Dimension}} task panel opens. See [[#Options|Options]] for more information. |
|||
# If you have not yet selected an edge do one of the following: |
|||
#* 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. |
|||
# 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 === |
|||
The position of the measurement line can also be changed after creation by changing its direction property. |
|||
# There are several ways to invoke the command: |
|||
<div class="mw-translate-fuzzy"> |
|||
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button. |
|||
==Tipos de cotas disponibles== |
|||
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu. |
|||
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}. |
|||
# The {{MenuCommand|Dimension}} task panel opens. See [[#Options|Options]] for more information. |
|||
# Do one of the following: |
|||
#* 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. |
|||
#* Hold down the {{KEY|Alt}} key, select two straight edges in the [[3D_view|3D view]] and release the {{KEY|Alt}} key. |
|||
# 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 === |
|||
* Cotas lineales: seleccionando dos puntos o un segmento recto con la tecla {{KEY|ALT}} presionada. |
|||
* Cotas Horizontales/verticales: presionando {{KEY|SHIFT}} mientras el segundo punto es seleccionado. |
|||
* Cota de Diámetro: seleccionando un segmento curvo con la tecla {{KEY|ALT}} presionada. |
|||
* Cota de Radio: seleccionando un segmento curvo con la tecla {{KEY|ALT}} presionada, y pulsando después {{KEY|SHIFT}}. |
|||
* Cotas Angulares: seleccionando dos segmentos rectos con la tecla {{KEY|ALT}} presionada. |
|||
</div> |
|||
* Linear dimensions: hold the {{KEY|Alt}} key, or click on the {{Button|[[Image:view-select.svg|16px]] select edge}} button, and pick a straight edge, then pick a second point to draw the dimension line parallel to that edge. |
|||
:{{emphasis|Note:}} you can also pre-select the edge before calling the tool. |
|||
* Horizontal and vertical dimensions: pick one point, then pick a second point, then hold the {{KEY|Shift}} key and move the pointer horizontally or vertically, then pick a third point to draw the dimension line parallel to either the X axis or the Y axis. |
|||
:{{emphasis|Note 1:}} click and hold {{KEY|Shift}} and move the pointer in different directions many times until the dimension line aligns to the desired axis. Clicking {{KEY|Shift}} while the pointer is far from the first point will usually align the dimension to the X axis; if the pointer is close to the first point it will usually align the dimension to the Y axis. |
|||
:{{emphasis|Note 2:}} instead of picking two points, pick an edge while holding {{KEY|Alt}}. |
|||
* Diameter dimensions: hold the {{KEY|Alt}} key and pick a curved edge, then pick a second point to draw the dimension line. |
|||
** Radius dimensions: hold the {{KEY|Alt}} key and pick a curved edge, then hold the {{KEY|Shift}} key and pick a second point to draw the dimension line. |
|||
* Angular dimensions: hold the {{KEY|Alt}} key and then pick two straight edges, then pick a point between the two edges to show the acute or obtuse angle, or elsewhere to show a supplementary or explementary angle. |
|||
:{{Emphasis|Note:}} the displayed angle largely depends on the original position of the selected edges. If you would like to display a particular angle, you may have to add auxiliary [[Draft Line|Draft Line]]s that extend from the original edges, and measure these extensions. |
|||
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). |
|||
{{Emphasis|Note:}} by pre-selecting an edge, or by picking it with {{KEY|Alt}} or {{Button|[[Image:view-select.svg|16px]] select edge}}, the dimension will become {{emphasis|parametric}}, that is, it will remember which edge it is bound to. If the endpoints of that edge move later on, the dimension will follow them, and adjust the displayed measurement. |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 73: | Line 102: | ||
</div> |
</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"> |
<div class="mw-translate-fuzzy"> |
||
==Propiedades== |
==Propiedades== |
||
Line 92: | Line 138: | ||
</div> |
</div> |
||
See also: [[Property_editor|Property editor]]. |
|||
=== Data === |
|||
* {{PropertyData|Start}}: specifies the start point of the distance to measure. |
|||
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: |
|||
* {{PropertyData|End}}: specified the end point of the distance to measure. |
|||
* {{PropertyData|Dimline}}: specifies a point through which the dimension line must pass. |
|||
=== Data linear and radial dimension === |
|||
* {{PropertyData|Distance}}: (read-only) indicates the measured length. |
|||
* {{PropertyData|Diameter}}: if it is {{TRUE}} it displays a diameter dimension; otherwise it displays a radius dimension; this property only works if the dimension is attached to a circular arc. |
|||
{{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 === |
=== View === |
||
* {{PropertyView|Ext Lines}}: specifies the maximum length of the extension lines that go from the measurement points to the dimension line. |
|||
{{TitleProperty|Annotation}} |
|||
* {{PropertyView|Ext Overshoot}}: specifies the additional length of the extension lines beyond the dimension line. |
|||
* {{PropertyView|Dim Overshoot}}: specifies the additional length added to the dimension line. |
|||
* {{PropertyView| |
* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the dimension. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]]. |
||
* {{PropertyView| |
* {{PropertyView|Scale Multiplier|Float}}: specifies the general scaling factor applied to the dimension. |
||
* {{PropertyView|Flip Arrows}}: specifies whether to flip the orientation of the symbols at the ends of the dimension line; it only works if these symbols are arrows. |
|||
{{TitleProperty|Display Options}} |
|||
* {{PropertyView|Font Name}}: specifies 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", 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. |
|||
* {{PropertyView|Font Size}}: specifies the size of the letters. If the dimension object is created in the tree view but no text is visible, increase the size of the text until it is visible. |
|||
* {{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}}). |
|||
* {{PropertyView|Flip Text}}: specifies whether to flip the orientation of the text indicating the measurement. |
|||
* {{PropertyView|Text Position}}: specifies the position of the text in absolute coordinates, referred to the origin (0,0,0); leave this property at its default value (0,0,0) to display the text next to the dimension line. |
|||
{{TitleProperty|Graphics}} |
|||
* {{PropertyView|Text Spacing}}: specifies the space between the text and the dimension line. |
|||
* {{PropertyView|Override}}: specifies a custom text to display instead of the actual measurement. Use the string {{incode|$dim}} inside the text to display the measurement value. |
|||
* {{PropertyView| |
* {{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|Show Unit}}: if it is {{TRUE}} the unit is displayed next to numerical value of the measurement. |
|||
* {{PropertyView| |
* {{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== |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 122: | Line 225: | ||
</div> |
</div> |
||
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. |
|||
The Dimension tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function: |
|||
{{Code|code= |
{{Code|code= |
||
dimension = make_dimension(p1, p2, p3=None, p4=None)}} |
|||
There are various ways to invoke this function, depending on the arguments passed to it: |
|||
There are various ways to invoke this method, depending on the arguments passed to it: |
|||
{{Code|code= |
{{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) |
|||
}} |
}} |
||
Line 141: | Line 247: | ||
</div> |
</div> |
||
To create an angular dimension use the following |
To create an angular dimension use the following method: |
||
{{Code|code= |
{{Code|code= |
||
dimension = make_angular_dimension(center, angles, p3, normal=None) |
|||
dimension = make_angular_dimension(center, [angle1, angle2], p3, normal=None) |
|||
}} |
}} |
||
Line 151: | Line 258: | ||
</div> |
</div> |
||
The view properties of {{incode| |
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. |
||
Ejemplo: |
Ejemplo: |
||
{{Code|code= |
{{Code|code= |
||
import |
import FreeCAD as App |
||
import Draft |
|||
doc = App.newDocument() |
|||
p1 = FreeCAD.Vector(0, 0, 0) |
|||
p2 = FreeCAD.Vector(1000, 1000, 0) |
|||
p3 = FreeCAD.Vector(-2500, 0, 0) |
|||
Dimension1 = Draft.makeDimension(p1, p2, p3) |
|||
Dimension1.ViewObject.FontSize = 200 |
|||
p1 = App.Vector(0, 0, 0) |
|||
Polygon = Draft.makePolygon(3, radius=1000) |
|||
p2 = App.Vector(1000, 1000, 0) |
|||
p3 = App.Vector(-2500, 0, 0) |
|||
Dimension2 = Draft.makeDimension(Polygon, 1, 2, p4) |
|||
dimension1 = Draft.make_dimension(p1, p2, p3) |
|||
Dimension2.ViewObject.FontSize = 200 |
|||
dimension1.ViewObject.FontSize = 200 |
|||
polygon = Draft.make_polygon(3, radius=1000) |
|||
center = FreeCAD.Vector(2000, 0, 0) |
|||
doc.recompute() |
|||
p5 = FreeCAD.Vector(3000, 1000, 0) |
|||
angle1 = math.radians(45) |
|||
angle2 = math.radians(10) |
|||
Dimension3 = Draft.makeAngularDimension(center, [angle1, angle2], p5) |
|||
Dimension3.ViewObject.FontSize = 200 |
|||
p4 = App.Vector(-2000, 1500, 0) |
|||
Dimension4 = Draft.makeAngularDimension(center, [angle2, angle1], p5*1.2) |
|||
dimension2 = Draft.make_dimension(polygon, 1, 2, p4) |
|||
Dimension4.ViewObject.FontSize = 200 |
|||
dimension2.ViewObject.FontSize = 200 |
|||
}} |
|||
center = App.Vector(2000, 0, 0) |
|||
<div class="mw-translate-fuzzy"> |
|||
p5 = App.Vector(3000, 1000, 0) |
|||
==Enlaces== |
|||
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) |
|||
*Tutorial: [http://www.youtube.com/watch?v=nxNT0KychcY Proyección dimensiones en una página de dibujo.] |
|||
dimension4.ViewObject.FontSize = 200 |
|||
</div> |
|||
doc.recompute() |
|||
{{Docnav|[[Draft_Text|Text]]|[[Draft_BSpline|BSpline]]|[[Draft_Module|Draft]]|IconL=Draft_Text.svg |IconC=Workbench_Draft.svg|IconR=Draft_BSpline.svg }} |
|||
}} |
|||
{{Draft Tools navi}} |
|||
{{Docnav |
|||
{{Userdocnavi}} |
|||
|[[Draft_Text|Text]] |
|||
{{clear}} |
|||
|[[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 04:56, 9 January 2024
Draft Dimension |
Ubicación en el Menú |
---|
Croquis → Cotas |
Entornos de trabajo |
Croquis, Arquitectura |
Atajo de teclado por defecto |
D I |
Introducido en versión |
- |
Ver también |
FlipDimension |
Description
Descripción
La herramienta cotas crea una cota en el documento actual con dos puntos definiendo la distancia a medir, y un tercer punto especificando por donde pasa la línea de cota.
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
Utilización
- Presiona el botón cota, o presiona las teclas D y I
- Designa un punto en la vista 3D, o escribe unas coordenadas
- Designa un segundo punto en la vista 3D, o escribe unas coordenadas
- Designa un tercer punto en la vista 3D, o escribe unas coordenadas
Usage radial dimension
- Optionally select a circular edge in the 3D view.
- 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.
- The Dimension task panel opens. See Options for more information.
- If you have not yet selected an edge do one of the following:
- To position the dimension line do one of the following:
Usage angular dimension
- 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.
- The Dimension task panel opens. See Options for more information.
- Do one of the following:
- To position the dimension arc pick a point in the 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. The shortcuts mentioned here are the default shortcuts (for version 0.22).
Opciones
- Presiona X, Y o Z después de un punto para restringir el punto siguiente sobre el eje indicado.
- Para introducir coordenadas manualmente, simplemente introduce los números y presiona ENTER entre cada componente X, Y y Z.
- Presiona CTRL mientras dibujas para forzar el ajuste de tu punto a la ubicación de ajuste más cercana, independientemente de la distancia.
- Presionando SHIFT se realizará una restricción de la cota horizontal o verticalmente, o, cuando se trabaja con un segmento circular, conmuta entre los modos de radio y diámetro.
- Presiona R o selecciona la casilla para activar/desactivar el botón Relativas. Si el modo relativas está activada, las coordenadas del siguiente punto son relativas al anterior. Si no, son absolutas, tomadas desde el origen de coordenadas (0,0,0).
- Presiona T o selecciona la casilla para activar/desactivar el botón Continuar. Si el modo continuar está activado, podrás dibujar cotas continuas, una tras otra, que comparten la misma línea base.
- Presiona ESC o el botón Cancelar para abortar el comando actual.
- Seleccionando una arista existente con ALT, en lugar de introducir puntos de medición, la cota se convertirá en paramétrica y recordará a que arista está vinculada. Si los puntos finales de la arista se mueven posteriormente, la cota los seguirá.
- Si se selecciona un borde antes de iniciar el comando Dimensión, la dimensión creada también será 'paramétrica' .
- La dirección de la dimensión se puede cambiar luego, modificando su propiedad "Dirección"
Convert
Usage
- Select one or more Std MeasureDistance objects.
- 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.
- 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.
Propiedades
- DATOSStart: El punto inicial de la distancia a medir
- DATOSEnd: El punto final de la distancia a medir
- DATOSDimline: Un punto por el cual debe pasar la línea de cota
- VISTADisplay Mode: Especifica si el texto está alineado con las líneas de cota o si siempre mira hacia la cámara
- VISTAFont Size: El tamaño de las letras
- VISTAExt Lines: El tamaño de las líneas de extensión (entre los puntos de medición y la línea de cota)
- VISTAText Position: Puede utilizarse para forzar que el texto se muestre en determinada posición
- VISTAOverride: Especifica un texto a mostrar en lugar de la medición. Utiliza la palabra "$dim", dentro del texto, para mostrar la medición
- VISTAFont Name: La fuente a utilizar para dibujar el texto. Puede ser un nombre de fuente, como "Arial", un estilo por defecto como "sans", "serif" o "mono", o una familia como "Arial,Helvetica,sans" o un nombre con un estilo como "Arial:Bold". Si la fuente indicada no se encuentra en el sistema, se utilizará una genérica en su lugar.
- VISTAArrow Type: el tipo de flecha para usar
- VISTAArrow Size: el tamaño de las flechas
- VISTADecimals: la cantidad de lugares decimales que se mostrarán en la dimensión
- VISTAFlip Arrows: invierte la orientación de las flechas
- VISTAUnit Override: Expresa la distancia en la unidad dada (déjelo en blanco para usar la unidad del sistema) introducido en la versión 0.17
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
- DatosDimline (
VectorDistance
): specifies the point through which the dimension line passes. - DatosLinked Geometry (
LinkSubList
): specifies the object and its subelement(s) the dimension is linked to. - DatosNormal (
Vector
): specifies the normal of the plane of the text. - Datos (hidden)Support (
Link
): specifies the measured object.
Linear/radial dimension
- DatosDirection (
Vector
): specifies the direction of the measurement. - DatosDistance (
Length
): (read-only) specifies the value of the measurement. - DatosEnd (
VectorDistance
): specifies the end point of the measurement. - DatosStart (
VectorDistance
): specifies the start point of the measurement.
Radial dimension
- DatosDiameter (
Bool
): specifies if a radial dimension is displayed as a diameter dimension. Not used for linear dimensions.
Data angular dimension
Angular dimension
- DatosAngle (
Angle
): (read-only) specifies the value of the measurement. - DatosCenter (
VectorDistance
): specifies the center of the measurement. - DatosFirst Angle (
Angle
): specifies the start angle of the measurement. - DatosLast Angle (
Angle
): specifies the end angle of the measurement.
Dimension
- DatosDimline (
VectorDistance
): specifies the point through which the dimension arc passes. - Datos (hidden)Linked Geometry (
LinkSubList
): not used. - Datos (hidden)Normal (
Vector
): specifies the normal of the plane of the dimension. - Datos (hidden)Support (
Link
): not used.
View
Annotation
- VistaAnnotation Style (
Enumeration
): specifies the annotation style applied to the dimension. See Draft AnnotationStyleEditor. - VistaScale Multiplier (
Float
): specifies the general scaling factor applied to the dimension.
Display Options
- VistaDisplay Mode (
Enumeration
): specifies how the text is displayed. If it isWorld
the text will be displayed on a plane defined by the DatosNormal of the measurement. If it isScreen
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
- VistaArrow Size (
Length
): specifies the size of the symbols displayed at the ends of the dimension line or arc. - VistaArrow Type (
Enumeration
): specifies the type of symbol displayed at the ends of the dimension line or arc, which can beDot
,Circle
,Arrow
,Tick
orTick-2
. - VistaDim Overshoot (
Distance
): specifies the additional length added to the dimension line. Not used for angular dimensions. - VistaExt Lines (
Distance
): specifies the length of the extension lines that go from the dimension line to the measured points. Use0
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. - VistaExt Overshoot (
Distance
): specifies the additional length of the extension lines beyond the dimension line. Not used for angular dimensions. - VistaFlip 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. - VistaLine Color (
Color
): specifies the color of the dimension line or arc, and the arrows. - VistaLine Width (
Float
): specifies the width of the lines or arc belonging to the dimension. - VistaShow 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
- VistaFlip Text (
Bool
): specifies whether to flip the orientation of the text. - VistaFont Name (
Font
): specifies the font used to draw the text. It can be a font name, such asArial
, a default style such assans
,serif
ormono
, a family such asArial,Helvetica,sans
, or a name with a style such asArial:Bold
. If the given font is not found on the system, a default font is used instead. - VistaFont Size (
Length
): specifies the size of the letters. The text can be invisible in the 3D view if this value is very small. - VistaOverride (
String
): specifies a custom text to display instead of the actual measurement. Use the string$dim
inside the text to include the measurement. - VistaText Color (
Color
): specifies the color of the text. introduced in version 0.21 - VistaText 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. - VistaText Spacing (
Length
): specifies the space between the text and the dimension line or arc.
Units
- VistaDecimals (
Integer
): specifies the number of decimal places to display for the measurement. - VistaShow Unit (
Bool
): specifies whether to display the unit next to the numerical value of the measurement. Not used for angular dimensions. - VistaUnit Override (
String
): specifies the unit in which to express the measurement, for example,km
,m
,cm
,mm
,mi
,ft
,in
orarch
for arch units. Leave this blank to use the default unit. Not used for angular dimensions.
Scripting
Archivos de guión
La herramienta cotas se puede utilizar en macros y desde la consola de Python utilizando la siguientes funciones:
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)
- Crea un objeto cota con la línea de cota pasando por p3.
- El objeto Dimension toma el Draft Linewidth and Color establecido en la barra de comandos.
- Existen varias formas de crear una cota, dependiendo de los argumentos que les pases:
- (p1,p2,p3): crea una cota estándar desde p1 hasta p2.
- (object,i1,i2,p3): crea una cota vinculada a los objetos dados, midiendo la distancia entre sus vértices indexados i1 e i2.
- (object,i1,mode,p3): crea una cota vinculada al objeto actual, i1 es el índice de la arista (curvada) a medir, y mode es tanto el "radio" como el "diámetro". Devuelve el objeto recién creado.
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)
crea una cota angular desde el centro indicado, con la lista dada de ángulos, pasando por p3. Devuelve el objeto recién creado.
The view properties of dimension
can be changed by overwriting its attributes; for example, overwrite ViewObject.FontSize
with the new size in millimeters.
Ejemplo:
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()
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- 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