Draft Dimension/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Voir aussi: Draft La barre, Draft Accrochage et Draft Contrainte.")
No edit summary
 
(141 intermediate revisions by 3 users not shown)
Line 3: Line 3:
{{Docnav/fr
{{Docnav/fr
|[[Draft_Text/fr|Texte]]
|[[Draft_Text/fr|Texte]]
|[[Draft_Label/fr|Etiquette]]
|[[Draft_Label/fr|Étiquette]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Text.svg
|IconL=Draft_Text.svg
|IconR=Draft_Label.svg
|IconR=Draft_Label.svg
Line 14: Line 14:
|Name/fr=Draft Dimension
|Name/fr=Draft Dimension
|MenuLocation=Annotation → Dimension
|MenuLocation=Annotation → Dimension
|Workbenches=[[Draft_Module/fr|Draft]], [[Arch_Module/fr|Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Shortcut={{KEY|D}} {{KEY|I}}
|Shortcut={{KEY|D}} {{KEY|I}}
|Version=0.8
|Version=0.8
|SeeAlso=[[Draft_FlipDimension/fr|Draft Inverser la direction de la cote]]
|SeeAlso=[[Draft_FlipDimension/fr|Draft Inverser le texte de la dimension]]
}}
}}


==Description==
==Description==


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]].
<div class="mw-translate-fuzzy">
L'outil {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Draft 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.
</div>


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


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]].
<div class="mw-translate-fuzzy">
La cote résultante est placée dans la vue 3D et est considérée comme un objet Draft. Cet objet peut être affiché sur une page [[TechDraw Workbench/fr|Atelier Techdraw]] à l'aide des outils [[TechDraw NewDraft/fr|Nouvelle vue d'un objet Draft TechDraw]] ou [[TechDraw NewArch/fr|Nouvelle vue Arch TechDraw]]. TechDraw dispose également de ses propres outils pour afficher les dimensions, tels que [[TechDraw Dimension Length/fr|Longueur TechDraw]] et [[TechDraw Dimension Radius/fr|Dimension de rayon TechDraw]]. Cependant, ces outils sont destinés à la préparation de dessins techniques. Ils ne créent donc les cotes que dans la page de dessin et non dans la vue 3D.
</div>


[[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">
{{Caption|Dimension définie par trois points}}
</div>


<span id="Create"></span>
==Créer==
==Créer==


Voir aussi: [[Draft_Tray/fr|Draft La barre]], [[Draft_Snap/fr|Draft Accrochage]] et [[Draft_Constrain/fr|Draft Contrainte]].
Voir aussi : [[Draft_Tray/fr|Draft La barre]], [[Draft_Snap/fr|Draft Aimantation]] et [[Draft_Constrain/fr|Draft Contrainte]].


<span id="Usage_linear_dimension"></span>
=== Usage linear dimension ===
=== Utilisation pour une dimension linéaire ===


# Sélectionnez une arête droite dans la [[3D_view/fr|vue 3D]].
<div class="mw-translate-fuzzy">
# Il existe plusieurs façons de lancer la commande :
# Lancez la commande Dimension Draft de l'outil de plusieurs manières :
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft Dimension|Draft Dimension]]}} dans la barre d'outils Draft,
#* 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}}
#* Utilisez l'entrée {{MenuCommand|Draft → Dimension}} dans le menu Draft
#* 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.
# Cliquez sur un point dans la [[3D view/fr|vue 3D]] ou saisissez une [[Draft_Coordinates/fr|coordonnée]] et appuyez sur la {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point Draft]]}} bouton.
# Si vous n'avez pas encore sélectionné d'arête, effectuez l'une des opérations suivantes :
# Cliquez sur un deuxième point dans la [[3D view/fr|vue 3D]] ou saisissez une [[Draft_Coordinates/fr|coordonnée]] et appuyez sur la {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point Draft]]}} bouton. Les deux premiers points définissent la distance mesurée.
#* 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]].
# Cliquez sur un troisième dans la [[3D view/fr|vue 3D]] ou saisissez une [[Draft_Coordinates/fr|coordonnée]] et appuyez sur la {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point Draft]]}} bouton. Le point final définit la position de la ligne de mesure.
#* 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}}.
</div>
#* 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>
=== Usage radial dimension ===
=== Utilisation pour une dimension radiale ===


# Optionally select a circular edge in the [[3D_view|3D view]].
# Sélectionnez éventuellement une arête circulaire dans la [[3D_view/fr|vue 3D]].
# Il existe plusieurs façons de lancer la commande :
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button.
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
# The {{MenuCommand|Dimension}} task panel opens. See [[#Options|Options]] for more information.
# 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 :
# If you have not yet selected an edge do one of the following:
#* Press the {{Button|[[Image:view-select.svg|16px]] select edge}} button and select a circular edge in the [[3D_view|3D view]].
#* 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]].
#* Hold down the {{KEY|Alt}} key, select a circular edge in the [[3D_view|3D view]] and release the {{KEY|Alt}} key.
#* 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}}.
# To position the dimension line do one of the following:
# Pour positionner la ligne de la dimension, effectuez l'une des opérations suivantes :
#* For a diameter dimension:
#* Pour une dimension de diamètre :
#** Pick a point in the [[3D_view|3D view]], or type [[Draft_Coordinates|coordinates]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button.
#** 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}}.
#* For a radial dimension:
#* Pour une dimension radiale :
#** Hold down the {{KEY|Shift}} key and pick a point in the [[3D_view|3D view]].
#** Maintenez la touche {{KEY|Shift}} et choisissez un point dans la [[3D_view/fr|vue 3D]].


<span id="Usage_angular_dimension"></span>
=== Usage angular dimension ===
=== Utilisation pour une dimension angulaire ===


# Il existe plusieurs façons de lancer la commande :
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button.
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
# The {{MenuCommand|Dimension}} task panel opens. See [[#Options|Options]] for more information.
# Le panneau de tâches {{MenuCommand|Dimension}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Faites l'une des choses suivantes :
# Hold down the {{KEY|Alt}} key, select two straight edges in the [[3D_view|3D view]] and release the {{KEY|Alt}} key.
#* 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.
# To position the dimension arc pick a point in the [[3D_view|3D view]].
#* 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}}.
# Depending on the edges and the picked point the displayed angle will be the acute (sharp) or obtuse (blunt) angle between the edges, or the angle of one of the edges with the horizontal. In some cases you may have to first add auxiliary geometry ([[Draft_Line|Draft Lines]] for example) to get a particular angle.
# Pour positionner l'arc de la dimension, sélectionnez un point dans la [[3D_view/fr|vue 3D]].
# L'angle affiché dépend des bords et du point choisi.


=== Options ===
<div class="mw-translate-fuzzy">
==Options==
</div>


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


* 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.
<div class="mw-translate-fuzzy">
* 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.
* Appuyez sur {{KEY|X}}, {{KEY|Y}} ou {{KEY|Z}} après un point pour contraindre le point suivant sur l'axe donné.
* 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}}
* Pour entrer les coordonnées manuellement, entrez simplement les chiffres, puis appuyez sur {{KEY|Entrée}} entre chaque composante X, Y et Z. Vous pouvez appuyer sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point Draft]]}} lorsque vous avez les valeurs souhaitées pour insérer le point.
* Appuyez sur {{KEY|R}} ou cliquez sur la case à cocher pour basculer en mode ''relatif''. Si le mode relatif est activé, les coordonnées du point suivant sont relatives au point précédent. sinon, ils sont absolus, pris de l'origine (0,0,0).
* 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.
* Appuyez sur {{KEY|S}} pour activer ou désactiver [[Draft_Snap/fr|Draft aimantation]].
* Appuyez sur {{KEY|T}} ou cochez la case pour passer en mode ''continuer''. Si le mode Continuer est activé, l'outil Cote redémarre une fois que vous avez défini le dernier point, ce qui vous permet de dessiner une autre dimension sans appuyer à nouveau sur le bouton de l'outil. les dimensions suivantes commenceront à partir du dernier point de la dimension précédente et partageront la même ligne de base.
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour terminer la commande.
* Maintenez la touche {{KEY|Ctrl}} pendant que vous dessinez pour forcer [[Draft_Snap/fr|Accrochage Draft]] votre point au point de capture le plus proche, indépendamment de la distance.
* Maintenez la touche {{KEY|Shift}} pendant que vous dessinez sur [[Draft_Constrain/fr|Contrainte Draft]] votre prochain point horizontalement ou verticalement par rapport au précédent et basculez entre les modes diamètre et rayon.
* Appuyez sur {{KEY|Echapp}} ou sur le bouton {{Button|Fermer}} pour abandonner la commande en cours, puis terminez les dimensions ''continuées''. Les dimensions déjà placées le resteront.
</div>


== Convert ==
<span id="Convert"></span>
== Convertir ==


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


# Select one or more [[Std_MeasureDistance|Std MeasureDistance]] objects.
# Sélectionnez un ou plusieurs objets [[Std_MeasureDistance/fr|Std Mesurer une distance]].
# Il existe plusieurs façons de lancer la commande :
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension|Draft Dimension]]}} button.
#* Appuyez sur le {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} option from the menu.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|I}}.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
# Each selected object is replaced by a non-parametric linear Draft Dimension.
# Chaque objet sélectionné est remplacé par une Draft Dimension linéaire non paramétrique.


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


* Les Draft Dimensions linéaires et radiales peuvent être modifiées avec la commande [[Draft_Edit/fr|Draft Éditer]].
<div class="mw-translate-fuzzy">
* 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.
La dimension peut être modifiée en double-cliquant sur l'élément dans la [[Tree view/fr|vue arborescente ]] ou en appuyant sur le bouton {{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit/fr|Éditer Draft]]}}. Ensuite, vous pouvez déplacer les points vers une nouvelle position.
</div>


<span id="Properties"></span>
==Propriétés==
==Propriétés==


Voir aussi : [[Property_editor/fr|Éditeur de propriétés]]
See also: [[property_editor|Property editor]].


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


<span id="Data_linear_and_radial_dimension"></span>
=== Data linear and radial dimension ===
=== Données dimension linéaire et radiale ===


{{TitleProperty|Dimension}}
{{TitleProperty|Dimension}}


* {{PropertyData|Dimline|VectorDistance}} : spécifie le point par lequel passe la ligne de dimension.
<div class="mw-translate-fuzzy">
* {{PropertyData|Linked Geometry|LinkSubList}} : spécifie l'objet et son sous-élément, ou ses sous-éléments, auxquels la dimension est liée.
=== Données ===
* {{PropertyData|Start}} : Le point de départ de la cote
* {{PropertyData|Normal|Vector}} : spécifie la normale du plan du texte.
* {{PropertyData|End}} : Le point final de la cote
* {{PropertyData|Support|Link|hidden}} : spécifie l'objet mesuré.
* {{PropertyData|Dimline}} : Le point donnant la valeur de la dimension de la ligne de cote
* {{PropertyData|Distance}} : (en lecture seule) indique la longueur mesurée.
* {{PropertyData|Diameter}} : s'il s'agit de {{TRUE}}, affiche une dimension de diamètre, sinon affiche une cote de rayon. Cette propriété ne fonctionne que si la dimension est attachée à un arc de cercle.
</div>


{{TitleProperty|Linear/radial dimension}}
{{TitleProperty|Linear/radial dimension}}


* {{PropertyData|Direction|Vector}}: specifies the direction of the measurement.
* {{PropertyData|Direction|Vector}} : spécifie la direction de la mesure.
* {{PropertyData|Distance|Length}}: (read-only) specifies the value of the measurement.
* {{PropertyData|Distance|Length}} : (en lecture seule) spécifie la valeur de la mesure.
* {{PropertyData|End|VectorDistance}}: specifies the end point of the measurement.
* {{PropertyData|End|VectorDistance}} : spécifie le dernier point de la mesure.
* {{PropertyData|Start|VectorDistance}}: specifies the start point of the measurement.
* {{PropertyData|Start|VectorDistance}} : spécifie le point de départ de la mesure.


{{TitleProperty|Radial dimension}}
{{TitleProperty|Radial dimension}}


* {{PropertyData|Diameter|Bool}}: specifies if a radial dimension is displayed as a diameter dimension. If it changed the symbol used in {{PropertyView|Override}} must be updated manually (from {{Value|Ø}} to {{Value|R}} or vice versa). Not used for linear dimensions.
* {{PropertyData|Diameter|Bool}} : spécifie si une dimension radiale est affichée comme une dimension de diamètre.


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


{{TitleProperty|Angular dimension}}
{{TitleProperty|Angular dimension}}


* {{PropertyData|Angle|Angle}}: (read-only) specifies the value of the measurement.
* {{PropertyData|Angle|Angle}} : (en lecture seule) spécifie la valeur de la mesure.
* {{PropertyData|Center|VectorDistance}}: specifies the center of the measurement.
* {{PropertyData|Center|VectorDistance}} : spécifie le centre de la mesure.
* {{PropertyData|First Angle|Angle}}: specifies the start angle of the measurement.
* {{PropertyData|First Angle|Angle}} : spécifie le début de l'angle de la mesure.
* {{PropertyData|Last Angle|Angle}}: specifies the end angle of the measurement.
* {{PropertyData|Last Angle|Angle}} : spécifie la fin de l'angle de la mesure.


{{TitleProperty|Dimension}}
{{TitleProperty|Dimension}}


* {{PropertyData|Dimline|VectorDistance}}: specifies the point through which the dimension arc passes.
* {{PropertyData|Dimline|VectorDistance}} : spécifie le point par lequel passe l'arc de dimension.
* {{PropertyData|Linked Geometry|LinkSubList|hidden}}: not used.
* {{PropertyData|Linked Geometry|LinkSubList|hidden}} : non utilisé.
* {{PropertyData|Normal|Vector|hidden}}: specifies the normal of the plane of the dimension.
* {{PropertyData|Normal|Vecteur|hidden}} : spécifie la normale du plan de la dimension.
* {{PropertyData|Support|Link|hidden}}: not used.
* {{PropertyData|Support|Link|hidden}} : non utilisé.


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


{{TitleProperty|Annotation}}
{{TitleProperty|Annotation}}


* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the dimension. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]].
* {{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}}: specifies the general scaling factor applied to the dimension.
* {{PropertyView|Scale Multiplier|Float}} : spécifie le facteur d'échelle général appliqué à la dimension.


{{TitleProperty|Display Options}}
{{TitleProperty|Display Options}}


* {{PropertyView|Display Mode|Enumeration}}: specifies how the text is displayed. If it is {{value|2D text}} the text will be displayed in a plane defined by the {{PropertyData|Normal}} of the measurement. If it is {{value|3D text}} the text will always face the camera. Note that these values are switched compared to [[Draft_Text|Draft Texts]]. This is an inherited property.
* {{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}}
{{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.
<div class="mw-translate-fuzzy">
* {{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}}.
=== Vue ===
* {{PropertyView|Ext Lines}} : spécifie la longueur maximale des lignes d'attache allant des points de mesure à la ligne de cote.
* {{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}} : spécifie la longueur supplémentaire des lignes d'attache au-delà de la ligne de cote.
* {{PropertyView|Dim Overshoot}} : spécifie la longueur supplémentaire ajoutée à la ligne de cote.
* {{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|Arrow Size}} : spécifie la taille du symbole affiché aux extrémités de la ligne de cote.
* {{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|Arrow Type}} : spécifie le type de symbole affiché aux extrémités de la ligne de cote, qui peut être "Point", "Cercle", "Flèche" ou "Coche".
* {{PropertyView|Line Color|Color}} : spécifie la couleur de la ligne ou de l'arc de la dimension, et des flèches.
* {{PropertyView|Flip Arrows}} : spécifie s'il faut inverser l'orientation des symboles aux extrémités de la ligne de cote. cela ne fonctionne que si ces symboles sont 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.
* {{PropertyView|Font Name}} : spécifie la police à utiliser 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: "Gras". Si la police donnée n'est pas trouvée sur le système, une police générique est utilisée à la place.
* {{PropertyView|Font Size}} : spécifie la taille des lettres. Si l'objet de cote est créé dans la vue arborescente mais qu'aucun texte n'est visible, augmentez la taille du texte jusqu'à ce qu'il soit visible.
* {{PropertyView|Flip Text}} : spécifie s'il faut retourner l'orientation du texte indiquant la mesure.
* {{PropertyView|Text Position}} : spécifie la position du texte en coordonnées absolues, par rapport à l'origine (0,0,0) ; laissez cette propriété à sa valeur par défaut (0,0,0) pour afficher le texte en regard de la ligne de cote.
* {{PropertyView|Text Spacing}} : spécifie l'espace entre le texte et la ligne de cote.
* {{PropertyView|Override}} : spécifie un texte personnalisé à afficher à la place de la mesure réelle. Utilisez la chaîne {{incode | $ dim}} à l'intérieur du texte pour afficher la valeur de mesure.
* {{PropertyView|Decimals}} : spécifie le nombre de décimales à afficher sur la mesure.
* {{PropertyView|Show Unit}} : s'il s'agit de {{TRUE}}, l'unité est affichée à côté de la valeur numérique de la mesure.
* {{PropertyView|Unit Override}} : spécifie une unité dans laquelle exprimer la mesure, par exemple, "km", "m", "cm", "mm", "mi", "ft", "in" ; laissez cette propriété vide pour utiliser les unités par défaut. {{Version | 0.17}}
</div>


{{TitleProperty|Text}}
{{TitleProperty|Text}}


* {{PropertyView|Flip Text|Bool}}: specifies whether to flip the orientation of the text.
* {{PropertyView|Flip Text|Bool}} : indique si l'orientation du texte doit être inversée.
* {{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 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}}: specifies the size of the letters. The text can be invisible in the [[3D_view|3D view]] if this value is very small.
* {{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}}: specifies a custom text to display instead of the actual measurement. Use the string {{value|$dim}} inside the text to include the measurement.
* {{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}}: 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 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}}: specifies the space between the text and the dimension line or arc.
* {{PropertyView|Text Spacing|Length}} : spécifie l'espace entre le texte et la ligne ou l'arc de la dimension.


{{TitleProperty|Units}}
{{TitleProperty|Units}}


* {{PropertyView|Decimals|Integer}}: specifies the number of decimal places to display for the measurement. Not used for angular dimensions.
* {{PropertyView|Decimals|Integer}} : spécifie le nombre de décimales à afficher pour la mesure.
* {{PropertyView|Show Unit|Bool}}: specifies whether to display the unit next to the numerical value of the measurement. Not used for angular dimensions.
* {{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}}: 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.
* {{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.


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

<div class="mw-translate-fuzzy">
==Script==
==Script==
{{Emphasis|Voir aussi :}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD scripts de base]].
</div>


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
<div class="mw-translate-fuzzy">

L'outil Cote peut être utilisé à l'intérieur d'une [[macros/fr|macro]] et à partir de la console [[Python|Python]] en utilisant la fonction suivante:
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}}.
</div>


{{Code|code=
{{Code|code=
dimension = make_dimension(p1, p2, p3=None, p4=None)}}
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 :
<div class="mw-translate-fuzzy">
Il existe différentes manières d’appeler cette fonction, en fonction des arguments qui lui sont transmis :
</div>


{{Code|code=
{{Code|code=
Line 233: Line 226:
}}
}}


* 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 en mesurant la distance entre les points {{incode|p1}} et {{incode|p2}}.
* 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 {{incode|Dimension}} linéaire lié à {{incode|object}}, mesurant la distance entre ses sommets indexés {{incode|i1}} et {{incode|i2}}.
* 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.
** {{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.
* 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.
** {{incode|p3}} lors du premier appel et {{incode|p4}} dans les deux autres, spécifiez un point facultatif par lequel la ligne de cote doit passer.
** Tous les points sont définis par leur {{incode|FreeCAD.Vector}}.
** Tous les points sont définis par leur {{incode|FreeCAD.Vector}}.
</div>


Pour créer une dimension angulaire, utilisez la méthode suivante :
<div class="mw-translate-fuzzy">
Pour créer une cote angulaire, utilisez la fonction suivante :
</div>


{{Code|code=
{{Code|code=
Line 250: Line 239:
}}
}}


* 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">
* 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.
** 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)}}.
** 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)}}.
** 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.
** 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.
</div>


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


Exemple :
Exemple :
Line 297: Line 282:
{{Docnav/fr
{{Docnav/fr
|[[Draft_Text/fr|Texte]]
|[[Draft_Text/fr|Texte]]
|[[Draft_Label/fr|Etiquette]]
|[[Draft_Label/fr|Étiquette]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Text.svg
|IconL=Draft_Text.svg
|IconR=Draft_Label.svg
|IconR=Draft_Label.svg

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