Draft Texte

From FreeCAD Documentation
Revision as of 16:08, 24 May 2021 by David69 (talk | contribs) (Created page with "===Données===")

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 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.
  • La case à cocher Relative n'a aucune utilité pour cette commande.
  • 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
  • Cliquez sur la case Continue du deuxième panneau de tâches pour activer le mode continu. Le raccourci clavier T ne fonctionne pas. Si le mode continu est activé, la commande redémarre après avoir été terminée, ce qui vous permet de continuer à créer des textes.
  • Appuyez sur Echap 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é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()