Draft Text/fr: Difference between revisions

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

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


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


==Description==
<div class="mw-translate-fuzzy">
==Description==


La commande [[Image:Draft_Text.svg|24px]] '''Draft Texte''' crée un texte de plusieurs lignes à un endroit donné.
L'outil texte, requiert un point d'emplacement, puis, du texte peut être saisi dans une boîte de dialogue texte.


Pour créer un élément de texte avec une flèche, utilisez plutôt la commande [[Draft_Label/fr|Draft Étiquette]].
Le texte prend les attributs du [[Draft Linestyle/fr|Style]] défini.
</div>


[[Image:Draft_Text_example.png|400px]]
To create a text label with a leader and an arrow use [[Draft Label]]. To create solid text or 3D letters use [[Draft ShapeString]] with [[Part Extrude]].
{{Caption|Un seul point est nécessaire pour positionner le texte}}


<span id="Usage"></span>
<div class="mw-translate-fuzzy">
==Utilisation==
[[Image:Draft_Text_example.jpg|400px]]
</div>


Voir aussi : [[Draft_Tray/fr|Draft La barre]] et [[Draft_Snap/fr|Draft Aimantation]].
'''Warning:''' The texts created with [[Release notes 0.18 |version 0.18]] are not backward compatible, so backup your work if you try to open files created with 0.18 with older versions.


# Il existe plusieurs façons de lancer la commande :
<div class="mw-translate-fuzzy">
#* Appuyez sur le bouton {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/fr|Texte]]}}.
==Utilisation==
#* Sélectionnez l'option {{MenuCommand|Annotation → [[Image:Draft_Text.svg|16px]] Texte}} dans le menu.

# Pressez la touche texte, ou pressez les touches {{KEY|T}}, puis {{KEY|E}}
#* 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.
# Cliquez un point dans la vue 3D, ou tapez les [[Draft_Coordinates/fr|coordonnées]]
# 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}}.
# Entrez le texte désiré, et tapez sur {{KEY|ENTRÉE}} entre chaque ligne,
# Saisissez le texte souhaité, appuyez sur {{KEY|Entrée}} pour commencer une nouvelle 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}} ou sur le bouton {{Button|[[Image:Button_valid.svg|16px]] Insérer du texte}} pour terminer la commande.
</div>


==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).
<div class="mw-translate-fuzzy">

* Pressez sur la touche {{KEY|CTRL}} force l'[[Draft_Snap/fr|accrochage]], de votre point à l'emplacement le plus proche, du composant logiciel enfichable, 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.
* Vous pouvez simplement entrer les coordonnées manuellement, en entrant les nombres, puis tapez {{KEY|ENTRÉE}} à chaque composants '''X, Y''' et '''Z'''.
* 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}}
* Appuyez sur {{KEY|ESC}} pour annuler l'opération.
* 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.
* Lorsque vous modifiez le texte, appuyez sur {{KEY|ENTRÉE}}, ou {{KEY|FLÈCHE BAS}}, vous permet d'entrer, ou de modifier la ligne de texte suivante.
* Appuyez sur {{KEY|S}} pour activer ou désactiver [[Draft_Snap/fr|Draft Aimantation]].
* pressez sur la touche {{KEY|FLÈCHE HAUT}}, permet d'éditer la ligne précédente du texte.
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour interrompre la commande.
* Pressez '''deux fois''' sur {{KEY|ENTRÉE}}, (ce qui laisse la dernière ligne vide), ajoute le texte au document, et, ferme l'éditeur.

</div>
<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>
<div class="mw-translate-fuzzy">
==Propriétés==
==Propriétés==
* {{PropertyData/fr|Position}}: Point de base du bloc de texte
* {{PropertyData/fr|Label Text}}: Le contenu du bloc de texte
* {{PropertyView/fr|Display Mode}}: Spécifie si le texte est aligné à la scène ou toujours face à la caméra
* {{PropertyView/fr|Font Size}}: La dimension des lettres
* {{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
* {{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.
</div>


Voir aussi : [[Property_editor/fr|Éditeur de propriétés]]
=== Data ===
* {{PropertyData|Text}}: specifies the contents of the text block as a list of strings; each element on the list, separated by a comma, indicates a new line.
* {{PropertyData|Position}}: specifies the base point of the first line of the text block.
* {{PropertyData|Angle}}: specifies the rotation of the baseline of the first line of the text block.
* {{PropertyData|Axis}}: specifies the axis to use for the 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 :
=== View ===
* {{PropertyView|Display 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.
* {{PropertyView|Font Name}}: 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.
* {{PropertyView|Font Size}}: specifies the size of the letters. If the text object is created in the tree view but no text is visible, increase the size of the text until it is visible.
* {{PropertyView|Justification}}: specifies if the text aligns to the left, right or at the center of the base point.
* {{PropertyView|Line Spacing}}: specifies the space between lines of text.


<span id="Data"></span>
<div class="mw-translate-fuzzy">
===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 ===

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


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, en utilisant la fonction suivante :

</div>
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}}.


The Text tool can be used in [[macros]] and from the [[Python]] console by using the following function:
{{Code|code=
{{Code|code=
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
text = make_text(string, placement=None, screen=False)
}}
}}
<div class="mw-translate-fuzzy">
* Crée un objet texte, au point donné, si un vecteur est fourni, contient une chaîne, ou une liste de chaînes.
* La couleur actuelle, la hauteur du texte, et, la police de caractères spécifiées, dans les préférences du projet sont utilisés.
* Si '''screenmode''' est '''True''', la direction du texte fait toujours face à la vue, sinon, il se situe sur le plan '''X,Y'''.
* Retourne l'objet nouvellement créé.
</div>


The placement of the {{incode|Text}} can be changed by overwriting its {{incode|Placement}} attribute, or by individually overwriting its {{incode|Placement.Base}} and {{incode|Placement.Rotation}} attributes.
* 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 prise de vue, sinon il est affiché dans un plan défini par {{PropertyData|Placement}}.


The view properties of {{incode|Text}} can be changed by overwriting its attributes; for example, overwrite {{incode|ViewObject.FontSize}} with the new size in millimeters.
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

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


p3 = FreeCAD.Vector(-1000, -500, 0)
t3 = ["Upside", "down"]
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()
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


{{Docnav/fr
Text4 = Draft.makeText(t3, point=p3)
|[[Draft_Hatch/fr|Hachure]]
Text4.ViewObject.FontSize = 200
|[[Draft_Dimension/fr|Dimension]]
Text4.Placement.Rotation = FreeCAD.Rotation(ZAxis, -30)
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Hatch.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}
}}


{{Draft Tools navi{{#translation:}}}}
{{Docnav|[[Draft_Rectangle|Rectangle]]|[[Draft_Dimension|Dimension]]|[[Draft_Module|Draft]]|IconL=Draft_Rectangle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Dimension.svg }}
{{Userdocnavi{{#translation:}}}}

{{Draft Tools navi}}

{{Userdocnavi}}
{{clear}}

Latest revision as of 13:21, 13 April 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 prise de vue, 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()