Draft Étiquette

From FreeCAD Documentation
Revision as of 15:30, 6 March 2019 by Jpg87 (talk | contribs)

Label

Emplacement du menu
Draft → Label
Ateliers
Draft, Arch
Raccourci par défaut
D L
Introduit dans la version
0.17
Voir aussi
Draft Text, Draft ShapeString

Description

L'outil Label (Étiquette) insère une zone de texte multi-ligne avec une ligne de repère à 2 segments et une flèche. Si un objet ou un sous-élément (face, arête ou sommet) est sélectionné lors du lancement de la commande, l'étiquette peut afficher un certain attribut de l'élément sélectionné, notamment la position, la longueur, la surface, le volume ou le matériau.

Pour insérer un élément de texte plus simple sans flèche, utilisez Draft Texte. Pour créer des formes de texte solides, utilisez Draft ShapeString avec Part Extruder.

Différentes étiquettes avec des orientations différentes, des symboles d'extrémités et des informations

Utilisation

  1. Appuyez sur le bouton Draft Label, ou appuyez sur les touches D et L.
  2. Cliquez sur un premier point de la vue 3D ou tapez une coordonnée et appuyez sur le bouton Ajouter un point. Ce point indique la cible (tête de flèche). Cela peut être n'importe où, il n'est pas nécessaire que ce soit un élément.
  3. Cliquez sur un deuxième point de la vue 3D ou tapez une coordonnée et appuyez sur le bouton Ajouter un point. Ce point indique le début d'une ligne de repère horizontale ou verticale.
  4. Cliquez sur un troisième point de la vue 3D ou tapez une coordonnée et appuyez sur le bouton Ajouter un point. Ce point indique le point de base du texte.

Note: la direction du segment de droite horizontal, à droite ou à gauche, alignera automatiquement le texte dans la direction opposée. Si le texte passe verticalement vers le haut, le texte est aligné à gauche. s'il descend verticalement, il est aligné à droite.

Note 2: en présélectionnant un objet ou un sous-élément (sommet, arête ou face), avant d'appuyer sur le bouton d'outil, l'étiquette devient paramétrique, c'est-à-dire qu'elle se souviendra de l'objet auquel elle est liée et qu'elle pourra afficher un attribut particulier de cet objet. Si les attributs de l'objet changent ultérieurement, l'étiquette ajustera les informations affichées.

Options

  • Cliquez sur Template:Bouton pour sélectionner le type d'informations à afficher, notamment "Personnalisé", "Nom", "Etiquette", "Position", "Longueur", "Surface", "Volume", "Tag" et "Matériau".
  • 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 lorsque vous avez les valeurs souhaitées pour insérer le point.
  • Maintenez la touche Ctrl enfoncée tout en plaçant l’étiquette pour forcer l'accrochage de votre point au point d’accrochage le plus proche, indépendamment de la distance.
  • Appuyez sur Esc ou sur le bouton Fermer pour annuler la commande en cours.

Propriétés

Données

  • DonnéesType d'étiquette: spécifie le type d'information indiqué par cette étiquette (voir ci-dessous).
  • DonnéesTexte personnalisé: spécifie le bloc de texte à afficher lorsque DonnéesType d'étiquette est défini sur "Personnalisé" ou si l'étiquette n'est pas paramétrique. Le texte est donné sous forme de liste de chaînes; chaque élément de la liste, séparé par une virgule, indique une nouvelle ligne de texte.
  • DonnéesTexte: (en lecture seule) indique le texte actuel affiché par l'étiquette, en fonction du DonnéesType d'étiquette.
  • DonnéesPoint visé: spécifie la position de la pointe de la ligne de repère.
  • DonnéesDirection partie droite: spécifie la direction du segment de droite du repère, horizontal ou vertical.
  • DonnéesLongueur partie droite: spécifie la longueur du segment de droite du repère, à partir du point de base du texte. Si la distance est positive, le texte commence par le côté droit du texte et s'aligne à droite. sinon, le texte commence par le côté gauche du texte et le texte s'aligne à gauche.
  • DonnéesPosition: spécifie le point de base de la première ligne du bloc de texte; cela influence également la façon dont la ligne de repère est dessinée.
  • DonnéesAngle: spécifie la rotation de la ligne de base de la première ligne du bloc de texte. cela influence également la façon dont la ligne de repère est dessinée, car elle ne sera plus horizontale ni verticale.
  • DonnéesAxe: spécifie l'axe à utiliser pour la rotation.

Types d'étiquettes

  • Custom: Affiche le contenu de la propriété Custom Text
  • Nom: Affiche le nom de l'objet cible
  • Label: Affiche le label de l'objet cible
  • Position: affiche les coordonnées de l'objet cible (point de base de l'emplacement), ou les coordonnées du sommet cible, le cas échéant, ou les coordonnées du centre du sous-élément cible (centre de gravité)
  • Longueur: Affiche la longueur du sous-élément cible, si possible
  • Area: affiche la zone du sous-élément cible, si possible
  • Volume: Affiche le volume de l'objet cible, si possible
  • Tag: Affiche la valeur de la balise de l'objet cible, si l'objet cible a une telle propriété (ce qui est le cas de tous les objets Arch).
  • Material: Affiche l'étiquette du matériau de l'objet cible, si celui-ci a cette propriété.

View

  • VueText Font: specifies the font to use to draw the text. It can be a font name, such as "Arial", a default style such as "sans", "serif" or "mono", a family such as "Arial,Helvetica,sans" or a name with a style such as "Arial:Bold". If the given font is not found on the system, a generic one is used instead.
  • VueText Size: specifies the size of the text. If the label object is created in the tree view but no text is visible in the 3D view, increase the size of the text until it is visible.
  • VueText Alignment: specifies the vertical alignment of the baseline of the text with respect to the leader. It can be top, middle or bottom.
  • VueText Color: specifies the color of the text in an RGB tuple (R, G, B).
  • VueLine Width: specifies the width of the leader.
  • VueLine Color: specifies the color of the leader.
  • VueArrow Size: specifies the size of the symbol displayed at the tip of the leader.
  • VueArrow Type: specifies the type of symbol displayed at the tip of the leader, which can be dot, circle, arrow, or tick.
  • VueFrame: if it is "Rectangle" it will draw a frame around the text.
  • VueLine: if it is true the leader line will be displayed; otherwise only the text and the symbol at the tip will be displayed.
  • VueDisplay Mode: if it is "3D text" the text will be aligned to the scene axes, initially lying on the XY plane; if it is "2D text" the text will always face the camera.

Script

L'outil texte peut être utilisé dans les macros, et dans la console Python, en utilisant la fonction suivante :

The Label tool can be used in macros and from the Python console by using the following function:

Label = makeLabel(targetpoint=None, target=None, direction=None, distance=None, labeltype=None, placement=None)
  • Retourne le nouvel objet créé.

Change the custom text by overwriting the CustomText attribute. A list of strings can be used; each element will be displayed in its own line.

The view properties of Label can be changed by overwriting its attributes; for example, overwrite ViewObject.TextSize with the new size in millimeters.

Exemple:

import FreeCAD, Draft

Rectangle = Draft.makeRectangle(4000, 1000)

p1 = FreeCAD.Vector(-200, 1000, 0)
place1 = FreeCAD.Placement(FreeCAD.Vector(-1000, 1300, 0), FreeCAD.Rotation())

Label1 = Draft.makeLabel(p1, Rectangle, "Horizontal", 500, "Label", place1)
Label1.ViewObject.TextSize = 200

p2 = FreeCAD.Vector(-200, 0, 0)
place2 = FreeCAD.Placement(FreeCAD.Vector(-1000, -300, 0), FreeCAD.Rotation())

Label2 = Draft.makeLabel(p2, Rectangle, "Horizontal", 500, "Custom", place2)
Label2.CustomText = ["Beware of the", "sharp edges"]
Label2.ViewObject.TextSize = 200
FreeCAD.ActiveDocument.recompute()

p3 = FreeCAD.Vector(1000, 1200, 0)
place3 = FreeCAD.Placement(FreeCAD.Vector(2000, 1800, 0), FreeCAD.Rotation())

Label3 = Draft.makeLabel(p3, Rectangle, "Horizontal", -500, "Area", place3)
Label3.ViewObject.TextSize = 200
FreeCAD.ActiveDocument.recompute()