Draft Text/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
{{GuiCommand/fr|Name=Draft Text|Name/fr=Texte|Workbenches=[[Draft Module/fr|Planche à dessin]]|MenuLocation=Draft → Texte|Shortcut=T E}}
{{GuiCommand/fr|Name=Draft Text|Name/fr=Texte|Workbenches=[[Draft Module/fr|Planche à dessin]]|MenuLocation=Draft → Texte|Shortcut=T E}}
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 10: Line 12:
</div>
</div>


To create solid text shapes use [[Draft ShapeString]] with [[Part Extrude]].
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]].


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


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


Line 20: Line 25:
# 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.
# 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>


==Options==
==Options==


<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.
* 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.
* Vous pouvez simplement entrer les coordonnées manuellement, en entrant les nombres, puis tapez {{KEY|ENTRÉE}} à chaque composants '''X, Y''' et '''Z'''.
* Vous pouvez simplement entrer les coordonnées manuellement, en entrant les nombres, puis tapez {{KEY|ENTRÉE}} à chaque composants '''X, Y''' et '''Z'''.
Line 29: Line 36:
* pressez sur la touche {{KEY|FLÈCHE HAUT}}, permet d'éditer la ligne précédente du texte.
* pressez sur la touche {{KEY|FLÈCHE HAUT}}, permet d'éditer la ligne précédente du 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.
* 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>


<div class="mw-translate-fuzzy">
==Propriétés==
==Propriétés==
* {{PropertyData/fr|Position}}: Point de base du bloc de texte
* {{PropertyData/fr|Position}}: Point de base du bloc de texte
Line 40: Line 49:
* {{PropertyView/fr|Rotation Axis}}: Spécifie l'axe de rotation a utiliser
* {{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.
* {{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>


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

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

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


L'outil texte peut être utilisé dans les [[Macros/fr|macros]], et dans la console Python, en utilisant la fonction suivante :
L'outil texte peut être utilisé dans les [[Macros/fr|macros]], et dans la console Python, en utilisant la fonction suivante :
</div>

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 = makeText(stringlist, point=Vector(0,0,0), screen=False)
Line 53: Line 80:
* Retourne l'objet nouvellement créé.
* Retourne l'objet nouvellement créé.
</div>
</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.

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.


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

Draft.makeText("This is a sample text", FreeCAD.Vector(1,1,0))
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)
}}
}}

{{Draft Tools navi}}
{{Userdocnavi}}
{{clear}}
{{clear}}

Revision as of 12:53, 8 January 2019

Texte

Emplacement du menu
Draft → Texte
Ateliers
Planche à dessin
Raccourci par défaut
T E
Introduit dans la version
-
Voir aussi
Aucun

Description

L'outil texte, requiert un point d'emplacement, puis, du texte peut être saisi dans une boîte de dialogue texte.

Le texte prend les attributs du Style défini.

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.

Utilisation

  1. Pressez la touche texte, ou pressez les touches T, puis E
  2. Cliquez un point dans la vue 3D, ou tapez les coordonnées
  3. Entrez le texte désiré, et tapez sur ENTRÉE entre chaque ligne,
  4. Pressez deux fois sur ENTRÉE, (ce qui laisse la dernière ligne vide), ajoute le texte au document, et, ferme l'éditeur.

Options

  • Pressez sur la touche CTRL force l'accrochage, de votre point à l'emplacement le plus proche, du composant logiciel enfichable, indépendamment de la distance.
  • Vous pouvez simplement entrer les coordonnées manuellement, en entrant les nombres, puis tapez ENTRÉE à chaque composants X, Y et Z.
  • Appuyez sur ESC pour annuler l'opération.
  • Lorsque vous modifiez le texte, appuyez sur ENTRÉE, ou FLÈCHE BAS, vous permet d'entrer, ou de modifier la ligne de texte suivante.
  • pressez sur la touche FLÈCHE HAUT, permet d'éditer la ligne précédente du texte.
  • Pressez deux fois sur ENTRÉE, (ce qui laisse la dernière ligne vide), ajoute le texte au document, et, ferme l'éditeur.

Propriétés

  • DonnéesPosition: Point de base du bloc de texte
  • DonnéesLabel Text: Le contenu du bloc de texte
  • VueDisplay Mode: Spécifie si le texte est aligné à la scène ou toujours face à la caméra
  • VueFont Size: La dimension des lettres
  • VueJustification: Spécifie l'alignement du texte à gauche à droite ou an centre du point de base
  • VueLine Spacing: Spécifie l'espace entre les lignes du texte
  • VueRotation: Spécifie la rotation a appliquer au texte
  • VueRotation Axis: Spécifie l'axe de rotation a utiliser
  • VueFont 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.

Data

  • DonnéesText: 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.
  • DonnéesPosition: specifies the base point of the first line of the text block.
  • DonnéesAngle: specifies the rotation of the baseline of the first line of the text block.
  • DonnéesAxis: specifies the axis to use for the rotation.

View

  • VueDisplay 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.
  • VueFont 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.
  • VueFont 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.
  • VueJustification: specifies if the text aligns to the left, right or at the center of the base point.
  • VueLine Spacing: specifies the space between lines of text.

Script

L'outil texte peut être utilisé dans les macros, et dans la console Python, en utilisant la fonction suivante :

The Text tool can be used in macros and from the Python console by using the following function:

Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
  • 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éé.

The placement of the Text can be changed by overwriting its Placement attribute, or by individually overwriting its Placement.Base and Placement.Rotation attributes.

The view properties of Text can be changed by overwriting its attributes; for example, overwrite ViewObject.FontSize with the new size in millimeters.

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)