Draft Dimension

From FreeCAD Documentation
Revision as of 13:48, 19 May 2021 by David69 (talk | contribs) (Created page with "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émenta...")

Draft Dimension

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

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 Draft ou TechDraw Vue 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 Accrochage et Draft Contrainte.

Utilisation pour une dimension linéaire

  1. Sélectionnez éventuellement une règle dans la Vue 3D.
  2. Il existe plusieurs façons d'invoquer la commande :
    • Appuyez sur le bouton Créer une cote.
    • 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 le bouton sélection d'un bord 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 les coordonnées et appuyez sur le bouton Entrez le point.
      • Choisissez un deuxième point dans la Vue 3D ou rentrez les coordonnées et appuyez sur le bouton Entrez le point.
  5. Pour positionner la ligne de cote, effectuez l'une des opérations suivantes :
    • Pour une cote alignée :
      • Choisissez un point dans la Vue 3D ou rentrez les coordonnées et appuyez sur le bouton Entrez le point.
    • Pour une dimension horizontale :
      • Déplacez le pointeur au-dessus ou au-dessous du bord ou des points.
      • Maintenez la touche Shift 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 Shift enfoncée, déplacez le pointeur et choisissez un point dans la Vue 3D.

Utilisation pour une dimension radiale

  1. Sélectionnez éventuellement un bord circulaire dans la Vue 3D.
  2. Il existe plusieurs façons d'invoquer la commande :
    • Appuyez sur le bouton Créer une cote.
    • 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 le bouton sélection d'un bord 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 cote, effectuez l'une des opérations suivantes :
    • Pour une cote de diamètre :
      • Choisissez un point dans la Vue 3D ou rentrez les 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 Créer une cote.
    • 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. 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 cotes, sélectionnez un point dans la Vue 3D.
  5. Selon les bords et le point choisi, l'angle affiché sera l'angle aigu (pointu) ou obtus (émoussé) entre les bords, ou l'angle d'un des bords avec l'horizontale. Dans certains cas, vous devrez d'abord ajouter une géométrie auxiliaire (Draft Lignes par exemple) pour obtenir un angle particulier.

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 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 T 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 Echap 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 d'invoquer la commande :
    • Appuyez sur le Créer une cote.
    • 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 éditées avec la commande Draft Editer.

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 ou ses sous-éléments auxquels la dimension est liée.
  • DonnéesNormal (Vector) : spécifie la normale du plan du texte.
  • Données (caché)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. Si cela change, le symbole utilisé dans VueOverride doit être mis à jour manuellement (de Ø à R ou vice versa). Non utilisé pour les dimensions linéaires.

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 (caché)Linked Geometry (LinkSubList) : non utilisé.
  • Données (caché)Normal (Vecteur) : spécifie la normale du plan de la dimension.
  • Données (caché)Support (Link) : non utilisé.

Vue

Annotation

  • VueAnnotation Style (Enumeration): specifies the annotation style applied to the dimension. See Draft AnnotationStyleEditor.
  • VueScale Multiplier (Float): specifies the general scaling factor applied to the dimension.

Display Options

  • VueDisplay Mode (Enumeration): specifies how the text is displayed. If it is 2D text the text will be displayed in a plane defined by the DonnéesNormal of the measurement. If it is 3D text the text will always face the camera. Note that these values are switched compared to Draft Texts. This is an inherited property.

Graphics

Vue

  • VueExt Lines : spécifie la longueur maximale des lignes d'attache allant des points de mesure à la ligne de cote.
  • VueExt Overshoot : spécifie la longueur supplémentaire des lignes d'attache au-delà de la ligne de cote.
  • VueDim Overshoot : spécifie la longueur supplémentaire ajoutée à la ligne de cote.
  • VueArrow Size : spécifie la taille du symbole affiché aux extrémités de la ligne de cote.
  • VueArrow 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".
  • VueFlip 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.
  • VueFont 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.
  • VueFont 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.
  • VueFlip Text : spécifie s'il faut retourner l'orientation du texte indiquant la mesure.
  • VueText 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.
  • VueText Spacing : spécifie l'espace entre le texte et la ligne de cote.
  • VueOverride : spécifie un texte personnalisé à afficher à la place de la mesure réelle. Utilisez la chaîne $ dim à l'intérieur du texte pour afficher la valeur de mesure.
  • VueDecimals : spécifie le nombre de décimales à afficher sur la mesure.
  • VueShow Unit : s'il s'agit de true, l'unité est affichée à côté de la valeur numérique de la mesure.
  • VueUnit 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. introduced in version 0.17

Text

  • VueFlip Text (Bool): specifies whether to flip the orientation of the text.
  • VueFont Name (Font): specifies the font used to draw the text. It can be a font name, such as Arial, a default style such as sans, serif or mono, a family such as Arial,Helvetica,sans, or a name with a style such as Arial:Bold. If the given font is not found on the system, a default font is used instead.
  • VueFont Size (Length): specifies the size of the letters. The text can be invisible in the 3D view if this value is very small.
  • VueOverride (String): specifies a custom text to display instead of the actual measurement. Use the string $dim inside the text to include the measurement.
  • VueText Position (VectorDistance): specifies the position of the text in absolute coordinates. [0, 0, 0] will display the text in its default position near the dimension line or arc.
  • VueText Spacing (Length): specifies the space between the text and the dimension line or arc.

Units

  • VueDecimals (Integer): specifies the number of decimal places to display for the measurement. Not used for angular dimensions.
  • VueShow Unit (Bool): specifies whether to display the unit next to the numerical value of the measurement. Not used for angular dimensions.
  • VueUnit Override (String): specifies the unit in which to express the measurement, for example, km, m, cm, mm, mi, ft, in or arch for arch units. Leave this blank to use the default unit. Not used for angular dimensions.

Script

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

L'outil Cote peut être utilisé à l'intérieur d'une macro et à partir de la console Python en utilisant la fonction suivante:

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 :

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 cote doit passer.
    • Tous les points sont définis par leur FreeCAD.Vector.

Pour créer une cote angulaire, utilisez la fonction 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()