Draft Texte

From FreeCAD Documentation
Revision as of 08:26, 3 May 2019 by Mario52 (talk | contribs)

Texte

Emplacement du menu
Draft → Texte
Ateliers
Planche à dessin
Raccourci par défaut
T E
Introduit dans la version
0.7
Voir aussi
Draft Label, Draft ShapeString

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.

Warning: The texts created with version 0.18 are not backward compatible, so backup your work if you try to open files created with 0.18 with older versions.

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)