|
Emplacement du menu |
---|
Annotation → Étiquette |
Ateliers |
Draft, BIM |
Raccourci par défaut |
D L |
Introduit dans la version |
0.17 |
Voir aussi |
Draft Texte, Draft Forme à partir d'un texte |
La commande Draft Étiquette crée un texte de plusieurs lignes avec une ligne d'attache à deux segments et une flèche.
Si un objet ou un sous-élément (face, arête ou sommet) est sélectionné au lancement de la commande, on peut faire en sorte que le texte affiche un ou deux attributs de l'élément sélectionné, notamment la position, la longueur, l'aire, le volume et le matériau. Le texte sera alors lié aux attributs et sera mis à jour si leurs valeurs changent.
Pour insérer un élément de texte sans flèche, utilisez plutôt la commande Draft Texte.
Différentes étiquettes avec différentes orientations, flèches et informations
Voir aussi : Draft La barre, Draft Aimantation et Draft Contrainte.
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.
Les types d'étiquettes suivants sont disponibles :
Custom
: affiche le contenu de DonnéesCustom Text.Name
: affiche le nom interne de l'objet cible. Le nom interne est attribué lors de la création de l'objet et reste fixe pendant toute l'existence de l'objet.Label
: affiche le libellé de l'objet cible. Le libellé d'un objet peut être modifié par l'utilisateur.Position
: affiche les coordonnées du point de base de l'objet cible ou du sommet cible.Length
: affiche la longueur de l'objet ou du sous-élément cible.Area
: affiche la surface de l'objet ou du sous-élément cible.Volume
: affiche le volume de l'objet cible.Tag
: affiche l'attribut Tag
de l'objet cible. Les objets créés avec l'atelier BIM peuvent avoir cet attribut.Material
: affiche le libellé du matériau de l'objet cible.Label + Position
: affiche le libellé du matériau de l'objet cible.Label + Length
Label + Area
Label + Volume
Label + Material
Voir aussi : Éditeur de propriétés
Un objet Draft Etiquette 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 :
Base
StringList
) : spécifie le contenu du texte si DonnéesLabel Type est Custom
(personnalisé). Chaque élément de la liste représente une nouvelle ligne de texte.Enumeration
) : spécifie le type d'information affiché par l'étiquette. Voir Types d'étiquettes.Placement
) : spécifie la position du texte dans la vue 3D et, à moins que DonnéesStraight Direction ne soit Custom
(personnalisé), également du premier segment de l'attache, qui est le segment où le texte est rattaché. Voir Placement.StringList
) : (en lecture seule) spécifie le contenu du texte qui est effectivement affiché. Chaque élément de la liste représente une nouvelle ligne de texte.Leader
VectorList
) : spécifie les points de l'attache.Enumeration
) : spécifie la direction du premier segment de l'attache : Custom
, Horizontal
ou Vertical
.Distance
) : spécifie la longueur du premier segment de l'attache. Utilisé uniquement si DonnéesStraight Direction est Horizontale
ou Verticale
. Si la distance est positive, l'attache part du côté droit du texte et le texte s'aligne sur la droite. Sinon, l'attache part du côté gauche du texte et le texte s'aligne sur la gauche.Target
LinkSub
) : spécifie l'objet et le sous-élément facultatif auquel l'étiquette est liée.Vector
) : spécifie la position de la pointe de l'attache, qui est l'endroit où la flèche est attachée.
Annotation
Enumeration
) : spécifie le style d'annotation appliqué à l'étiquette. Voir Draft Éditer le style des annotations.Float
) : spécifie le facteur d'échelle général appliqué à l'étiquette.Display Options
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éesPlacement de l'étiquette. 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
Length
) : spécifie la taille du symbole affiché à l'extrémité de l'attache.Enumeration
) : spécifie le type de symbole affiché à l'extrémité de l'attache, qui peut être Dot
, Circle
, Arrow
, Tick
ou Tick-2
.Enumeration
) : spécifie le type de cadre dessiné autour du texte. Les options pour le moment sont None
ou Rectangle
.Bool
) : indique s'il faut afficher la ligne d'attache. S'il est false
, seuls la flèche et le texte sont affichés.Color
) : spécifie la couleur de l'attache et de la flèche. Également utilisée pour le cadre.Float
) : spécifie la largeur de l'attache. Également utilisé pour le cadre.Text
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. introduit dans la version 0.21Length
) : spécifie la taille des lettres. Le texte peut être invisible dans la vue 3D si cette valeur est très petite. introduit dans la version 0.21Enumeration
) : spécifie l'alignement horizontal du texte : Left
, Center
ou Right
. Utilisé uniquement si DonnéesStraight Direction est Custom
(personnalisée). Sinon, l'alignement horizontal est basé sur le signe (positif ou négatif) de DonnéesStraight Distance.Float
) : spécifie le facteur appliqué à la hauteur de ligne par défaut du texte.Integer
) : spécifie le nombre maximum de caractères sur chaque ligne du texte.Enumeration
) : spécifie l'alignement vertical du texte : Top
, Middle
ou Bottom
.Color
) : spécifie la couleur du texte.
Voir aussi : Autogenerated API documentation et FreeCAD Débuter avec les scripts.
Pour créer une Draft Étiquette, utilisez la méthode make_label
(introduit dans la version 0.19) du module Draft. Cette méthode remplace la méthode dépréciée makeLabel
.
label = make_label(target_point=App.Vector(0, 0, 0),
placement=App.Vector(30, 30, 0),
target_object=None, subelements=None,
label_type="Custom", custom_text="Label",
direction="Horizontal", distance=-10,
points=None)
Exemple :
import FreeCAD as App
import Draft
doc = App.newDocument()
rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()
p1 = App.Vector(-200, 1000, 0)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())
label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.FontSize= 200
p2 = App.Vector(-200, 0, 0)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())
label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
custom_text="Beware of the sharp edges")
label2.ViewObject.FontSize= 200
p3 = App.Vector(1000, 1200, 0)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())
label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.FontSize= 200
doc.recompute()