Draft Label/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "* {{PropertyData | Type d'étiquette}}: Le type d'information indiqué par cette étiquette (voir ci-dessous) * {{PropertyData | Custom Text}}: texte à afficher lorsque le ty...")
No edit summary
(42 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/fr
{{GuiCommand|Name=Draft Label|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft → Label|Shortcut=D L}}
|[[Draft CubicBezCurve/fr|Courbe de Bézier]]
|[[Draft_Move/fr|Déplacer]]
|[[Draft_Module/fr|Atelier Draft]]
|IconL=Draft CubicBezCurve.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Move.svg
}}

{{GuiCommand/fr
|Name=Draft Label
|Name/fr=Etiquette Draft
|MenuLocation=Draft → Etiquette
|Workbenches=[[Draft Module/fr|Atelier Draft]], [[Arch Module/fr|Atelier Arch]]
|Shortcut=D L
|SeeAlso=[[Draft Text/fr|Draft Texte]], [[Draft ShapeString/fr|Draft Formes à partir texte]]
|Version=0.17
}}


==Description==
==Description==


Cet outil insère une étiquette, qui est un morceau de texte avec une ligne à 2 segments et une flèche, dans le document actif. Si un objet ou un sous-élément (face, arête ou sommet) est sélectionné lors du lancement de la commande, vous pouvez configurer le l'étiquette pour afficher automatiquement un certain attribut de l'élément sélectionné.
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 Text/fr|Texte Draft]]. Pour créer des formes de texte solides, utilisez [[Draft ShapeString/fr|Formes à partir texte Draft]] avec [[Part Extrude/fr|Extrusion Part]].


[[Image:Draft_Label_example.jpg|400px]]
[[Image:Draft_Label_example.jpg|400px]]
{{Caption|Différentes étiquettes avec des orientations différentes, des symboles d'extrémités et des informations}}


==Utilisation==
==Utilisation==


# Appuyez sur le bouton {{Button|[[Image: Draft Label.png|16px]] [[Draft Label/fr|Etiquette Draft]]}}, ou appuyez sur les touches {{KEY|D}} et {{KEY|L}}.
# Facultativement, sélectionnez un objet ou un sous-élément d'un objet (sommet, arête ou face)
# Cliquez sur un premier point de la vue 3D ou tapez une [[Draft_Coordinates/fr|coordonnée]] et appuyez sur le bouton {{Button|[[Image: Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|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.
# Appuyez sur la touche , ou appuyez sur les touches {{KEY | D}} puis {{KEY | L}}.
# Cliquez sur un premier point de la vue 3D ou tapez une [[Draft_Coordinates|coordinate]] pour indiquer le point cible (position de la flèche). Cela peut être n'importe où, il n'est pas nécessaire que ce soit exactement sur l'élément sélectionné
# Cliquez sur un deuxième point de la vue 3D ou tapez une [[Draft_Coordinates/fr|coordonnée]] et appuyez sur le bouton {{Button|[[Image: Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point]]}}. Ce point indique le début d'une ligne de repère horizontale ou verticale.
# Cliquez sur un deuxième point de la vue 3D ou tapez une [[Draft_Coordinates|coordinate]] pour indiquer le point central qui correspond au début du segment de droite.
# Cliquez sur un troisième point de la vue 3D ou tapez une [[Draft_Coordinates/fr|coordonnée]] et appuyez sur le bouton {{Button|[[Image: Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point]]}}. Ce point indique le point de base du texte.

# Cliquez sur un troisième point de la vue 3D ou tapez une [[Draft_Coordinates|coordinate]], pour indiquer la position du texte.
{{emphasis|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.

{{emphasis|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==
==Options==


* Cliquez sur {{Button|Type d'étiquette}} pour sélectionner le type d'informations à afficher, notamment "Personnalisé", "Nom", "Etiquette", "Position", "Longueur", "Surface", "Volume", "Tag" et "Matériau".
* Appuyez sur {{KEY | CTRL}} pour que [[Draft_Snap | snap]] pointe sur les emplacements de capture disponibles.
* Pour entrer les coordonnées manuellement, entrez simplement les nombres, puis appuyez sur {{KEY | ENTER}} entre chaque composante X, Y et Z.
* 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]]}} lorsque vous avez les valeurs souhaitées pour insérer le point.
* Maintenez la touche {{KEY|Ctrl}} enfoncée tout en plaçant l’étiquette pour forcer [[Draft_Snap/fr|l'accrochage]] de votre point au point d’accrochage le plus proche, indépendamment de la distance.
* Appuyez sur {{KEY | ESC}} pour annuler l'opération.
* Appuyez sur {{KEY|Esc}} ou sur le bouton {{button|Fermer}} pour annuler la commande en cours.
* La direction du segment de droite (droite ou gauche) justifiera automatiquement le texte à gauche ou à droite.


==Propriétés==
==Propriétés==


=== Données ===
* {{PropertyData | Type d'étiquette}}: Le type d'information indiqué par cette étiquette (voir ci-dessous)
* {{PropertyData | Custom Text}}: texte à afficher lorsque le type d'étiquette est défini sur custom
* {{PropertyData/fr|Type d'étiquette}}: spécifie le type d'information indiqué par cette étiquette (voir ci-dessous).
* {{PropertyData/fr|Texte personnalisé}}: spécifie le bloc de texte à afficher lorsque {{PropertyData/fr|Type 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.
* {{PropertyData | Placement}}: Indique la rotation et la position du texte.
* {{PropertyData/fr|Texte}}: (en lecture seule) indique le texte actuel affiché par l'étiquette, en fonction du {{PropertyData/fr|Type d'étiquette}}.
* {{PropertyData | Straight Distance}}: la longueur du segment de droite
* {{PropertyData | Direction droite}}: direction du segment de droite, horizontal ou vertical
* {{PropertyData/fr|Point visé}}: spécifie la position de la pointe de la ligne de repère.
* {{PropertyData | Target Point}}: Le point indiqué par cette étiquette
* {{PropertyData/fr|Direction partie droite}}: spécifie la direction du segment de droite du repère, horizontal ou vertical.
* {{PropertyData/fr|Longueur 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.
* {{PropertyView | Text Size}}: La taille du texte
* {{PropertyData/fr|Position}}: 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.
* {{PropertyView | Text Font}}: la police utilisée pour le texte.
* {{PropertyData/fr|Angle}}: 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.
* {{PropertyView | Text Alignment}}: l'alignement vertical du texte: haut, milieu ou bas
* {{PropertyData/fr|Axe}}: spécifie l'axe à utiliser pour la rotation.
* {{PropertyView | Couleur du texte}}: La couleur du texte
* {{PropertyView | Line Width}}: La largeur de la ligne
* {{PropertyView | Line Line}}: La couleur de la ligne
* {{PropertyView | Type de flèche}}: type de la flèche: point, cercle, flèche ou tick.
* {{PropertyView | Arrow Size}}: La taille de la flèche
* {{PropertyView | Frame}}: Dessine un cadre autour du texte.


== Label types ==
==== Types d'étiquettes ====


* {{Emphasis | Custom:}} affiche le contenu de {{PropertyData/fr|Texte personnalisé}}.
* '''Custom''': Shows the contents of the Custom Text property
* {{Emphasis | Name:}} affiche le nom interne de l'objet cible; le nom interne est attribué à l'objet au moment de sa création et reste fixe tout au long de son existence.
* '''Name''': Shows the name of the target object
* {{Emphasis | Label:}} affiche l'étiquette de l'objet cible. l'étiquette de l'objet peut être modifiée à tout moment par l'utilisateur.
* '''Label''': Shows the label of the target object
* {{Emphasis | Position:}} affiche les coordonnées du point de base de l'objet cible, du sommet cible ou du centre de masse du sous-élément cible, le cas échéant.
* '''Position''': Shows the coordinates of the target object (Placement base point), or the coordinates of the target vertex, if applicable, or the coordinates of the center of the target subelement (center of mass)
* {{Emphasis | Length:}} affiche la longueur du sous-élément cible, le cas échéant.
* '''Length''': Shows the length of the target subelement, if possible
* {{Emphasis | Area:}} affiche la zone du sous-élément cible, le cas échéant.
* '''Area''': Shows the area of the target subelement, if possible
* '''Volume''': Shows the volume of the target object, if possible
* {{Emphasis | Volume:}} affiche le volume de l'objet cible, le cas échéant.
* {{Emphasis | Tag:}} affiche l'attribut {{incode | Tag}} de l'objet cible, si l'objet a cette propriété, par exemple, les objets créés avec [[Arch Workbench/fr|Arch]].
* '''Tag''': Shows the tag value of the target object, if the target object has such property (which is the case of all Arch objects)
* {{Emphasis | Material:}} affiche l'étiquette du matériau de l'objet cible, si celui-ci possède une telle propriété.
* '''Material''': Shows the label of the material of the target object, if the target object has such property


==Scripting==
=== Vue ===
* {{PropertyView/fr|Police}}: 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.
The Text tool can by used in [[macros]] and from the python console by using the following function:
* {{PropertyView/fr|Taille du texte}}: spécifie la taille du texte. Si l'objet étiquette est créé dans la vue arborescente mais qu'aucun texte n'est visible dans la vue 3D, augmentez la taille du texte jusqu'à ce qu'il soit visible.
* {{PropertyView/fr|Alignement du texte}}: spécifie l'alignement vertical de la ligne de base du texte par rapport au texte principal. Cela peut être haut, milieu ou bas.
* {{PropertyView/fr|Couleur du texte}}: spécifie la couleur du texte dans un tuple RVB (R, V, B).
* {{PropertyView/fr|Largeur de ligne}}: spécifie la largeur de la ligne de repère.
* {{PropertyView/fr|Couleur de ligne}}: spécifie la couleur de la ligne de repère.
* {{PropertyView/fr|Taille de la flèche}}: spécifie la taille du symbole affiché à l'extrémité de la ligne de repère.
* {{PropertyView/fr|Type de flèche}}: spécifie le type de symbole affiché à l'extrémité de la ligne de repère, qui peut être un point, un cercle, une flèche ou une coche.
* {{PropertyView/fr|Cadre}}: s'il s'agit d'un "Rectangle", il tracera un cadre autour du texte.
* {{PropertyView/fr|Ligne}}: s'il s'agit de {{TRUE}}, la ligne de repère sera affichée. sinon, seuls le texte et le symbole au sommet seront affichés.
* {{PropertyView/fr|Mode d'affichage}}: s'il s'agit d'un "texte 3D", le texte sera aligné sur les axes de la scène, initialement situé sur le plan XY; s'il s'agit d'un "texte 2D", le texte sera toujours face à la caméra.

==Script==
{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD scripts de base]].

L'outil Label peut être utilisé dans une [[macros/fr|macro]] et dans la console [[Python/fr|Python]] en utilisant la fonction suivante :
{{Code|code=
{{Code|code=
makeLabel(targetpoint=None,target=None,direction=None,distance=None,labeltype=None,placement=None)
Label = makeLabel(targetpoint=None, target=None, direction=None, distance=None, labeltype=None, placement=None)
}}
}}


* Crée un objet {{incode | Label}}, la ligne de repère pointant sur {{incode | targetpoint}} et un lien vers l'objet {{incode | cible}} qui doit être un {{incode | DocumentObject}} ({ {emphasis | Editor:}} ou un SelectionObject? Ce n'est pas clair).
* Returns the newly created object.
* {{incode|direction}} est "Horizontal", "Vertical", ou "Custom".
* {{incode|distance}} est la distance entre le point de base du texte et la ligne de repère.
* {{incode|labeltype}} est l'un des "Custom", "Name", "Label", "Position", "Length", "Area", "Volume", "Tag", ou "Material".
* Si un {{incode|placement}} est donné, il est utilisé pour le point de base du texte; sinon le texte est créé à l'origine.


Modifiez le texte personnalisé en remplaçant l'attribut {{incode | CustomText}}. Une liste de chaînes peut être utilisée; chaque élément sera affiché dans sa propre ligne.
Example:

Les propriétés de vue de {{incode | Label}} peuvent être modifiées en remplaçant ses attributs. Par exemple, écrasez {{incode | ViewObject.TextSize}} avec la nouvelle taille en millimètres.

Exemple:
{{Code|code=
{{Code|code=
import FreeCAD,Draft
import FreeCAD, Draft

selection = FreeCADGui.Selection.getSelectionEx()[0]
Rectangle = Draft.makeRectangle(4000, 1000)
Draft.makeLabel(FreeCAD.Vector(10,-10,0),selection,"Horizontal",20,"Label")

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


{{Docnav/fr
|[[Draft CubicBezCurve/fr|Courbe de Bézier]]
|[[Draft_Move/fr|Déplacer]]
|[[Draft_Module/fr|Atelier Draft]]
|IconL=Draft CubicBezCurve.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Move.svg
}}

{{Draft Tools navi/fr}}

{{Userdocnavi/fr}}
{{clear}}
{{clear}}

Revision as of 09:40, 9 November 2019

Etiquette Draft

Emplacement du menu
Draft → Etiquette
Ateliers
Atelier Draft, Atelier Arch
Raccourci par défaut
D L
Introduit dans la version
0.17
Voir aussi
Draft Texte, Draft Formes à partir texte

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 Texte Draft. Pour créer des formes de texte solides, utilisez Formes à partir texte Draft avec Extrusion Part.

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

Utilisation

  1. Appuyez sur le bouton Etiquette Draft, 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 Type d'étiquette 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 DonnéesTexte personnalisé.
  • Name: affiche le nom interne de l'objet cible; le nom interne est attribué à l'objet au moment de sa création et reste fixe tout au long de son existence.
  • Label: affiche l'étiquette de l'objet cible. l'étiquette de l'objet peut être modifiée à tout moment par l'utilisateur.
  • Position: affiche les coordonnées du point de base de l'objet cible, du sommet cible ou du centre de masse du sous-élément cible, le cas échéant.
  • Length: affiche la longueur du sous-élément cible, le cas échéant.
  • Area: affiche la zone du sous-élément cible, le cas échéant.
  • Volume: affiche le volume de l'objet cible, le cas échéant.
  • Tag: affiche l'attribut Tag de l'objet cible, si l'objet a cette propriété, par exemple, les objets créés avec Arch.
  • Material: affiche l'étiquette du matériau de l'objet cible, si celui-ci possède une telle propriété.

Vue

  • VuePolice: 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.
  • VueTaille du texte: spécifie la taille du texte. Si l'objet étiquette est créé dans la vue arborescente mais qu'aucun texte n'est visible dans la vue 3D, augmentez la taille du texte jusqu'à ce qu'il soit visible.
  • VueAlignement du texte: spécifie l'alignement vertical de la ligne de base du texte par rapport au texte principal. Cela peut être haut, milieu ou bas.
  • VueCouleur du texte: spécifie la couleur du texte dans un tuple RVB (R, V, B).
  • VueLargeur de ligne: spécifie la largeur de la ligne de repère.
  • VueCouleur de ligne: spécifie la couleur de la ligne de repère.
  • VueTaille de la flèche: spécifie la taille du symbole affiché à l'extrémité de la ligne de repère.
  • VueType de flèche: spécifie le type de symbole affiché à l'extrémité de la ligne de repère, qui peut être un point, un cercle, une flèche ou une coche.
  • VueCadre: s'il s'agit d'un "Rectangle", il tracera un cadre autour du texte.
  • VueLigne: s'il s'agit de true, la ligne de repère sera affichée. sinon, seuls le texte et le symbole au sommet seront affichés.
  • VueMode d'affichage: s'il s'agit d'un "texte 3D", le texte sera aligné sur les axes de la scène, initialement situé sur le plan XY; s'il s'agit d'un "texte 2D", le texte sera toujours face à la caméra.

Script

Voir aussi: Draft API et FreeCAD scripts de base.

L'outil Label peut être utilisé dans une macro et dans la console Python en utilisant la fonction suivante :

Label = makeLabel(targetpoint=None, target=None, direction=None, distance=None, labeltype=None, placement=None)
  • Crée un objet Label, la ligne de repère pointant sur targetpoint et un lien vers l'objet cible qui doit être un DocumentObject ({ {emphasis | Editor:}} ou un SelectionObject? Ce n'est pas clair).
  • direction est "Horizontal", "Vertical", ou "Custom".
  • distance est la distance entre le point de base du texte et la ligne de repère.
  • labeltype est l'un des "Custom", "Name", "Label", "Position", "Length", "Area", "Volume", "Tag", ou "Material".
  • Si un placement est donné, il est utilisé pour le point de base du texte; sinon le texte est créé à l'origine.

Modifiez le texte personnalisé en remplaçant l'attribut CustomText. Une liste de chaînes peut être utilisée; chaque élément sera affiché dans sa propre ligne.

Les propriétés de vue de Label peuvent être modifiées en remplaçant ses attributs. Par exemple, écrasez ViewObject.TextSize avec la nouvelle taille en millimètres.

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