Draft Dimension/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(158 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_Text/fr|Texte]]
|[[Draft_Text/fr|Texte]]
|[[Draft_BSpline/fr|BSpline]]
|[[Draft_Label/fr|Étiquette]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Text.svg
|IconL=Draft_Text.svg
|IconR=Draft_BSpline.svg
|IconR=Draft_Label.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 12: Line 13:
|Name=Draft Dimension
|Name=Draft Dimension
|Name/fr=Draft Dimension
|Name/fr=Draft Dimension
|MenuLocation=Draft → Dimension
|MenuLocation=Annotation → Dimension
|Workbenches=[[Draft_Module/fr|Draft]], [[Arch_Module/fr|Arch]], [[TechDraw_Workbench/fr|TechDraw]]
|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]].
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.


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


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.
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 définie par trois points}}
{{Caption|Dimension linéaire définie par trois points}}


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


Voir aussi : [[Draft_Tray/fr|Draft La barre]], [[Draft_Snap/fr|Draft Aimantation]] et [[Draft_Constrain/fr|Draft Contrainte]].
# 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,
#* Utilisez le raccourci clavier {{KEY|D}} puis {{KEY|I}}
#* Utilisez l'entrée {{MenuCommand|Draft → Dimension}} dans le menu Draft
# 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.
# 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.
# 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.


<span id="Usage_linear_dimension"></span>
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.
=== Utilisation pour une dimension linéaire ===


# Sélectionnez une arête droite dans la [[3D_view/fr|vue 3D]].
Les points de mesure peuvent être modifiés après la création en modifiant les propriétés de début et de fin.
# 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>
La position de la ligne de mesure peut également être modifiée après la création en modifiant sa propriété direction.
=== Utilisation pour une dimension radiale ===


# Sélectionnez éventuellement une arête circulaire dans la [[3D_view/fr|vue 3D]].
==Types de cotations disponibles==
# 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 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>
Relâchez le modificateur, {{KEY|Alt}} ou {{KEY|Shift}}, après avoir sélectionné un point ou une arête.
=== Utilisation pour une dimension angulaire ===


# Il existe plusieurs façons de lancer la commande :
* Dimensions linéaires : maintenez la touche {{KEY|Alt}} enfoncée ou cliquez sur le bouton {{Button|[[Image:view-select.svg|16px]] sélectionnez le bord}}, sélectionnez un bord droit, puis sélectionnez un deuxième point pour tracer la ligne de cote parallèle à ce bord.
#* Appuyez sur le bouton {{Button|[[Image:Draft_Dimension.svg|16px]] [[Draft_Dimension/fr|Dimension]]}}.
:{{emphasis|Remarque :}} vous pouvez également présélectionner l'arête avant d'appeler l'outil.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Dimension.svg|16px]] Dimension}} dans le menu.
* Dimensions horizontales et verticales : choisissez un point, puis un deuxième point, maintenez la touche {{KEY|Shift}} enfoncée et déplacez le pointeur horizontalement ou verticalement, puis choisissez un troisième point pour tracer la ligne de cote parallèle au point X axe ou l'axe des ordonnées.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|I}}.
:{{emphasis|Remarque 1 :}} maintenez la touche {{KEY|Shift}} enfoncée et déplacez le pointeur dans différentes directions jusqu'à ce que la ligne de cote s'aligne sur l'axe souhaité. Un clic sur {{KEY|Shift}} alors que le pointeur est éloigné du premier point aligne généralement la dimension sur l'axe X; si le pointeur est proche du premier point, il alignera généralement la cote sur l'axe des ordonnées.
# Le panneau de tâches {{MenuCommand|Dimension}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
:{{emphasis|Remarque 2 :}} au lieu de choisir deux points, choisissez un bord en maintenant {{KEY|Alt}}.
# Faites l'une des choses suivantes :
* Dimensions du diamètre : maintenez la touche {{KEY|Alt}} enfoncée, sélectionnez un bord incurvé, puis choisissez un deuxième point pour tracer la ligne de cote.
#* 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.
** Dimensions du rayon : maintenez la touche {{KEY|Alt}} et sélectionnez un bord incurvé, puis maintenez la touche {{KEY|Shift}} et choisissez un deuxième point pour tracer la ligne de cote.
* Dimensions angulaires : maintenez la touche {{KEY|Alt}} puis sélectionnez deux arêtes droites, puis choisissez un point situé entre les deux arêtes pour afficher l'angle aigu ou obtus, ou ailleurs pour indiquer un angle supplémentaire ou explicite.
#* 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}}.
# Pour positionner l'arc de la dimension, sélectionnez un point dans la [[3D_view/fr|vue 3D]].
:{{emphasis|Remarque :}} l'angle affiché dépend en grande partie de la position d'origine des arêtes sélectionnées. Si vous souhaitez afficher un angle particulier, vous devrez peut-être ajouter des [[Draft Line/fr|Ligne Draft]] auxiliaires qui s'étendent des bords d'origine et mesurer ces extensions.
# L'angle affiché dépend des bords et du point choisi.


=== Options ===
{{Emphasis|Remarque:}} en présélectionnant une arête ou en la choisissant avec {{KEY|Alt}} ou {{Button|[[Image:view-select.svg|16px]] sélectionnez le bord}}, la dimension deviendra {{emphasis|paramétrique}}, c’est-à-dire qu’elle se souviendra du bord auquel elle est liée. Si les extrémités de ce bord se déplacent ultérieurement, la cote les suivra et ajustera la mesure affichée.


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).
==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.
* 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|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.
* 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|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}}
* 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|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]].
* 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.
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour terminer la commande.
* 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.


<span id="Convert"></span>
== 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==


Voir aussi : [[Property_editor/fr|Éditeur de propriétés]]
=== Données ===
* {{PropertyData|Start}}: Le point de départ de la cote
* {{PropertyData|End}}: Le point final de la cote
* {{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.


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>
=== 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 ===
=== Vue ===
* {{PropertyView|Ext Lines}}: spécifie la longueur maximale des lignes d'attache allant des points de mesure à la ligne de cote.
* {{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|Arrow Size}}: spécifie la taille du symbole affiché aux extrémités de la ligne de cote.
* {{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|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|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}}


{{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==
{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD scripts de base]].


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
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}}.

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

Il existe différentes manières d’appeler cette fonction, en fonction des arguments qui lui sont transmis:
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}}.
* 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.
* 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.
** {{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.
** Tous les points sont définis par leur {{incode|FreeCAD.Vector}}.
** Tous les points sont définis par leur {{incode|FreeCAD.Vector}}.


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

{{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.
* 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.


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


p1 = FreeCAD.Vector(0, 0, 0)
p4 = App.Vector(-2000, 1500, 0)
dimension2 = Draft.make_dimension(polygon, 1, 2, p4)
p2 = FreeCAD.Vector(1000, 1000, 0)
dimension2.ViewObject.FontSize = 200
p3 = FreeCAD.Vector(-2500, 0, 0)
Dimension1 = Draft.makeDimension(p1, p2, p3)
Dimension1.ViewObject.FontSize = 200


center = App.Vector(2000, 0, 0)
Polygon = Draft.makePolygon(3, radius=1000)
p4 = FreeCAD.Vector(-2000, 1500, 0)
p5 = App.Vector(3000, 1000, 0)
angle1 = 45
Dimension2 = Draft.makeDimension(Polygon, 1, 2, p4)
angle2 = 10
Dimension2.ViewObject.FontSize = 200
dimension3 = Draft.make_angular_dimension(center, [angle1, angle2], p5)
dimension3.ViewObject.FontSize = 200


dimension4 = Draft.make_angular_dimension(center, [angle2, angle1], p5*1.2)
center = FreeCAD.Vector(2000, 0, 0)
dimension4.ViewObject.FontSize = 200
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


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


==Liens==
*Tutoriel vidéo: [http://www.youtube.com/watch?v=nxNT0KychcY Tutoriel d'une projection de dimensions dans une page de dessin], FreeCAD 0.14


{{Docnav/fr
{{Docnav/fr
|[[Draft_Text/fr|Texte]]
|[[Draft_Text/fr|Texte]]
|[[Draft_BSpline/fr|BSpline]]
|[[Draft_Label/fr|Étiquette]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Text.svg
|IconL=Draft_Text.svg
|IconR=Draft_BSpline.svg
|IconR=Draft_Label.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
Line 169: Line 291:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

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