Draft Dimension/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(220 intermediate revisions by 5 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/fr
|[[Draft_Text/fr|Texte]]
|[[Draft_Label/fr|Étiquette]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Text.svg
|IconR=Draft_Label.svg
|IconC=Workbench_Draft.svg
}}


{{GuiCommand
{{GuiCommand
|Name=Draft Dimension
|Name=Draft Dimension
|Name/fr=Dimension
|Name/fr=Draft Dimension
|MenuLocation=Draft → Dimension
|MenuLocation=Annotation → Dimension
|Workbenches=[[Draft_Module/fr|Draft]], [[Arch_Module/fr|Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Shortcut=D I
|Shortcut={{KEY|D}} {{KEY|I}}
|SeeAlso=[[Draft_FlipDimension/fr|FlipDimension]], [[TechDraw_Workbench/fr|Atelier TechDraw]]
|Version=0.8
|Version=0.8
|SeeAlso=[[Draft_FlipDimension/fr|Draft Inverser le texte de la dimension]]
}}
}}


==Description====
==Description==
L'outil Dimension crée un objet qui mesure et affiche la distance entre deux points ; un troisième point spécifie la position de la ligne de dimension.


La commande [[Image:Draft_Dimension.svg|24px]] '''Draft Dimension''' [[#Create|crée]] une [[#Utilisation_pour_une_dimension_lin.C3.A9aire|dimension linéaire]], une [[#Utilisation_pour_une_dimension_radiale|dimension radiale]] ou une [[#Utilisation_pour_une_dimension_angulaire|dimension angulaire]]. La commande peut également être utilisée pour [[#Convertir|convertir]] des objets [[Std_MeasureDistance/fr|Std Mesurer une distance]].
L'outil peut mesurer des arêtes ou des lignes directement attachées à des corps solides ; si le corps change, la dimension se met à jour. L'outil peut également mesurer un diamètre ou un rayon de courbure tels que ceux produits par les opérations [[Draft_Arc/fr|Draft Arc]], ou par les opérations [[Part_Fillet/fr|Part Congés]], [[Sketcher_CreateFillet/fr|Sketcher_Congés]], et [[PartDesign_Fillet/fr|Part Design Congés]].


Les dimensions linéaires basées sur les arêtes et les dimensions radiales sont paramétriques. Cela signifie qu'elles seront mises à jour si l'arête mesurée est modifiée. Les arêtes mesurées peuvent appartenir à des ébauches d'objets mais aussi à des corps solides. Les dimensions angulaires ne sont pas paramétriques.
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.

Les Draft Dimensions peuvent être affichées sur une page de l'[[TechDraw_Workbench/fr|atelier Techdraw]] à l'aide des commandes [[TechDraw_DraftView/fr|TechDraw Vue d'un objet Draft]] ou [[TechDraw_ArchView/fr|TechDraw Vue d'un objet Arch]]. L'[[TechDraw_Workbench/fr|atelier Techdraw]] propose également ses propres commandes de cotation. Mais celles-ci créent des dimensions qui ne sont affichées que sur la page de dessin et non dans la [[3D_view/fr|vue 3D]].


[[Image:Screenshot_Draft_Dimension.jpg|400px]]
[[Image:Screenshot_Draft_Dimension.jpg|400px]]
{{Caption|Dimension linéaire définie par trois points}}
<div class="mw-translate-fuzzy">
[[Image:Screenshot_Draft_Dimension.jpg|400px]]
</div>


<span id="Create"></span>
<div class="mw-translate-fuzzy">
==Utilisation==
==Créer==


Voir aussi : [[Draft_Tray/fr|Draft La barre]], [[Draft_Snap/fr|Draft Aimantation]] et [[Draft_Constrain/fr|Draft Contrainte]].
*Cliquez sur l'outil {{KEY|[[Image:Draft Dimension.png|24px]] [[Draft Dimension/fr|cotation]]}} ou pressez les touches {{KEY|D}} et {{KEY|I}}
*Cliquez un premier point sur une zone vide de la vue 3D, ou tapez une [[Draft_Coordinates/fr|coordonnée]]
*Cliquez un point sur une zone vide de la vue 3D, ou tapez une [[Draft_Coordinates/fr|coordonnée]]
*Cliquez un troisième point sur une zone vide de la vue 3D, ou tapez une [[Draft_Coordinates/fr|coordonnée]]
</div>


<span id="Usage_linear_dimension"></span>
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]]}} button. Then you can move the points to a new position.
=== Utilisation pour une dimension linéaire ===


# Sélectionnez une arête droite dans la [[3D_view/fr|vue 3D]].
The measuring points can be changed after creation by changing the start and end properties.
# Il existe plusieurs façons de lancer la commande :
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
#* Utilisez les raccourcis clavier : {{KEY|D}} puis {{KEY|I}}.
# Le panneau de tâches {{MenuCommand|Dimension}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Si vous n'avez pas encore sélectionné d'arête, effectuez l'une des opérations suivantes :
#* Appuyez sur {{KEY|E}} ou sur le bouton {{Button|[[Image:view-select.svg|16px]] Sélectionnez une arête}} et sélectionnez une arête droite dans la [[3D_view/fr|vue 3D]].
#* Maintenez la touche {{KEY|Alt}} enfoncée, sélectionnez une arête droite dans la [[3D_view/fr|vue 3D]] et relâchez la touche {{KEY|Alt}}.
#* Définissez la distance mesurée en choisissant des points :
#** Choisissez un premier point dans la [[3D_view/fr|vue 3D]] ou rentrez des coordonnées et appuyez sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}}.
#** Choisissez un deuxième point dans la [[3D_view/fr|vue 3D]] ou rentrez des coordonnées et appuyez sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}}.
# Pour positionner la ligne de la dimension, effectuez l'une des opérations suivantes :
#* Pour une dimension alignée :
#** Choisissez un point dans la [[3D_view/fr|vue 3D]] ou rentrez des coordonnées et appuyez sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}}.
#* Pour une dimension horizontale :
#** Déplacez le pointeur au-dessus ou au-dessous de l'arête ou des points.
#** Maintenez la touche {{KEY|Maj}} enfoncée, déplacez le pointeur et choisissez un point dans la [[3D_view/fr|vue 3D]].
#* Pour une dimension verticale :
#** Déplacez le pointeur à gauche ou à droite de l'arête ou des points.
#** Maintenez la touche {{KEY|Maj}} enfoncée, déplacez le pointeur et choisissez un point dans la [[3D_view/fr|vue 3D]].


<span id="Usage_radial_dimension"></span>
The position of the measurement line can also be changed after creation by changing its direction property.
=== Utilisation pour une dimension radiale ===


# Sélectionnez éventuellement une arête circulaire dans la [[3D_view/fr|vue 3D]].
<div class="mw-translate-fuzzy">
# Il existe plusieurs façons de lancer la commande :
==Types de cotations disponibles==
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
# Le panneau de tâches {{MenuCommand|Dimension}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Si vous n'avez pas encore sélectionné d'arête, effectuez l'une des opérations suivantes :
#* Appuyez sur {{KEY|E}} ou sur le bouton {{Button|[[Image:view-select.svg|16px]] Sélectionnez une arête}} et sélectionnez une arête circulaire dans la [[3D_view/fr|vue 3D]].
#* Maintenez la touche {{KEY|Alt}} enfoncée, sélectionnez une arête circulaire dans la [[3D_view/fr|vue 3D]] et relâchez la touche {{KEY|Alt}}.
# Pour positionner la ligne de la dimension, effectuez l'une des opérations suivantes :
#* Pour une dimension de diamètre :
#** Choisissez un point dans la [[3D_view/fr|vue 3D]] ou rentrez des coordonnées et appuyez sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}}.
#* Pour une dimension radiale :
#** Maintenez la touche {{KEY|Shift}} et choisissez un point dans la [[3D_view/fr|vue 3D]].


<span id="Usage_angular_dimension"></span>
* '''Cotation linéaire''' : cliquez deux points ou sur une ligne en pressant la touche {{KEY|ALT}} pour forcer une contrainte
=== Utilisation pour une dimension angulaire ===
* '''Cotation horizontale/verticale''' : pressez la touche {{KEY|SHIFT}} jusqu'a ce que le second point soit sélectionné.
* '''Cotation d'un diamètre''' : pressez sur la touche {{KEY|ALT}}, puis sélectionnez une ligne courbe.
* '''Cotation d'un rayon''' : pressez sur la touche {{KEY|ALT}}, sélectionnez une ligne courbe, puis relâchez la touche {{KEY|ALT}} et appuyez sur la touche {{KEY|SHIFT}}.
* '''Cotation angulaire''' : en choisissant '''2''' lignes (arêtes) droites avec la touche {{KEY|ALT}} pressée.
</div>


# Il existe plusieurs façons de lancer la commande :
* 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.
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
:{{emphasis|Note:}} you can also pre-select the edge before calling the tool.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
* 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.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
:{{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.
# Le panneau de tâches {{MenuCommand|Dimension}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
:{{emphasis|Note 2:}} instead of picking two points, pick an edge while holding {{KEY|Alt}}.
# Faites l'une des choses suivantes :
* Diameter dimensions: hold the {{KEY|Alt}} key and pick a curved edge, then pick a second point to draw the dimension line.
#* Appuyez sur {{KEY|E}} ou sur le bouton {{Button|[[Image:view-select.svg|16px]] Sélectionnez une arête}} et sélectionnez une première arête droite dans la [[3D_view/fr|vue 3D]]. Répétez cette opération pour sélectionner une deuxième arête droite.
** 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.
#* Maintenez la touche {{KEY|Alt}} enfoncée, sélectionnez deux arêtes droites dans la [[3D_view/fr|vue 3D]] et relâchez la touche {{KEY|Alt}}.
* 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.
# Pour positionner l'arc de la dimension, sélectionnez un point dans la [[3D_view/fr|vue 3D]].
:{{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]]s that extend from the original edges, and measure these extensions.
# L'angle affiché dépend des bords et du point choisi.


=== Options ===
{{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.


Les raccourcis clavier à caractère unique disponibles dans le panneau des tâches peuvent être modifiés. Voir [[Draft_Preferences/fr|Draft Préférences]]. Les raccourcis mentionnés ici sont les raccourcis par défaut. (pour la version 0.22).
<div class="mw-translate-fuzzy">
==Options==


* Pour saisir manuellement des coordonnées, entrez les valeurs X, Y et Z et appuyez sur {{KEY|Entrée}} après chacune. Ou vous pouvez appuyer sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}} lorsque vous avez les valeurs souhaitées. Il est conseillé de déplacer le pointeur hors de la [[3D_view/fr|vue 3D]] avant de saisir les coordonnées.
* Pressez les touches {{KEY|X}}, {{KEY|Y}} ou {{KEY|Z}} après un point, pour [Draft_Constrain/fr|contraindre] le prochain point, sur l'axe donné.
* Appuyez sur {{KEY|R}} ou cliquez sur la case {{MenuCommand|Relative}} pour activer le mode relatif. Si le mode relatif est activé, les coordonnées sont relatives au dernier point, si disponible, sinon elles sont relatives à l'origine du système de coordonnées.
* Vous pouvez simplement entrer les coordonnées manuellement, en entrant les nombres, puis tapez {{KEY|ENTRÉE}} à chaque composants '''X, Y''' et '''Z'''.
* Appuyez sur {{KEY|G}} ou cliquez sur la case {{MenuCommand|Global}} pour activer le mode global. Si le mode global est activé, les coordonnées sont relatives au système de coordonnées global, sinon elles sont relatives au système de coordonnées du [[Draft_SelectPlane/fr|plan de travail]]. {{Version/fr|0.20}}
* Pressez sur la touche {{KEY|CTRL}} pendant le dessin, force l'[[Draft_Snap/fr|accrochage]], de votre point à l'emplacement le plus proche, du composant logiciel enfichable, indépendamment de la distance.
* Appuyez sur {{KEY|N}} ou cliquez sur la case {{MenuCommand|Continue}} pour activer le mode continu. Ce mode ne fonctionne que pour les dimensions linéaires. Si le mode continu est activé, la commande redémarre après avoir terminé, ce qui vous permet de continuer à créer des dimensions. Toutes les dimensions suivantes commenceront à partir du point final de la dimension précédente, et utiliseront la même ligne de base que la première dimension. Notez que la sélection des bords n'est pas possible pour les dimensions suivantes.
* Après avoir cliqué votre premier point, donnez une direction horizontale ou verticale à votre ligne, puis, pressez sur la touche {{KEY|SHIFT}}, et votre ligne sera [[Draft_Constrain/fr|contrainte]] horizontalement ou verticalement,
* Appuyez sur {{KEY|S}} pour activer ou désactiver [[Draft_Snap/fr|Draft aimantation]].
ou, quand vous travaillez sur un bord circulaire, bascule entre les modes '''diamètre''' et '''rayon'''.
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour terminer la commande.
* Pressez la touche {{KEY|R}}, ou activez/désactivez la case à cocher {{KEY|'''Relatif'''}}. Si {{KEY|'''Relatif'''}} est activé, les coordonnées du point suivant, sont '''relatives''' au premier point. Si elle n'est pas cochée, les coordonnées sont '''absolues''', et, commencent à partir du point d'origine ('''0,0,0''').
* Pressez la touche {{KEY|T}}, ou activez/désactivez la case à cocher {{KEY|'''Continue'''}}. Si la case à cocher {{KEY|'''Continue'''}} est activée, et, que vous avez terminé votre cotation, la fonction redémarre automatiquement, vous permettant, de tirer une autre cotation sans devoir appuyer sur le bouton.
* Appuyez sur {{KEY|ESC}} pour {{KEY|annuler}} l'opération.La cotation nouvellement créée adopte le style de ligne actif.
* En cliquant, sur une arête existante avec la touche {{KEY|ALT}}, au lieu d'entrer un point de mesure, la cotation deviendra '''paramétrique''' et sera liée aux bords. Si les points de terminaison de ces arêtes se déplacent par la suite, la cotation les suivra.
* La direction de la dimension peut être modifiée plus tard en modifiant la "Direction" dans les propriétés
</div>


<span id="Convert"></span>
<div class="mw-translate-fuzzy">
== Convertir ==

<span id="Usage"></span>
===Utilisation===

# Sélectionnez un ou plusieurs objets [[Std_MeasureDistance/fr|Std Mesurer une distance]].
# Il existe plusieurs façons de lancer la commande :
#* Appuyez sur le {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
# Chaque objet sélectionné est remplacé par une Draft Dimension linéaire non paramétrique.

<span id="Notes"></span>
==Remarques==

* Les Draft Dimensions linéaires et radiales peuvent être modifiées avec la commande [[Draft_Edit/fr|Draft Éditer]].
* Les Draft Dimensions créées ou enregistrées avec la [[Release_notes_0.21/fr|version 0.21 de FreeCAD]] ne sont pas rétrocompatibles.

<span id="Properties"></span>
==Propriétés==
==Propriétés==
* {{PropertyData/fr|Start}}: Le point de départ de la cote
* {{PropertyData/fr|End}}: Le point final de la cote
* {{PropertyData/fr|Dimline}}: Le point donnant la valeur de la dimension de la ligne de cote
* {{PropertyData/fr|Display Mode}}: Spécifie si le texte de la cotation est aligné à la cote ou toujours face à la vue
* {{PropertyView/fr|Font Size}}: La hauteur des lettres
* {{PropertyView/fr|Ext Lines}}: La dimension de l'extension de la ligne (entre les points de mesure et la ligne de cote)
* {{PropertyView/fr|Text Position}}: Est utilisé pour forcer l’affichage du texte à une certain position sur la ligne de cote
* {{PropertyView/fr|Text Spacing}}: Spécifie l'espace entre le texte et la ligne
* {{PropertyView/fr|Override}}: Spécifie le texte a afficher à la place de la valeur de la dimension. Utilisez le mot "$dim", devant le texte pour afficher la nouvelle cote
* {{PropertyView/fr|Font Name}}: La police de texte à utiliser. La police par défaut est "Arial", de style "sans", "serif" ou "mono", ou de la même famille que "Arial,Helvetica,sans" ou un nom du style "Arial:Bold". Si aucune police n'est trouvée sur le système une police générique est utilisée à la place.
* {{PropertyView/fr|Arrow Type}}: Le type de flèches utilisées
* {{PropertyView/fr|Arrow Size}}: La dimension de la flèche
* {{PropertyView/fr|Decimals}}: Le nombre de décimales a utiliser pour la cote
* {{PropertyView/fr|Flip Arrows}}: Inverse l'orientation des flèches
</div>


Voir aussi : [[Property_editor/fr|Éditeur de propriétés]]
=== 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.


Un objet Draft Dimension est dérivé d'un objet [[App_FeaturePython/fr|App FeaturePython]] et hérite de toutes ses propriétés. Les propriétés suivantes sont supplémentaires, sauf indication contraire :
=== 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}}


<span id="Data_linear_and_radial_dimension"></span>
<div class="mw-translate-fuzzy">
=== Données dimension linéaire et radiale ===

{{TitleProperty|Dimension}}

* {{PropertyData|Dimline|VectorDistance}} : spécifie le point par lequel passe la ligne de dimension.
* {{PropertyData|Linked Geometry|LinkSubList}} : spécifie l'objet et son sous-élément, ou ses sous-éléments, auxquels la dimension est liée.
* {{PropertyData|Normal|Vector}} : spécifie la normale du plan du texte.
* {{PropertyData|Support|Link|hidden}} : spécifie l'objet mesuré.

{{TitleProperty|Linear/radial dimension}}

* {{PropertyData|Direction|Vector}} : spécifie la direction de la mesure.
* {{PropertyData|Distance|Length}} : (en lecture seule) spécifie la valeur de la mesure.
* {{PropertyData|End|VectorDistance}} : spécifie le dernier point de la mesure.
* {{PropertyData|Start|VectorDistance}} : spécifie le point de départ de la mesure.

{{TitleProperty|Radial dimension}}

* {{PropertyData|Diameter|Bool}} : spécifie si une dimension radiale est affichée comme une dimension de diamètre.

<span id="Data_angular_dimension"></span>
=== Données dimension angulaire ===

{{TitleProperty|Angular dimension}}

* {{PropertyData|Angle|Angle}} : (en lecture seule) spécifie la valeur de la mesure.
* {{PropertyData|Center|VectorDistance}} : spécifie le centre de la mesure.
* {{PropertyData|First Angle|Angle}} : spécifie le début de l'angle de la mesure.
* {{PropertyData|Last Angle|Angle}} : spécifie la fin de l'angle de la mesure.

{{TitleProperty|Dimension}}

* {{PropertyData|Dimline|VectorDistance}} : spécifie le point par lequel passe l'arc de dimension.
* {{PropertyData|Linked Geometry|LinkSubList|hidden}} : non utilisé.
* {{PropertyData|Normal|Vecteur|hidden}} : spécifie la normale du plan de la dimension.
* {{PropertyData|Support|Link|hidden}} : non utilisé.

<span id="View"></span>
=== Vue ===

{{TitleProperty|Annotation}}

* {{PropertyView|Annotation Style|Enumeration}} : spécifie le style d'annotation appliqué à la dimension. Voir [[Draft_AnnotationStyleEditor/fr|Draft Éditeur styles d'annotations]].
* {{PropertyView|Scale Multiplier|Float}} : spécifie le facteur d'échelle général appliqué à la dimension.

{{TitleProperty|Display Options}}

* {{PropertyView|Display Mode|Enumeration}} : spécifie comment le texte est affiché. S'il s'agit de {{value|World}}, le texte sera affiché sur un plan défini par la {{PropertyData|Normal}} de la mesure. S'il s'agit de {{value|Screen}}, le texte sera toujours tourné vers l'écran. Il s'agit d'une propriété héritée. Les options mentionnées sont les options renommées ({{Version/fr|0.21}}).

{{TitleProperty|Graphics}}

* {{PropertyView|Arrow Size|Length}} : spécifie la taille des symboles affichés aux extrémités de la ligne ou de l'arc de dimension.
* {{PropertyView|Arrow Type|Enumeration}} : spécifie le type de symbole affiché aux extrémités de la ligne ou de l'arc de la dimension, qui peut être {{value|Dot}}, {{value|Circle}}, {{value|Arrow}}, {{value|Tick}} ou {{value|Tick-2}}.
* {{PropertyView|Dim Overshoot|Distance}} : spécifie la longueur supplémentaire ajoutée à la ligne de la dimension. Non utilisé pour les dimensions angulaires.
* {{PropertyView|Ext Lines|Distance}} : spécifie la longueur des lignes d'extension qui vont de la ligne de la dimension aux points mesurés. Utilisez {{Value|0}} pour des lignes d'extension complètes. Une valeur négative définit l'écart entre les extrémités des lignes d'extension et les points mesurés. Une valeur positive définit la longueur maximale des lignes d'extension. Utilisé uniquement pour les dimensions linéaires.
* {{PropertyView|Ext Overshoot|Distance}} : spécifie la longueur supplémentaire des lignes d'extension au-delà de la ligne de la dimension. Non utilisé pour les dimensions angulaires.
* {{PropertyView|Flip Arrows|Bool}} : indique s'il faut inverser l'orientation des symboles aux extrémités de la ligne ou de l'arc de la dimension. Ne fonctionne que si les symboles sont des flèches.
* {{PropertyView|Line Color|Color}} : spécifie la couleur de la ligne ou de l'arc de la dimension, et des flèches.
* {{PropertyView|Line Width|Float}} : spécifie la largeur des lignes ou de l'arc appartenant à la dimension.
* {{PropertyView|Show Line|Bool}} : spécifie s'il faut afficher la ligne de la dimension. N'affecte pas l'affichage des lignes d'extension et des dépassements. Non utilisé pour les dimensions angulaires.

{{TitleProperty|Text}}

* {{PropertyView|Flip Text|Bool}} : indique si l'orientation du texte doit être inversée.
* {{PropertyView|Font Name|Font}} : spécifie la police utilisée pour dessiner le texte. Il peut s'agir d'un nom de police, tel que {{value|Arial}}, d'un style par défaut tel que {{value|sans}}, {{value|serif}} ou {{value|mono}}, d'une famille telle que {{value|Arial,Helvetica,sans}} ou d'un nom avec un style tel que {{value|Arial:Bold}}. Si la police donnée n'est pas trouvée sur le système, une police par défaut est utilisée à la place.
* {{PropertyView|Font Size|Length}} : spécifie la taille des lettres. Le texte peut être invisible dans la [[3D_view/fr|vue 3D]] si cette valeur est très petite.
* {{PropertyView|Override|String}} : spécifie un texte personnalisé à afficher à la place de la mesure réelle. Utilisez la chaîne {{value|$dim}} à l'intérieur du texte pour inclure la mesure.
* {{PropertyView|Text Color|Color}} : spécifie la couleur du texte. {{Version/fr|0.21}}
* {{PropertyView|Text Position|VectorDistance}} : spécifie la position du texte en coordonnées absolues. {{Value|[0, 0, 0]}} affichera le texte dans sa position par défaut près de la ligne ou de l'arc de dimension.
* {{PropertyView|Text Spacing|Length}} : spécifie l'espace entre le texte et la ligne ou l'arc de la dimension.

{{TitleProperty|Units}}

* {{PropertyView|Decimals|Integer}} : spécifie le nombre de décimales à afficher pour la mesure.
* {{PropertyView|Show Unit|Bool}} : indique s'il faut afficher l'unité à côté de la valeur numérique de la mesure. Non utilisé pour les dimensions angulaires.
* {{PropertyView|Unit Override|String}} : spécifie l'unité dans laquelle exprimer la mesure, par exemple, {{value|km}}, {{value|m}}, {{value|cm}}, {{value|mm}}, {{value|mi}}, {{value|ft}}, {{value|in}} ou {{value|arch}} pour les unités arch. Laissez ce champ vide pour utiliser l'unité par défaut. Non utilisé pour les dimensions angulaires.

<span id="Scripting"></span>
==Script==
==Script==


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
L'outil Cotation peut être utilisé dans une [[macros/fr|macro]], et, dans la console Python en utilisant les fonctions suivantes :

</div>
Pour créer une Draft Dimension, utilisez la méthode {{incode|make_dimension}} ({{Version/fr|0.19}}) du module Draft. Cette méthode remplace la méthode dépréciée {{incode|makeDimension}}.


The Dimension tool can be used in [[macros]] and from the [[Python]] console by using the following function:
{{Code|code=
{{Code|code=
Dimension = makeDimension(p1, p2, p3=None, p4=None)}}
dimension = make_dimension(p1, p2, p3=None, p4=None)}}

There are various ways to invoke this function, depending on the arguments passed to it:
Il existe plusieurs façons de faire appel à cette méthode, en fonction des arguments qui lui sont passés :

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


* Crée un {{incode|dimension}} linéaire en mesurant la distance entre les points {{incode|p1}} et {{incode|p2}}.
<div class="mw-translate-fuzzy">
* Crée un {{incode|dimension}} linéaire lié à {{incode|object}}, mesurant la distance entre ses sommets indexés {{incode|i1}} et {{incode|i2}}.
*Crée un objet Dimension, avec la cotation de la ligne passant par le biais de p3.
* Crée un {{incode|dimension}} circulaire lié à {{incode|object}}, avec {{incode|i1}} étant l'index du bord incurvé à mesurer et {{incode|mode}} étant soit {{incode|"radius"}} ou {{incode|"diameter"}} pour spécifier le type de dimension.
*L'ensemble des paramètres de largeur, couleur et hauteur du texte actuel seront utilisés.
** {{incode|p3}} lors du premier appel et {{incode|p4}} dans les deux autres, spécifiez un point facultatif par lequel la ligne de la dimension doit passer.
*Il y a plusieurs façons de créer une cotation, selon les arguments que vous lui transférez:
** Tous les points sont définis par leur {{incode|FreeCAD.Vector}}.
#(p1, p2, p3): crée une cotation standard de p1 à p2.

#(objet, i1, i2, p3): crée une cotation liée à un objet donné, en mesurant la distance entre ses sommets indexés i1 et i2.
Pour créer une dimension angulaire, utilisez la méthode suivante :
#(objet, i1, mode, p3): crée une cotation liée à un objet donné, i1 est l'index du bord (courbé), à mesurer et mode, est un '''rayon''' ou un '''diamètre'''. Retourne un nouvel objet créé.
</div>


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


* Crée une {{incode|dimension}} angulaire à partir du point {{incode|center}}, de la liste d'{{incode|angles}} entre deux éléments et le point {{incode|p3}} par lequel l'arc devrait passer.
<div class="mw-translate-fuzzy">
** Si {{incode|angle1 > angle2}}, l'angle affiché est la différence {{incode|angle1 - angle2}} sinon l'angle complémentaire est affiché {{incode|360 - (angle2 - angle1)}}.
* Crée une cotation angulaire à partir du centre donné , et une liste de données angulaires passant par p3.
** Les angles doivent être exprimés en radians. La fonction {{incode|math.radians()}} peut être utilisée pour convertir des angles donnés en degrés.
* Retourne l'objet nouvellement créé.
</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.
Les propriétés de vue de {{incode|dimension}} peuvent être modifiées en remplaçant ses attributs, par exemple en changeant {{incode|ViewObject.FontSize}} avec la nouvelle taille en millimètres.

Exemple :


Exemple:
{{Code|code=
{{Code|code=
import math, FreeCAD, Draft
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)
p4 = FreeCAD.Vector(-2000, 1500, 0)
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)
==Liens==
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)
[http://www.youtube.com/watch?v=nxNT0KychcY Tutoriel d'une projection de dimensions dans une page de dessin]
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/fr
{{Userdocnavi}}
|[[Draft_Text/fr|Texte]]
{{clear}}
|[[Draft_Label/fr|Étiquette]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Text.svg
|IconR=Draft_Label.svg
|IconC=Workbench_Draft.svg
}}

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

Latest revision as of 21:04, 9 January 2024

Draft Dimension

Menu location
Annotation → Dimension
Workbenches
Draft, Arch
Default shortcut
D I
Introduced in version
0.8
See also
Draft Inverser le texte de la dimension

Description

La commande Draft Dimension crée une dimension linéaire, une dimension radiale ou une dimension angulaire. La commande peut également être utilisée pour convertir des objets Std Mesurer une distance.

Les dimensions linéaires basées sur les arêtes et les dimensions radiales sont paramétriques. Cela signifie qu'elles seront mises à jour si l'arête mesurée est modifiée. Les arêtes mesurées peuvent appartenir à des ébauches d'objets mais aussi à des corps solides. Les dimensions angulaires ne sont pas paramétriques.

Les Draft Dimensions peuvent être affichées sur une page de l'atelier Techdraw à l'aide des commandes TechDraw Vue d'un objet Draft ou TechDraw Vue d'un objet Arch. L'atelier Techdraw propose également ses propres commandes de cotation. Mais celles-ci créent des dimensions qui ne sont affichées que sur la page de dessin et non dans la vue 3D.

Dimension linéaire définie par trois points

Créer

Voir aussi : Draft La barre, Draft Aimantation et Draft Contrainte.

Utilisation pour une dimension linéaire

  1. Sélectionnez une arête droite dans la vue 3D.
  2. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le bouton Dimension.
    • Sélectionnez l'option Annotation → Dimension dans le menu.
    • Utilisez les raccourcis clavier : D puis I.
  3. Le panneau de tâches Dimension s'ouvre. Voir Options pour plus d'informations.
  4. Si vous n'avez pas encore sélectionné d'arête, effectuez l'une des opérations suivantes :
    • Appuyez sur E ou sur le bouton Sélectionnez une arête et sélectionnez une arête droite dans la vue 3D.
    • Maintenez la touche Alt enfoncée, sélectionnez une arête droite dans la vue 3D et relâchez la touche Alt.
    • Définissez la distance mesurée en choisissant des points :
      • Choisissez un premier point dans la vue 3D ou rentrez des coordonnées et appuyez sur le bouton Entrez le point.
      • Choisissez un deuxième point dans la vue 3D ou rentrez des coordonnées et appuyez sur le bouton Entrez le point.
  5. Pour positionner la ligne de la dimension, effectuez l'une des opérations suivantes :
    • Pour une dimension alignée :
      • Choisissez un point dans la vue 3D ou rentrez des coordonnées et appuyez sur le bouton Entrez le point.
    • Pour une dimension horizontale :
      • Déplacez le pointeur au-dessus ou au-dessous de l'arête ou des points.
      • Maintenez la touche Maj enfoncée, déplacez le pointeur et choisissez un point dans la vue 3D.
    • Pour une dimension verticale :
      • Déplacez le pointeur à gauche ou à droite de l'arête ou des points.
      • Maintenez la touche Maj enfoncée, déplacez le pointeur et choisissez un point dans la vue 3D.

Utilisation pour une dimension radiale

  1. Sélectionnez éventuellement une arête circulaire dans la vue 3D.
  2. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le bouton Dimension.
    • Sélectionnez l'option Annotation → Dimension dans le menu.
    • Utilisez le raccourci clavier : D puis I.
  3. Le panneau de tâches Dimension s'ouvre. Voir Options pour plus d'informations.
  4. Si vous n'avez pas encore sélectionné d'arête, effectuez l'une des opérations suivantes :
    • Appuyez sur E ou sur le bouton Sélectionnez une arête et sélectionnez une arête circulaire dans la vue 3D.
    • Maintenez la touche Alt enfoncée, sélectionnez une arête circulaire dans la vue 3D et relâchez la touche Alt.
  5. Pour positionner la ligne de la dimension, effectuez l'une des opérations suivantes :
    • Pour une dimension de diamètre :
      • Choisissez un point dans la vue 3D ou rentrez des coordonnées et appuyez sur le bouton Entrez le point.
    • Pour une dimension radiale :
      • Maintenez la touche Shift et choisissez un point dans la vue 3D.

Utilisation pour une dimension angulaire

  1. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le bouton Dimension.
    • Sélectionnez l'option Annotation → Dimension dans le menu.
    • Utilisez le raccourci clavier : D puis I.
  2. Le panneau de tâches Dimension s'ouvre. Voir Options pour plus d'informations.
  3. Faites l'une des choses suivantes :
    • Appuyez sur E ou sur le bouton Sélectionnez une arête et sélectionnez une première arête droite dans la vue 3D. Répétez cette opération pour sélectionner une deuxième arête droite.
    • Maintenez la touche Alt enfoncée, sélectionnez deux arêtes droites dans la vue 3D et relâchez la touche Alt.
  4. Pour positionner l'arc de la dimension, sélectionnez un point dans la vue 3D.
  5. L'angle affiché dépend des bords et du point choisi.

Options

Les raccourcis clavier à caractère unique disponibles dans le panneau des tâches peuvent être modifiés. Voir Draft Préférences. Les raccourcis mentionnés ici sont les raccourcis par défaut. (pour la version 0.22).

  • Pour saisir manuellement des coordonnées, entrez les valeurs X, Y et Z et appuyez sur Entrée après chacune. Ou vous pouvez appuyer sur le bouton Entrez le point lorsque vous avez les valeurs souhaitées. Il est conseillé de déplacer le pointeur hors de la vue 3D avant de saisir les coordonnées.
  • Appuyez sur R ou cliquez sur la case Relative pour activer le mode relatif. Si le mode relatif est activé, les coordonnées sont relatives au dernier point, si disponible, sinon elles sont relatives à l'origine du système de coordonnées.
  • Appuyez sur G ou cliquez sur la case Global pour activer le mode global. Si le mode global est activé, les coordonnées sont relatives au système de coordonnées global, sinon elles sont relatives au système de coordonnées du plan de travail. introduit dans la version 0.20
  • Appuyez sur N ou cliquez sur la case Continue pour activer le mode continu. Ce mode ne fonctionne que pour les dimensions linéaires. Si le mode continu est activé, la commande redémarre après avoir terminé, ce qui vous permet de continuer à créer des dimensions. Toutes les dimensions suivantes commenceront à partir du point final de la dimension précédente, et utiliseront la même ligne de base que la première dimension. Notez que la sélection des bords n'est pas possible pour les dimensions suivantes.
  • Appuyez sur S pour activer ou désactiver Draft aimantation.
  • Appuyez sur Échap ou sur le bouton Fermer pour terminer la commande.

Convertir

Utilisation

  1. Sélectionnez un ou plusieurs objets Std Mesurer une distance.
  2. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le Dimension.
    • Sélectionnez l'option Annotation → Dimension dans le menu.
    • Utilisez le raccourci clavier : D puis I.
  3. Chaque objet sélectionné est remplacé par une Draft Dimension linéaire non paramétrique.

Remarques

  • Les Draft Dimensions linéaires et radiales peuvent être modifiées avec la commande Draft Éditer.
  • Les Draft Dimensions créées ou enregistrées avec la version 0.21 de FreeCAD ne sont pas rétrocompatibles.

Propriétés

Voir aussi : Éditeur de propriétés

Un objet Draft Dimension est dérivé d'un objet App FeaturePython et hérite de toutes ses propriétés. Les propriétés suivantes sont supplémentaires, sauf indication contraire :

Données dimension linéaire et radiale

Dimension

  • DonnéesDimline (VectorDistance) : spécifie le point par lequel passe la ligne de dimension.
  • DonnéesLinked Geometry (LinkSubList) : spécifie l'objet et son sous-élément, ou ses sous-éléments, auxquels la dimension est liée.
  • DonnéesNormal (Vector) : spécifie la normale du plan du texte.
  • Données (hidden)Support (Link) : spécifie l'objet mesuré.

Linear/radial dimension

  • DonnéesDirection (Vector) : spécifie la direction de la mesure.
  • DonnéesDistance (Length) : (en lecture seule) spécifie la valeur de la mesure.
  • DonnéesEnd (VectorDistance) : spécifie le dernier point de la mesure.
  • DonnéesStart (VectorDistance) : spécifie le point de départ de la mesure.

Radial dimension

  • DonnéesDiameter (Bool) : spécifie si une dimension radiale est affichée comme une dimension de diamètre.

Données dimension angulaire

Angular dimension

  • DonnéesAngle (Angle) : (en lecture seule) spécifie la valeur de la mesure.
  • DonnéesCenter (VectorDistance) : spécifie le centre de la mesure.
  • DonnéesFirst Angle (Angle) : spécifie le début de l'angle de la mesure.
  • DonnéesLast Angle (Angle) : spécifie la fin de l'angle de la mesure.

Dimension

  • DonnéesDimline (VectorDistance) : spécifie le point par lequel passe l'arc de dimension.
  • Données (hidden)Linked Geometry (LinkSubList) : non utilisé.
  • Données (hidden)Normal (Vecteur) : spécifie la normale du plan de la dimension.
  • Données (hidden)Support (Link) : non utilisé.

Vue

Annotation

  • VueAnnotation Style (Enumeration) : spécifie le style d'annotation appliqué à la dimension. Voir Draft Éditeur styles d'annotations.
  • VueScale Multiplier (Float) : spécifie le facteur d'échelle général appliqué à la dimension.

Display Options

  • VueDisplay Mode (Enumeration) : spécifie comment le texte est affiché. S'il s'agit de World, le texte sera affiché sur un plan défini par la DonnéesNormal de la mesure. S'il s'agit de Screen, le texte sera toujours tourné vers l'écran. Il s'agit d'une propriété héritée. Les options mentionnées sont les options renommées (introduit dans la version 0.21).

Graphics

  • VueArrow Size (Length) : spécifie la taille des symboles affichés aux extrémités de la ligne ou de l'arc de dimension.
  • VueArrow Type (Enumeration) : spécifie le type de symbole affiché aux extrémités de la ligne ou de l'arc de la dimension, qui peut être Dot, Circle, Arrow, Tick ou Tick-2.
  • VueDim Overshoot (Distance) : spécifie la longueur supplémentaire ajoutée à la ligne de la dimension. Non utilisé pour les dimensions angulaires.
  • VueExt Lines (Distance) : spécifie la longueur des lignes d'extension qui vont de la ligne de la dimension aux points mesurés. Utilisez 0 pour des lignes d'extension complètes. Une valeur négative définit l'écart entre les extrémités des lignes d'extension et les points mesurés. Une valeur positive définit la longueur maximale des lignes d'extension. Utilisé uniquement pour les dimensions linéaires.
  • VueExt Overshoot (Distance) : spécifie la longueur supplémentaire des lignes d'extension au-delà de la ligne de la dimension. Non utilisé pour les dimensions angulaires.
  • VueFlip Arrows (Bool) : indique s'il faut inverser l'orientation des symboles aux extrémités de la ligne ou de l'arc de la dimension. Ne fonctionne que si les symboles sont des flèches.
  • VueLine Color (Color) : spécifie la couleur de la ligne ou de l'arc de la dimension, et des flèches.
  • VueLine Width (Float) : spécifie la largeur des lignes ou de l'arc appartenant à la dimension.
  • VueShow Line (Bool) : spécifie s'il faut afficher la ligne de la dimension. N'affecte pas l'affichage des lignes d'extension et des dépassements. Non utilisé pour les dimensions angulaires.

Text

  • VueFlip Text (Bool) : indique si l'orientation du texte doit être inversée.
  • VueFont Name (Font) : spécifie la police utilisée pour dessiner le texte. Il peut s'agir d'un nom de police, tel que Arial, d'un style par défaut tel que sans, serif ou mono, d'une famille telle que Arial,Helvetica,sans ou d'un nom avec un style tel que Arial:Bold. Si la police donnée n'est pas trouvée sur le système, une police par défaut est utilisée à la place.
  • VueFont Size (Length) : spécifie la taille des lettres. Le texte peut être invisible dans la vue 3D si cette valeur est très petite.
  • VueOverride (String) : spécifie un texte personnalisé à afficher à la place de la mesure réelle. Utilisez la chaîne $dim à l'intérieur du texte pour inclure la mesure.
  • VueText Color (Color) : spécifie la couleur du texte. introduit dans la version 0.21
  • VueText Position (VectorDistance) : spécifie la position du texte en coordonnées absolues. [0, 0, 0] affichera le texte dans sa position par défaut près de la ligne ou de l'arc de dimension.
  • VueText Spacing (Length) : spécifie l'espace entre le texte et la ligne ou l'arc de la dimension.

Units

  • VueDecimals (Integer) : spécifie le nombre de décimales à afficher pour la mesure.
  • VueShow Unit (Bool) : indique s'il faut afficher l'unité à côté de la valeur numérique de la mesure. Non utilisé pour les dimensions angulaires.
  • VueUnit Override (String) : spécifie l'unité dans laquelle exprimer la mesure, par exemple, km, m, cm, mm, mi, ft, in ou arch pour les unités arch. Laissez ce champ vide pour utiliser l'unité par défaut. Non utilisé pour les dimensions angulaires.

Script

Voir aussi : Autogenerated API documentation et FreeCAD Débuter avec les scripts.

Pour créer une Draft Dimension, utilisez la méthode make_dimension (introduit dans la version 0.19) du module Draft. Cette méthode remplace la méthode dépréciée makeDimension.

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

Il existe plusieurs façons de faire appel à cette méthode, en fonction des arguments qui lui sont passés :

dimension = make_dimension(p1, p2, p3=None)
dimension = make_dimension(object, i1, i2, p4=None)
dimension = make_dimension(object, i1, mode, p4=None)
  • Crée un dimension linéaire en mesurant la distance entre les points p1 et p2.
  • Crée un dimension linéaire lié à object, mesurant la distance entre ses sommets indexés i1 et i2.
  • Crée un dimension circulaire lié à object, avec i1 étant l'index du bord incurvé à mesurer et mode étant soit "radius" ou "diameter" pour spécifier le type de dimension.
    • p3 lors du premier appel et p4 dans les deux autres, spécifiez un point facultatif par lequel la ligne de la dimension doit passer.
    • Tous les points sont définis par leur FreeCAD.Vector.

Pour créer une dimension angulaire, utilisez la méthode suivante :

dimension = make_angular_dimension(center, angles, p3, normal=None)
dimension = make_angular_dimension(center, [angle1, angle2], p3, normal=None)
  • Crée une dimension angulaire à partir du point center, de la liste d'angles entre deux éléments et le point p3 par lequel l'arc devrait passer.
    • Si angle1 > angle2, l'angle affiché est la différence angle1 - angle2 sinon l'angle complémentaire est affiché 360 - (angle2 - angle1).
    • Les angles doivent être exprimés en radians. La fonction math.radians() peut être utilisée pour convertir des angles donnés en degrés.

Les propriétés de vue de dimension peuvent être modifiées en remplaçant ses attributs, par exemple en changeant ViewObject.FontSize avec la nouvelle taille en millimètres.

Exemple :

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()