Draft Text/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(107 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_Rectangle/fr|Rectangle]]
|[[Draft_Hatch/fr|Hachure]]
|[[Draft_Dimension/fr|Cote]]
|[[Draft_Dimension/fr|Dimension]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Rectangle.svg
|IconL=Draft_Hatch.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Dimension.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}
}}


{{GuiCommand/fr
{{GuiCommand/fr
|Name=Draft Text
|Name=Draft Text
|Name/fr=Draft Texte
|Name/fr=Draft Texte
|MenuLocation=Annotation → Texte
|Workbenches=[[Draft Module/fr|Draft]], [[Arch Module/fr|Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|MenuLocation=Draft → Texte
|Shortcut={{KEY|T}} {{KEY|E}}
|Shortcut={{KEY|T}} {{KEY|E}}
|SeeAlso=[[Draft Label/fr|Draft Etiquette]], [[Draft ShapeString/fr|Draft Formes à partir texte]]
|Version=0.7
|Version=0.7
|SeeAlso=[[Draft_Label/fr|Draft Étiquette]], [[Draft_ShapeString/fr|Draft Forme à partir d'un texte]]
}}
}}


==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]].
La commande [[Image:Draft_Text.svg|24px]] '''Draft Texte''' crée un texte de plusieurs lignes à un endroit donné.


'''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]].
Pour créer un élément de texte avec une flèche, utilisez plutôt la commande [[Draft_Label/fr|Draft Étiquette]].


[[Image:Draft_Text_example.jpg|400px]]
[[Image:Draft_Text_example.png|400px]]
{{Caption|Un simple point est nécessaire pour positionner le textBox}}
{{Caption|Un seul point est nécessaire pour positionner le 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.


<span id="Usage"></span>
==Utilisation==
==Utilisation==


Voir aussi : [[Draft_Tray/fr|Draft La barre]] et [[Draft_Snap/fr|Draft Aimantation]].
# Pressez la touche {{Button|[[Image:Draft Text.png|16px]] [[Draft Text/fr|Draft Text]]}} button, ou pressez 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]]}}.
# Il existe plusieurs façons de lancer la commande :
# Entrez le texte désiré, et tapez sur {{KEY|Entrée}} entre chaque ligne,
#* Appuyez sur le bouton {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/fr|Texte]]}}.
# Pressez '''deux fois''' sur {{KEY|Entrée}}, (ce qui laisse la dernière ligne vide), ajoute le texte au document, et, ferme l'éditeur.
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Text.svg|16px]] Texte}} dans le menu.
#* Utilisez le raccourci clavier : {{KEY|T}} puis {{KEY|E}}.
# Le panneau de tâches {{MenuCommand|Text}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.
# Choisissez un point dans la [[3D_view/fr|Vue 3D]] ou rentrez des coordonnées et appuyez sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}}.
# Saisissez le texte souhaité, appuyez sur {{KEY|Entrée}} pour commencer une nouvelle ligne.
# Appuyez deux fois sur {{KEY|Entrée}} ou sur le bouton {{Button|[[Image:Button_valid.svg|16px]] Insérer du texte}} pour terminer la commande.


==Options==
==Options==


Les raccourcis clavier à caractère unique disponibles dans le panneau des tâches peuvent être modifiés. Voir [[Draft_Preferences/fr|Draft Préférences]]. Les raccourcis mentionnés ici sont les raccourcis par défaut. (pour la version 0.22).
* 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.
* Pour saisir manuellement des coordonnées, entrez les valeurs de X, Y et Z et appuyez sur {{KEY|Entrée}} après chacune, ou vous pouvez appuyer sur le bouton {{Button|[[Image:Draft_AddPoint.svg|16px]] Entrez le point}} lorsque vous avez les valeurs souhaitées. Il est conseillé de déplacer le pointeur hors de la [[3D_view/fr|vue 3D]] avant de saisir les coordonnées.
* Pressez sur la {{KEY|Enter}} ou {{KEY|↓ Flèche du bas}} pour entrer la nouvelle ligne de texte.
* Appuyez sur {{KEY|G}} ou cliquez sur la case {{MenuCommand|Global}} pour basculer en mode global. Si le mode global est activé, les coordonnées sont relatives au système de coordonnées global, sinon elles sont relatives au système de coordonnées du [[Draft_SelectPlane/fr|plan de travail]]. {{Version/fr|0.20}}
* Pressez sur la {{KEY|↑ Flèche du haut}} pour éditer la ligne de texte précédente.
* Appuyez sur {{KEY|N}} ou cliquez sur la case {{MenuCommand|Continuer}} pour activer le mode continu. Si le mode continu est activé, la commande redémarre après avoir terminé, ce qui vous permet de continuer à créer des textes. Le raccourci ne fonctionne pas dans le deuxième panneau de tâches. Cette option n'est pas disponible dans le premier panneau de tâches dans FreeCAD version 0.19 et antérieure.
* Appuyez deux fois sur {{KEY|Entrée}} ou {{KEY|↓ Flèche du 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|S}} pour activer ou désactiver [[Draft_Snap/fr|Draft Aimantation]].
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour interrompre la commande.

<span id="Notes"></span>
==Remarques==

* Un Draft Texte peut être édité en double-cliquant dessus dans l'arborescence. {{Version/fr|0.20}}
* Les Draft Textes créés ou sauvegardés avec la [[Release_notes_0.21/fr|version 0.21 de FreeCAD]] ne sont pas rétrocompatibles.


<span id="Properties"></span>
==Propriétés==
==Propriétés==


Voir aussi : [[Property_editor/fr|Éditeur de propriétés]]
=== Données ===
* {{PropertyData/fr|Text}}: 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.
* {{PropertyData/fr|Position}}: Point de base du bloc de texte
* {{PropertyData/fr|Angle}}: spécifie la rotation de la ligne de base de la première ligne du bloc de texte.
* {{PropertyData/fr|Axis}}: spécifie l'axe à utiliser pour la rotation.


Un objet Draft Texte est dérivé d'un objet [[App_FeaturePython/fr|App FeaturePython]] et hérite de toutes ses propriétés. Les propriétés suivantes sont supplémentaires, sauf indication contraire :

<span id="Data"></span>
===Données===

{{TitleProperty|Base}}

* {{PropertyData|Placement|Placement}} : spécifie la position du texte dans la [[3D_view/fr|Vue 3D]]. Voir [[Placement/fr|Placement]].
* {{PropertyData|Text|StringList}} : spécifie le contenu du texte. Chaque élément de la liste représente une nouvelle ligne de texte.

<span id="View"></span>
=== Vue ===
=== Vue ===
* {{PropertyView/fr|Display Mode}}: Spécifie si le texte est aligné à la scène ou 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 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|Justification}}: Spécifie l'alignement du texte à gauche à droite ou an centre du point de base
* {{PropertyView/fr|Line Spacing}}: Spécifie l'espace entre les lignes du texte
* {{PropertyView/fr|Rotation}}: Spécifie la rotation a appliquer au texte
* {{PropertyView/fr|Rotation Axis}}: Spécifie l'axe de rotation a utiliser


{{TitleProperty|Annotation}}

* {{PropertyView|Annotation Style|Enumeration}} : spécifie le style d'annotation appliqué au texte. Voir [[Draft_AnnotationStyleEditor/fr|Draft Éditeur styles d'annotations]].
* {{PropertyView|Scale Multiplier|Float}} : spécifie le facteur d'échelle général appliqué au texte.

{{TitleProperty|Display Options}}

* {{PropertyView|Display Mode|Enumeration}} : spécifie comment le texte est affiché. S'il s'agit de {{value|World}}, le texte sera affiché sur un plan défini par sa {{PropertyData|Placement}}. S'il s'agit de {{value|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 ({{Version/fr|0.21}}).

{{TitleProperty|Graphics}}

* {{PropertyView|Line Color|Color}} : non utilisé.
* {{PropertyView|Line Width|Float}} : non utilisé.

{{TitleProperty|Text}}

* {{PropertyView|Font Name|Font}} : spécifie la police utilisée pour dessiner le texte. Il peut s'agir d'un nom de police, tel que {{value|Arial}}, d'un style par défaut tel que {{value|sans}}, {{value|serif}} ou {{value|mono}}, d'une famille telle que {{value|Arial,Helvetica,sans}}, ou d'un nom avec un style tel que {{value|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.
* {{PropertyView|Font Size|Length}} : spécifie la taille des lettres. Le texte peut être invisible dans la [[3D_view/fr|vue 3D]] si cette valeur est très petite.
* {{PropertyView|Justification|Enumeration}} : spécifie l'alignement du texte : {{value|Left}}, {{value|Center}} ou {{value|Right}}.
* {{PropertyView|Line Spacing|Float}} : spécifie le facteur appliqué à la hauteur de ligne par défaut du texte.
* {{PropertyView|Text Color|Color}} : spécifie la couleur du texte.

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


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] 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 :

Pour créer un Draft Texte, utilisez la méthode {{incode|make_text}} ({{Version/fr|0.19}}) du module Draft. Cette méthode remplace la méthode dépréciée {{incode|makeText}}.

{{Code|code=
{{Code|code=
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
text = make_text(string, placement=None, screen=False)
}}
}}
* Crée un objet {{incode|Text}}, au {{incode|point}} donné, si un {{incode|FreeCAD.Vecteur}}.
* {{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.
* Si {{incode|Screen}} est {{incode|True}}, la direction du texte fait toujours face à la vue, sinon, il se situe sur le plan X, Y.


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}}.
* Crée un objet {{incode|text}}, au {{incode|placement}} qui peut être un {{incode|FreeCAD.Placement}} mais aussi une {{incode|FreeCAD.Rotation}} ou un {{incode|FreeCAD.Vector}}.
* {{incode|string}} 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}}, le texte fait toujours face à la caméra, sinon il est affiché dans un plan défini par {{PropertyData|Placement}}.


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 en changeant {{incode|ViewObject.FontSize}} avec la nouvelle taille en millimètres.

Exemple :


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

doc = App.newDocument()


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


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


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


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


t3 = ["Upside", "down"]
Text3 = Draft.makeText(t3, point=p3)
p3 = App.Vector(-1000, -500, 0)
Text3.ViewObject.FontSize = 200
place3 = App.Placement(p3, App.Rotation(zaxis, 180))
text3 = Draft.make_text(t3, place3)
text3.ViewObject.FontSize = 200


doc.recompute()
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)
}}
}}



{{Docnav/fr
{{Docnav/fr
|[[Draft_Rectangle/fr|Rectangle]]
|[[Draft_Hatch/fr|Hachure]]
|[[Draft_Dimension/fr|Cote]]
|[[Draft_Dimension/fr|Dimension]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Rectangle.svg
|IconL=Draft_Hatch.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Dimension.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}
}}


{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 22:00, 9 January 2024

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 Étiquette, Draft Forme à partir d'un texte

Description

La commande Draft Texte crée un texte de plusieurs lignes à un endroit donné.

Pour créer un élément de texte avec une flèche, utilisez plutôt la commande Draft Étiquette.

Un seul point est nécessaire pour positionner le texte

Utilisation

Voir aussi : Draft La barre et Draft Aimantation.

  1. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le bouton Texte.
    • Sélectionnez l'option Annotation → Texte dans le menu.
    • Utilisez le raccourci clavier : T puis E.
  2. Le panneau de tâches Text s'ouvre. Voir Options pour plus d'informations.
  3. Choisissez un point dans la Vue 3D ou rentrez des coordonnées et appuyez sur le bouton Entrez le point.
  4. Saisissez le texte souhaité, appuyez sur Entrée pour commencer une nouvelle ligne.
  5. Appuyez deux fois sur Entrée ou sur le bouton Insérer du texte pour terminer la commande.

Options

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. (pour la version 0.22).

  • Pour saisir manuellement des coordonnées, entrez les valeurs de X, Y et Z et appuyez sur Entrée après chacune, ou vous pouvez appuyer sur le bouton Entrez le point lorsque vous avez les valeurs souhaitées. Il est conseillé de déplacer le pointeur hors de la vue 3D avant de saisir les coordonnées.
  • Appuyez sur G ou cliquez sur la case Global pour basculer en mode global. Si le mode global est activé, les coordonnées sont relatives au système de coordonnées global, sinon elles sont relatives au système de coordonnées du plan de travail. introduit dans la version 0.20
  • Appuyez sur N ou cliquez sur la case Continuer pour activer le mode continu. Si le mode continu est activé, la commande redémarre après avoir terminé, ce qui vous permet de continuer à créer des textes. Le raccourci ne fonctionne pas dans le deuxième panneau de tâches. Cette option n'est pas disponible dans le premier panneau de tâches dans FreeCAD version 0.19 et antérieure.
  • Appuyez sur S pour activer ou désactiver Draft Aimantation.
  • Appuyez sur Échap ou sur le bouton Fermer pour interrompre la commande.

Remarques

Propriétés

Voir aussi : Éditeur de propriétés

Un objet Draft Texte 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 :

Données

Base

  • DonnéesPlacement (Placement) : spécifie la position du texte dans la Vue 3D. Voir Placement.
  • DonnéesText (StringList) : spécifie le contenu du texte. Chaque élément de la liste représente une nouvelle ligne de texte.

Vue

Annotation

  • VueAnnotation Style (Enumeration) : spécifie le style d'annotation appliqué au texte. Voir Draft Éditeur styles d'annotations.
  • VueScale Multiplier (Float) : spécifie le facteur d'échelle général appliqué au texte.

Display Options

  • VueDisplay Mode (Enumeration) : spécifie comment le texte est affiché. S'il s'agit de World, le texte sera affiché sur un plan défini par sa DonnéesPlacement. 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

  • VueLine Color (Color) : non utilisé.
  • VueLine Width (Float) : non utilisé.

Text

  • VueFont Name (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.
  • VueFont Size (Length) : spécifie la taille des lettres. Le texte peut être invisible dans la vue 3D si cette valeur est très petite.
  • VueJustification (Enumeration) : spécifie l'alignement du texte : Left, Center ou Right.
  • VueLine Spacing (Float) : spécifie le facteur appliqué à la hauteur de ligne par défaut du texte.
  • VueText Color (Color) : spécifie la couleur du texte.

Script

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

Pour créer un Draft Texte, utilisez la méthode make_text (introduit dans la version 0.19) du module Draft. Cette méthode remplace la méthode dépréciée makeText.

text = make_text(string, placement=None, screen=False)
  • Crée un objet text, au placement qui peut être un FreeCAD.Placement mais aussi une FreeCAD.Rotation ou un FreeCAD.Vector.
  • string 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 fait toujours face à la caméra, sinon il est affiché dans un plan défini par DonnéesPlacement.

Les propriétés d'affichage de text peuvent être modifiées en écrasant 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()

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

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

text1 = Draft.make_text(t1, p1)
text2 = Draft.make_text(t2, p2)
text1.ViewObject.FontSize = 200
text2.ViewObject.FontSize = 200

zaxis = App.Vector(0, 0, 1)

t3 = ["Upside", "down"]
p3 = App.Vector(-1000, -500, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 180))
text3 = Draft.make_text(t3, place3)
text3.ViewObject.FontSize = 200

doc.recompute()