Draft Text/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(10 intermediate revisions by the same user not shown)
Line 12: Line 12:
|Name=Draft Text
|Name=Draft Text
|Name/fr=Draft Texte
|Name/fr=Draft Texte
|MenuLocation=Draft → Texte
|MenuLocation=Annotation → Texte
|Workbenches=[[Draft_Module/fr|Draft]], [[Arch_Module/fr|Arch]]
|Workbenches=[[Draft_Module/fr|Draft]], [[Arch_Module/fr|Arch]]
|Shortcut={{KEY|T}} {{KEY|E}}
|Shortcut={{KEY|T}} {{KEY|E}}
Line 21: Line 21:
==Description==
==Description==


L'outil {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/fr|Draft Texte]]}} insère une zone de texte à plusieurs lignes à un endroit donné. Il utilise le [[Draft_Linestyle/fr|Draft Propriétés de ligne]] défini dans le [[Draft_Tray/fr|Draft La barre]].
L'outil {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/fr|Texte]]}} insère une zone de texte de plusieurs lignes à un endroit donné. Il utilise les [[Draft_Linestyle/fr|Draft Propriétés de ligne]] définies dans le [[Draft_Tray/fr|Draft La barre]].


'''Alternative''': pour créer une étiquette de texte avec un en-tête et une flèche, utilisez [[Draft Label/fr|Draft Etiquette]]. Pour créer du texte solide ou des lettres 3D, utilisez [[Draft ShapeString/fr|Draft Draft Formes à partir texte]] avec [[Part Extrude/fr|Part Extrusion]].
'''Alternative''': pour créer une étiquette de texte avec un en-tête et une flèche, utilisez [[Draft Label/fr|Draft Etiquette]]. Pour créer du texte solide ou des lettres 3D, utilisez [[Draft ShapeString/fr|Draft Draft Formes à partir texte]] avec [[Part Extrude/fr|Part Extrusion]].


[[Image:Draft_Text_example.jpg|400px]]
[[Image:Draft_Text_example.jpg|400px]]
{{Caption|Un simple point est nécessaire pour positionner le textBox}}
{{Caption|Un seul point est nécessaire pour positionner la zone de texte}}


'''Avertissement:''' Les textes créés avec [[Release notes 0.18/fr|version 0.18]] ne sont pas rétrocompatibles. Sauvegardez donc votre travail si vous essayez d'ouvrir les fichiers créés avec la version 0.18 avec des versions plus anciennes.
'''Avertissement:''' Les textes créés avec [[Release notes 0.18/fr|version 0.18]] ne sont pas rétrocompatibles. Sauvegardez donc votre travail si vous essayez d'ouvrir les fichiers créés avec la version 0.18 avec des versions plus anciennes.
Line 32: Line 32:
==Utilisation==
==Utilisation==


# Pressez la touche {{Button|[[Image:Draft_Text.svg|16px]] [[Draft Text/fr|Draft Text]]}} button, ou pressez les touches {{KEY|T}}, puis {{KEY|E}}
# Pressez la bouton {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/fr|Créer une annotation multiligne...]]}} ou appuyez sur les touches {{KEY|T}} puis {{KEY|E}}.
# Cliquez un point dans la vue 3D, ou tapez les [[Draft_Coordinates/fr|coordonnées]] et pressez le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point]]}}.
# Cliquez un point dans la vue 3D, ou tapez les [[Draft_Coordinates/fr|coordonnées]] et pressez le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/fr|Ajouter un point]]}}.
# Entrez le texte désiré, et tapez sur {{KEY|Entrée}} entre chaque ligne,
# Entrez le texte désiré et tapez sur {{KEY|Entrée}} entre chaque ligne,
# Pressez '''deux fois''' sur {{KEY|Entrée}}, (ce qui laisse la dernière ligne vide), ajoute le texte au document, et, ferme l'éditeur.
# Appuyez deux fois sur {{KEY|Entrée}} pour terminer l'opération.


==Options==
==Options==
Line 41: Line 41:
* 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.
* 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 le texte pour forcer la [[Draft_Snap/fr|capture]] de votre point au point de capture le plus proche, indépendamment de la distance.
* Maintenez la touche {{KEY|Ctrl}} enfoncée tout en plaçant le texte pour forcer la [[Draft_Snap/fr|capture]] de votre point au point de capture le plus proche, indépendamment de la distance.
* Pressez sur la {{KEY|Enter}} ou {{KEY|↓ Flèche du bas}} pour entrer la nouvelle ligne de texte.
* Pressez sur la {{KEY|Entrée}} ou {{KEY|↓ Flèche vers le bas}} pour entrer la nouvelle ligne de texte.
* Pressez sur la {{KEY|↑ Flèche du haut}} pour éditer la ligne de texte précédente.
* Pressez sur la {{KEY|↑ Flèche vers le haut}} pour éditer la ligne de texte précédente.
* Appuyez deux fois sur {{KEY|Entrée}} ou {{KEY|↓ Flèche du bas}} pour terminer l'édition du texte.
* Appuyez deux fois sur {{KEY|Entrée}} ou {{KEY|↓ Flèche vers le bas}} pour terminer l'édition du texte.
* Appuyez sur {{KEY|Esc}} ou sur le bouton {{Button|Fermer}} pour annuler la commande en cours.
* Appuyez sur {{KEY|Echap}} ou sur le bouton {{Button|Fermer}} pour annuler la commande en cours.


==Propriétés==
==Propriétés==
Line 55: Line 55:


=== Vue ===
=== Vue ===
* {{PropertyView/fr|Display Mode}}: Spécifie si le texte est aligné à la scène ou toujours face à la caméra
* {{PropertyView/fr|Display Mode}} : s'il s'agit d'un "texte 3D", le texte sera aligné sur les axes de la scène, et se trouvera initialement sur le plan XY ; s'il s'agit d'un "texte 2D", le texte sera toujours face à la caméra.
* {{PropertyView/fr|Font Name}}: La police de caractères à utiliser. Peut être un nom de police, comme "'''Arial'''", style par défaut, "'''sans'''", "'''serif'''" ou "'''mono'''", ou une série comme "'''Arial,Helvetica,sans'''", ou un nom avec un style comme "'''Arial:Bold'''". Si la police donnée, ne se trouve pas sur le système, une police générique est utilisée à la place.
* {{PropertyView/fr|Font 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:Bold". Si la police donnée n'est pas trouvée sur le système, une police générique est utilisée à la place.
* {{PropertyView/fr|Font Size}}: La dimension des lettres. Si l'objet texte est créé dans la vue arborescente mais qu'aucun texte n'est visible, augmentez la taille du texte jusqu'à ce qu'il soit visible.
* {{PropertyView/fr|Font Size}} : spécifie la taille des lettres. Si l'objet texte est créé dans l'arborescence mais qu'aucun texte n'est visible, augmentez la taille du texte jusqu'à ce qu'il soit visible.
* {{PropertyView/fr|Justification}}: Spécifie l'alignement du texte à gauche à droite ou an centre du point de base
* {{PropertyView/fr|Justification}} : spécifie si le texte est aligné à gauche, à droite ou au centre du point de base.
* {{PropertyView/fr|Line Spacing}}: Spécifie l'espace entre les lignes du texte
* {{PropertyView/fr|Line Spacing}} : spécifie l'espace entre les lignes de texte.
* {{PropertyView/fr|Rotation}}: Spécifie la rotation a appliquer au texte
* {{PropertyView/fr|Rotation Axis}}: Spécifie l'axe de rotation a utiliser


==Script==
==Script==
{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD scripts de base]].
{{Emphasis|Voir aussi:}} [[Draft_API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD Débuter avec les scripts]].


L'outil texte peut être utilisé dans les [[Macros/fr|macros]], et dans la console [[Python/fr|Python]], en utilisant la fonction suivante :
L'outil Texte peut être utilisé dans une [[Macros/fr|macro]] et à partir de la console [[Python/fr|Python]] en utilisant la fonction suivante :
{{Code|code=
{{Code|code=
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
}}
}}
* Crée un objet {{incode|Text}}, au {{incode|point}} donné, si un {{incode|FreeCAD.Vecteur}}.
* Crée un objet {{incode|Text}} à un {{incode|point}} défini par un {{incode|FreeCAD.Vector}}.
* {{incode|stringlist}} est une chaîne ou une liste de chaînes, s'il s'agit d'une liste, chaque élément est affiché dans sa propre ligne.
* {{incode|stringlist}} est une chaîne de caractères ou une liste de chaînes de caractères ; si c'est une liste, chaque élément est affiché sur sa propre ligne.
* Si {{incode|Screen}} est {{incode|True}}, la direction du texte fait toujours face à la vue, sinon, il se situe sur le plan X, Y.
* Si {{incode|screen}} est {{incode|True}}, le texte est toujours orienté dans la direction de la caméra, sinon il s'aligne sur les axes de la scène et se trouve dans le plan XY.


Le placement du {{incode|Texte}} peut être modifié en remplaçant son attribut {{incode|Placement}} ou en modifiant individuellement les attributs {{incode|Placement.Base}} et {{incode|Placement.Rotation}}.
L'emplacement du {{incode|Text}} peut être modifié en écrasant son attribut {{incode|Placement}} ou en écrasant individuellement ses attributs {{incode|Placement.Base}} et {{incode|Placement.Rotation}}.


Les propriétés d'affichage du {{incode|Texte}} peuvent être modifiées en remplaçant ses attributs. Par exemple, modifiez {{incode|ViewObject.FontSize}} avec la nouvelle taille en millimètres.
Les propriétés d'affichage de {{incode|Text}} peuvent être modifiées en écrasant ses attributs ; par exemple, écrasez {{incode|ViewObject.FontSize}} avec la nouvelle taille en millimètres.


Exemple:
Exemple:

Revision as of 10:06, 13 April 2021

Draft Texte

Emplacement du menu
Annotation → Texte
Ateliers
Draft, Arch
Raccourci par défaut
T E
Introduit dans la version
0.7
Voir aussi
Draft Etiquette, Draft Formes à partir texte

Description

L'outil Texte insère une zone de texte de plusieurs lignes à un endroit donné. Il utilise les Draft Propriétés de ligne définies dans le Draft La barre.

Alternative: pour créer une étiquette de texte avec un en-tête et une flèche, utilisez Draft Etiquette. Pour créer du texte solide ou des lettres 3D, utilisez Draft Draft Formes à partir texte avec Part Extrusion.

Un seul point est nécessaire pour positionner la zone de texte

Avertissement: Les textes créés avec version 0.18 ne sont pas rétrocompatibles. Sauvegardez donc votre travail si vous essayez d'ouvrir les fichiers créés avec la version 0.18 avec des versions plus anciennes.

Utilisation

  1. Pressez la bouton Créer une annotation multiligne... ou appuyez sur les touches T puis E.
  2. Cliquez un point dans la vue 3D, ou tapez les coordonnées et pressez le bouton Ajouter un point.
  3. Entrez le texte désiré et tapez sur Entrée entre chaque ligne,
  4. Appuyez deux fois sur Entrée pour terminer l'opération.

Options

  • 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 le texte pour forcer la capture de votre point au point de capture le plus proche, indépendamment de la distance.
  • Pressez sur la Entrée ou ↓ Flèche vers le bas pour entrer la nouvelle ligne de texte.
  • Pressez sur la ↑ Flèche vers le haut pour éditer la ligne de texte précédente.
  • Appuyez deux fois sur Entrée ou ↓ Flèche vers le bas pour terminer l'édition du texte.
  • Appuyez sur Echap ou sur le bouton Fermer pour annuler la commande en cours.

Propriétés

Données

  • DonnéesText: spécifie le contenu du bloc de texte en tant que liste, chaque élément de la liste, séparé par une virgule, indique une nouvelle ligne.
  • DonnéesPosition: Point de base du bloc de texte
  • DonnéesAngle: spécifie la rotation de la ligne de base de la première ligne du bloc de texte.
  • DonnéesAxis: spécifie l'axe à utiliser pour la rotation.

Vue

  • VueDisplay Mode : s'il s'agit d'un "texte 3D", le texte sera aligné sur les axes de la scène, et se trouvera initialement sur le plan XY ; s'il s'agit d'un "texte 2D", le texte sera toujours face à la caméra.
  • 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:Bold". 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 texte est créé dans l'arborescence mais qu'aucun texte n'est visible, augmentez la taille du texte jusqu'à ce qu'il soit visible.
  • VueJustification : spécifie si le texte est aligné à gauche, à droite ou au centre du point de base.
  • VueLine Spacing : spécifie l'espace entre les lignes de texte.

Script

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

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

Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
  • Crée un objet Text à un point défini par un FreeCAD.Vector.
  • stringlist est une chaîne de caractères ou une liste de chaînes de caractères ; si c'est une liste, chaque élément est affiché sur sa propre ligne.
  • Si screen est True, le texte est toujours orienté dans la direction de la caméra, sinon il s'aligne sur les axes de la scène et se trouve dans le plan XY.

L'emplacement du Text peut être modifié en écrasant son attribut Placement ou en écrasant individuellement ses attributs Placement.Base et Placement.Rotation.

Les propriétés d'affichage de Text peuvent être modifiées en écrasant ses attributs ; par exemple, écrasez ViewObject.FontSize avec la nouvelle taille en millimètres.

Exemple:

import FreeCAD, Draft

p1 = FreeCAD.Vector(0, 0, 0)
t1 = "This is a sample text"

p2 = FreeCAD.Vector(1000, 1000, 0)
t2 = ["First line", "second line"]

Text1 = Draft.makeText(t1, point=p1)
Text2 = Draft.makeText(t2, point=p2)
Text1.ViewObject.FontSize = 200
Text2.ViewObject.FontSize = 200

p3 = FreeCAD.Vector(-1000, -500, 0)
t3 = ["Upside", "down"]

Text3 = Draft.makeText(t3, point=p3)
Text3.ViewObject.FontSize = 200

ZAxis = FreeCAD.Vector(0, 0, 1)
place3 = FreeCAD.Placement(p3, FreeCAD.Rotation(ZAxis, 175))
Text3.Placement = place3

Text4 = Draft.makeText(t3, point=p3)
Text4.ViewObject.FontSize = 200
Text4.Placement.Rotation = FreeCAD.Rotation(ZAxis, -30)