Draft Texte

From FreeCAD Documentation
Revision as of 16:05, 24 May 2021 by David69 (talk | contribs) (Created page with "Les raccourcis clavier à caractère unique disponibles dans le panneau des tâches peuvent être modifiés. Voir Draft Préférences. Les raccourcis...")

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

La commande Draft Texte insère un texte de plusieurs lignes à un endroit donné.

Pour insérer un élément de texte avec une flèche, utilisez plutôt la commande Draft Etiquette.

Un seul point est nécessaire pour positionner le texte

Utilisation

Voir aussi: Draft La barre et Draft Accrochage.

  1. Il existe plusieurs façons de lancer la commande :
  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 les 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 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.

Notes

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.

Propriétés

See also: Property editor.

A Draft Text object is derived from an App FeaturePython object and inherits all its properties. The following properties are additional unless otherwise stated.

Data

Base

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.

View

Annotation

  • VueAnnotation Style (Enumeration): specifies the annotation style applied to the text. See Draft AnnotationStyleEditor.
  • VueScale Multiplier (Float): specifies the general scaling factor applied to the text.

Display Options

  • VueDisplay Mode (Enumeration): specifies how the text is displayed. If it is 3D text the text will be displayed in a plane defined by its DonnéesPlacement. If it is 2D text the text will always face the camera. This is an inherited property.

Graphics

  • VueLine Color (Color): not used.
  • VueLine Width (Float): not used.

Text

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.

Scripting

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

text = make_text(string, placement=None, 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.

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 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()