Draft Dimension/es: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Updating to match new version of source page)
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
{{Docnav|[[Draft_Text|Text]]|[[Draft_BSpline|BSpline]]|[[Draft_Module|Draft]]|IconL=Draft_Text.svg |IconC=Workbench_Draft.svg|IconR=Draft_BSpline.svg }}

<div class="mw-translate-fuzzy">
{{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]]}}
{{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]]}}
</div>


<div class="mw-translate-fuzzy">
==Descripción==
==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.
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.
</div>


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.

The resulting dimension is placed in the 3D view, and is considered a Draft object. This object can be displayed on a [[TechDraw Workbench|TechDraw Workbench]] Page, using the [[TechDraw NewDraft|TechDraw NewDraft]] or [[TechDraw NewArch|TechDraw NewArch]] tools. Alternatively, TechDraw has its own tools to display dimensions, such as [[TechDraw Dimension Length|TechDraw Dimension Length]] and [[TechDraw Dimension Radius|TechDraw Dimension Radius]]; however, these tools are meant for preparing technical drawings, so they create the dimensions only in the drawing page, and not in the 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>


<div class="mw-translate-fuzzy">
==Utilización==
==Utilización==


Line 13: Line 28:
# Designa un segundo punto en la vista 3D, o escribe unas [[Draft_Coordinates/es|coordenadas]]
# Designa un segundo punto en la vista 3D, o escribe unas [[Draft_Coordinates/es|coordenadas]]
# Designa un tercer punto en la vista 3D, o escribe unas [[Draft_Coordinates/es|coordenadas]]
# Designa un tercer punto en la vista 3D, o escribe unas [[Draft_Coordinates/es|coordenadas]]
</div>


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.

The measuring points can be changed after creation by changing the start and end properties.

The position of the measurement line can also be changed after creation by changing its direction property.

<div class="mw-translate-fuzzy">
==Tipos de cotas disponibles==
==Tipos de cotas disponibles==


Line 21: Line 44:
* Cota de Radio: seleccionando un segmento curvo con la tecla {{KEY|ALT}} presionada, y pulsando después {{KEY|SHIFT}}.
* 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.
* 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.

{{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">
==Opciones==
==Opciones==


Line 34: Line 71:
* Si se selecciona un borde antes de iniciar el comando Dimensión, la dimensión creada también será '' 'paramétrica' ''.
* 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"
* La dirección de la dimensión se puede cambiar luego, modificando su propiedad "Dirección"
</div>


<div class="mw-translate-fuzzy">
==Propiedades==
==Propiedades==


* {{PropertyData|Start}}: El punto inicial de la distancia a medir
* {{PropertyData/es|Start}}: El punto inicial de la distancia a medir
* {{PropertyData|End}}: El punto final de la distancia a medir
* {{PropertyData/es|End}}: El punto final de la distancia a medir
* {{PropertyData|Dimline}}: Un punto por el cual debe pasar la línea de cota
* {{PropertyData/es|Dimline}}: Un punto por el cual debe pasar la línea de cota
* {{PropertyView|Display Mode}}: Especifica si el texto está alineado con las líneas de cota o si siempre mira hacia la cámara
* {{PropertyView/es|Display Mode}}: Especifica si el texto está alineado con las líneas de cota o si siempre mira hacia la cámara
* {{PropertyView|Font Size}}: El tamaño de las letras
* {{PropertyView/es|Font Size}}: El tamaño de las letras
* {{PropertyView|Ext Lines}}: El tamaño de las líneas de extensión (entre los puntos de medición y la línea de cota)
* {{PropertyView/es|Ext Lines}}: El tamaño de las líneas de extensión (entre los puntos de medición y la línea de cota)
* {{PropertyView|Text Position}}: Puede utilizarse para forzar que el texto se muestre en determinada posición
* {{PropertyView/es|Text Position}}: Puede utilizarse para forzar que el texto se muestre en determinada posición
* {{PropertyView|Override}}: Especifica un texto a mostrar en lugar de la medición. Utiliza la palabra "$dim", dentro del texto, para mostrar la medición
* {{PropertyView/es|Override}}: Especifica un texto a mostrar en lugar de la medición. Utiliza la palabra "$dim", dentro del texto, para mostrar la medición
* {{PropertyView|Font 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.
* {{PropertyView/es|Font 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.
* {{PropertyView | Arrow Type}}: el tipo de flecha para usar
* {{PropertyView/es|Arrow Type}}: el tipo de flecha para usar
* {{PropertyView | Arrow Size}}: el tamaño de las flechas
* {{PropertyView/es|Arrow Size}}: el tamaño de las flechas
* {{PropertyView | Decimals}}: la cantidad de lugares decimales que se mostrarán en la dimensión
* {{PropertyView/es|Decimals}}: la cantidad de lugares decimales que se mostrarán en la dimensión
* {{PropertyView | Flip Arrows}}: invierte la orientación de las flechas
* {{PropertyView/es|Flip Arrows}}: invierte la orientación de las flechas
* {{PropertyView | Unit Override}}: Expresa la distancia en la unidad dada (déjelo en blanco para usar la unidad del sistema) {{Version | 0,17}}
* {{PropertyView/es|Unit Override}}: Expresa la distancia en la unidad dada (déjelo en blanco para usar la unidad del sistema) {{Version/es|0.17}}
</div>


=== Data ===
* {{PropertyData|Start}}: specifies the start point of the distance to measure.
* {{PropertyData|End}}: specified the end point of the distance to measure.
* {{PropertyData|Dimline}}: specifies a point through which the dimension line must pass.
* {{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.

=== View ===
* {{PropertyView|Ext Lines}}: specifies the maximum length of the extension lines that go from the measurement points to the dimension line.
* {{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|Arrow Size}}: specifies the size of the symbol displayed at the ends of the dimension line.
* {{PropertyView|Arrow Type}}: specifies the type of symbol displayed at the ends of the dimension line, which can be "Dot", "Circle", "Arrow", or "Tick".
* {{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.
* {{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|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.
* {{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|Decimals}}: specifies the number of decimal places to display on the measurement.
* {{PropertyView|Show Unit}}: if it is {{TRUE}} the unit is displayed next to numerical value of the measurement.
* {{PropertyView|Unit Override}}: specifies a unit in which to express the measurement, for example, "km", "m", "cm", "mm", "mi", "ft", "in"; leave this property blank to use the default units. {{Version|0.17}}

<div class="mw-translate-fuzzy">
==Archivos de guión==
==Archivos de guión==


La herramienta cotas se puede utilizar en [[macros/es|macros]] y desde la consola de Python utilizando la siguientes funciones:
La herramienta cotas se puede utilizar en [[macros/es|macros]] y desde la consola de Python utilizando la siguientes funciones:
</div>

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 = makeDimension(p1, p2, p3=None, p4=None)}}
makeDimension (p1,p2,[p3])
There are various ways to invoke this function, depending on the arguments passed to it:
}}
or
{{Code|code=
{{Code|code=
Dimension = makeDimension(p1, p2, p3=None)
makeDimension (object,i1,i2,p3)
Dimension = makeDimension(object, i1, i2, p4=None)
Dimension = makeDimension(object, i1, mode, p4=None)
}}
}}

or
<div class="mw-translate-fuzzy">
{{Code|code=
makeDimension (objlist,indices,p3)
}}
*Crea un objeto cota con la línea de cota pasando por p3.
*Crea un objeto cota con la línea de cota pasando por p3.
* El objeto Dimension toma el [[Draft Linestyle | Draft Linewidth and Color]] establecido en la barra de comandos.
* El objeto Dimension toma el [[Draft Linestyle | Draft Linewidth and Color]] establecido en la barra de comandos.
Line 73: Line 139:
#(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,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.
#(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.
</div>

To create an angular dimension use the following function:
{{Code|code=
{{Code|code=
Dimension = makeAngularDimension(center, angles, p3, normal=None)
makeAngularDimension (center,[angle1,angle2],p3)
Dimension = makeAngularDimension(center, [angle1, angle2], p3, normal=None)
}}
}}

<div class="mw-translate-fuzzy">
crea una cota angular desde el centro indicado, con la lista dada de ángulos, pasando por p3. Devuelve el objeto recién creado.
crea una cota angular desde el centro indicado, con la lista dada de ángulos, pasando por p3. Devuelve el objeto recién creado.
</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.


Ejemplo:
Ejemplo:
{{Code|code=
{{Code|code=
import FreeCAD,Draft
import math, FreeCAD, Draft

p1 = FreeCAD.Vector(0,0,0)
p2 = FreeCAD.Vector(1,1,0)
p1 = FreeCAD.Vector(0, 0, 0)
p3 = FreeCAD.Vector(2,0,0)
p2 = FreeCAD.Vector(1000, 1000, 0)
p3 = FreeCAD.Vector(-2500, 0, 0)
Draft.makeDimension(p1,p2,p3)
Dimension1 = Draft.makeDimension(p1, p2, p3)
Dimension1.ViewObject.FontSize = 200

Polygon = Draft.makePolygon(3, radius=1000)
p4 = FreeCAD.Vector(-2000, 1500, 0)
Dimension2 = Draft.makeDimension(Polygon, 1, 2, p4)
Dimension2.ViewObject.FontSize = 200

center = FreeCAD.Vector(2000, 0, 0)
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

Dimension4 = Draft.makeAngularDimension(center, [angle2, angle1], p5*1.2)
Dimension4.ViewObject.FontSize = 200
}}
}}

<div class="mw-translate-fuzzy">
==Enlaces==
==Enlaces==


*Tutorial: [http://www.youtube.com/watch?v=nxNT0KychcY Proyección dimensiones en una página de dibujo.]
*Tutorial: [http://www.youtube.com/watch?v=nxNT0KychcY Proyección dimensiones en una página de dibujo.]
</div>


{{Docnav|[[Draft_Text|Text]]|[[Draft_BSpline|BSpline]]|[[Draft_Module|Draft]]|IconL=Draft_Text.svg |IconC=Workbench_Draft.svg|IconR=Draft_BSpline.svg }}
<languages/>

{{Draft Tools navi}}

{{Userdocnavi}}
{{clear}}

Revision as of 09:53, 14 September 2019

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

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.

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, or by the Part Fillet, Sketcher CreateFillet, and PartDesign Fillet operations.

The resulting dimension is placed in the 3D view, and is considered a Draft object. This object can be displayed on a TechDraw Workbench Page, using the TechDraw NewDraft or TechDraw NewArch tools. Alternatively, TechDraw has its own tools to display dimensions, such as TechDraw Dimension Length and TechDraw Dimension Radius; however, these tools are meant for preparing technical drawings, so they create the dimensions only in the drawing page, and not in the 3D view.

Utilización

  1. Presiona el botón cota, o presiona las teclas D y I
  2. Designa un punto en la vista 3D, o escribe unas coordenadas
  3. Designa un segundo punto en la vista 3D, o escribe unas coordenadas
  4. Designa un tercer punto en la vista 3D, o escribe unas coordenadas

The dimension can be edited by double clicking on the element in the tree view, or by pressing the Draft Edit button. Then you can move the points to a new position.

The measuring points can be changed after creation by changing the start and end properties.

The position of the measurement line can also be changed after creation by changing its direction property.

Tipos de cotas disponibles

  • Cotas lineales: seleccionando dos puntos o un segmento recto con la tecla ALT presionada.
  • Cotas Horizontales/verticales: presionando SHIFT mientras el segundo punto es seleccionado.
  • Cota de Diámetro: seleccionando un segmento curvo con la tecla ALT presionada.
  • Cota de Radio: seleccionando un segmento curvo con la tecla ALT presionada, y pulsando después SHIFT.
  • Cotas Angulares: seleccionando dos segmentos rectos con la tecla ALT presionada.
  • Linear dimensions: hold the Alt key, or click on the select edge button, and pick a straight edge, then pick a second point to draw the dimension line parallel to that edge.
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 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.
Note 1: click and hold Shift and move the pointer in different directions many times until the dimension line aligns to the desired axis. Clicking 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.
Note 2: instead of picking two points, pick an edge while holding Alt.
  • Diameter dimensions: hold the Alt key and pick a curved edge, then pick a second point to draw the dimension line.
    • Radius dimensions: hold the Alt key and pick a curved edge, then hold the Shift key and pick a second point to draw the dimension line.
  • Angular dimensions: hold the 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.
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 Lines that extend from the original edges, and measure these extensions.

Note: by pre-selecting an edge, or by picking it with Alt or select edge, the dimension will become 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.

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"

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

Data

  • DatosStart: specifies the start point of the distance to measure.
  • DatosEnd: specified the end point of the distance to measure.
  • DatosDimline: specifies a point through which the dimension line must pass.
  • DatosDistance: (read-only) indicates the measured length.
  • DatosDiameter: 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.

View

  • VistaExt Lines: specifies the maximum length of the extension lines that go from the measurement points to the dimension line.
  • VistaExt Overshoot: specifies the additional length of the extension lines beyond the dimension line.
  • VistaDim Overshoot: specifies the additional length added to the dimension line.
  • VistaArrow Size: specifies the size of the symbol displayed at the ends of the dimension line.
  • VistaArrow Type: specifies the type of symbol displayed at the ends of the dimension line, which can be "Dot", "Circle", "Arrow", or "Tick".
  • VistaFlip 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.
  • VistaFont 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.
  • VistaFont 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.
  • VistaFlip Text: specifies whether to flip the orientation of the text indicating the measurement.
  • VistaText 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.
  • VistaText Spacing: specifies the space between the text and the dimension line.
  • VistaOverride: specifies a custom text to display instead of the actual measurement. Use the string $dim inside the text to display the measurement value.
  • VistaDecimals: specifies the number of decimal places to display on the measurement.
  • VistaShow Unit: if it is true the unit is displayed next to numerical value of the measurement.
  • VistaUnit Override: specifies a unit in which to express the measurement, for example, "km", "m", "cm", "mm", "mi", "ft", "in"; leave this property blank to use the default units. introduced in version 0.17

Archivos de guión

La herramienta cotas se puede utilizar en macros y desde la consola de Python utilizando la siguientes funciones:

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

Dimension = makeDimension(p1, p2, p3=None, p4=None)

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

Dimension = makeDimension(p1, p2, p3=None)
Dimension = makeDimension(object, i1, i2, p4=None)
Dimension = makeDimension(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:
  1. (p1,p2,p3): crea una cota estándar desde p1 hasta p2.
  2. (object,i1,i2,p3): crea una cota vinculada a los objetos dados, midiendo la distancia entre sus vértices indexados i1 e i2.
  3. (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 function:

Dimension = makeAngularDimension(center, angles, p3, normal=None)
Dimension = makeAngularDimension(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 math, FreeCAD, Draft

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

Polygon = Draft.makePolygon(3, radius=1000)
p4 = FreeCAD.Vector(-2000, 1500, 0)
Dimension2 = Draft.makeDimension(Polygon, 1, 2, p4)
Dimension2.ViewObject.FontSize = 200

center = FreeCAD.Vector(2000, 0, 0)
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

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