Draft Dimension

From FreeCAD Documentation
Revision as of 13:03, 19 May 2021 by David69 (talk | contribs) (Created page with "=== Utilisation pour une dimension linéaire ===")

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

L'outil 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.

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, ou par les opérations Part Congés, Sketcher Congés, et 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 Atelier Techdraw à l'aide des outils Nouvelle vue d'un objet Draft TechDraw ou Nouvelle vue Arch TechDraw. TechDraw dispose également de ses propres outils pour afficher les dimensions, tels que Longueur TechDraw et 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.

Dimension définie par trois points

Créer

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

Utilisation pour une dimension linéaire

  1. Lancez la commande Dimension Draft de l'outil de plusieurs manières :
    • Appuyez sur le bouton Draft Dimension dans la barre d'outils Draft,
    • Utilisez le raccourci clavier D puis I
    • Utilisez l'entrée Draft → Dimension dans le menu Draft
  2. Cliquez sur un point dans la vue 3D ou saisissez une coordonnée et appuyez sur la Ajouter un point Draft bouton.
  3. Cliquez sur un deuxième point dans la vue 3D ou saisissez une coordonnée et appuyez sur la Ajouter un point Draft bouton. Les deux premiers points définissent la distance mesurée.
  4. Cliquez sur un troisième dans la vue 3D ou saisissez une coordonnée et appuyez sur la Ajouter un point Draft bouton. Le point final définit la position de la ligne de mesure.

Usage radial dimension

  1. Optionally select a circular edge in the 3D view.
  2. There are several ways to invoke the command:
    • Press the Draft Dimension button.
    • Select the Annotation → Dimension option from the menu.
    • Use the keyboard shortcut: D then I.
  3. The Dimension task panel opens. See Options for more information.
  4. If you have not yet selected an edge do one of the following:
    • Press the select edge button and select a circular edge in the 3D view.
    • Hold down the Alt key, select a circular edge in the 3D view and release the Alt key.
  5. To position the dimension line do one of the following:
    • For a diameter dimension:
    • For a radial dimension:
      • Hold down the Shift key and pick a point in the 3D view.

Usage angular dimension

  1. There are several ways to invoke the command:
    • Press the Draft Dimension button.
    • Select the Annotation → Dimension option from the menu.
    • Use the keyboard shortcut: D then I.
  2. The Dimension task panel opens. See Options for more information.
  3. Hold down the Alt key, select two straight edges in the 3D view and release the Alt key.
  4. To position the dimension arc pick a point in the 3D view.
  5. 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 Lines for example) to get a particular angle.

Options

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.

  • Appuyez sur X, Y ou Z après un point pour contraindre le point suivant sur l'axe donné.
  • Pour entrer les coordonnées manuellement, entrez simplement les chiffres, puis appuyez sur Entrée entre chaque composante X, Y et Z. Vous pouvez appuyer sur le bouton Ajouter un point Draft lorsque vous avez les valeurs souhaitées pour insérer le point.
  • Appuyez sur 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 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.
  • Maintenez la touche Ctrl pendant que vous dessinez pour forcer Accrochage Draft votre point au point de capture le plus proche, indépendamment de la distance.
  • Maintenez la touche Shift pendant que vous dessinez sur 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 Echapp ou sur le bouton Fermer pour abandonner la commande en cours, puis terminez les dimensions continuées. Les dimensions déjà placées le resteront.

Convert

Usage

  1. Select one or more Std MeasureDistance objects.
  2. There are several ways to invoke the command:
    • Press the Draft Dimension button.
    • Select the Annotation → Dimension option from the menu.
    • Use the keyboard shortcut: D then I.
  3. Each selected object is replaced by a non-parametric linear Draft Dimension.

Notes

La dimension peut être modifiée en double-cliquant sur l'élément dans la vue arborescente ou en appuyant sur le bouton Éditer Draft. Ensuite, vous pouvez déplacer les points vers une nouvelle position.

Propriétés

See also: Property editor.

A Draft Dimension object is derived from an App FeaturePython object and inherits all its properties. The following properties are additional unless otherwise stated:

Data linear and radial dimension

Dimension

Données

  • DonnéesStart : Le point de départ de la cote
  • DonnéesEnd : Le point final de la cote
  • DonnéesDimline : Le point donnant la valeur de la dimension de la ligne de cote
  • DonnéesDistance : (en lecture seule) indique la longueur mesurée.
  • DonnéesDiameter : 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.

Linear/radial dimension

  • DonnéesDirection (Vector): specifies the direction of the measurement.
  • DonnéesDistance (Length): (read-only) specifies the value of the measurement.
  • DonnéesEnd (VectorDistance): specifies the end point of the measurement.
  • DonnéesStart (VectorDistance): specifies the start point of the measurement.

Radial dimension

  • DonnéesDiameter (Bool): specifies if a radial dimension is displayed as a diameter dimension. If it changed the symbol used in VueOverride must be updated manually (from Ø to R or vice versa). Not used for linear dimensions.

Data angular dimension

Angular dimension

  • DonnéesAngle (Angle): (read-only) specifies the value of the measurement.
  • DonnéesCenter (VectorDistance): specifies the center of the measurement.
  • DonnéesFirst Angle (Angle): specifies the start angle of the measurement.
  • DonnéesLast Angle (Angle): specifies the end angle of the measurement.

Dimension

  • DonnéesDimline (VectorDistance): specifies the point through which the dimension arc passes.
  • Données (hidden)Linked Geometry (LinkSubList): not used.
  • Données (hidden)Normal (Vector): specifies the normal of the plane of the dimension.
  • Données (hidden)Support (Link): not used.

View

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.

Scripting

Script

Voir aussi : Draft API et FreeCAD scripts de base.

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