Draft Text/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(17 intermediate revisions by 3 users not shown)
Line 17: Line 17:
|Shortcut={{KEY|T}} {{KEY|E}}
|Shortcut={{KEY|T}} {{KEY|E}}
|Version=0.7
|Version=0.7
|SeeAlso=[[Draft_Label/fr|Draft Étiquette]], [[Draft_ShapeString/fr|Draft Formes à partir de texte]]
|SeeAlso=[[Draft_Label/fr|Draft Étiquette]], [[Draft_ShapeString/fr|Draft Forme à partir d'un texte]]
}}
}}


Line 29: Line 29:
{{Caption|Un seul point est nécessaire pour positionner le texte}}
{{Caption|Un seul point est nécessaire pour positionner le texte}}


<span id="Usage"></span>
==Utilisation==
==Utilisation==


Line 44: Line 45:
==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.
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).


* 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.
* 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.
* La case à cocher {{MenuCommand|Relative}}, affiché dans FreeCAD version 0.19 et antérieure, n'a aucune utilité pour cette commande.
* 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|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|T}} 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.
* 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.
* Appuyez sur {{KEY|S}} pour activer ou désactiver [[Draft_Snap/fr|Draft Aimantation]].
* Appuyez sur {{KEY|S}} pour activer ou désactiver [[Draft_Snap/fr|Draft Aimantation]].
* Appuyez sur {{KEY|Echap}} ou sur le bouton {{Button|Fermer}} pour interrompre la commande.
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour interrompre la commande.


<span id="Notes"></span>
==Remarques==
==Remarques==


* Un Draft Texte peut être édité en double-cliquant dessus dans l'arborescence. {{Version/fr|0.20}}
* Un Draft Texte peut être édité en double-cliquant dessus dans l'arborescence. {{Version/fr|0.20}}
* Les Draft Textes créés avec [[Release_notes_0.18/fr|FreeCAD version 0.18]] ne sont pas rétrocompatibles.
* 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>
==Propriétés==
==Propriétés==


Line 64: Line 66:
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 :
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 :


<span id="Data"></span>
===Données===
===Données===


Line 71: Line 74:
* {{PropertyData|Text|StringList}} : spécifie le contenu du texte. Chaque élément de la liste représente une nouvelle ligne de texte.
* {{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 ===
=== Vue ===


Line 80: Line 84:
{{TitleProperty|Display Options}}
{{TitleProperty|Display Options}}


* {{PropertyView|Display Mode|Enumeration}} : spécifie comment le texte est affiché. S'il s'agit de {{value|3D text}}, le texte sera affiché dans un plan défini par sa {{PropertyData|Placement}}. S'il s'agit de {{value|2D text}}, le texte fera toujours face à la caméra. Il s'agit d'une propriété héritée.
* {{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}}
{{TitleProperty|Graphics}}
Line 89: Line 93:
{{TitleProperty|Text}}
{{TitleProperty|Text}}


* {{PropertyView/fr|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 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/fr|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|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/fr|Justification|Enumeration}} : spécifie si l'alignement du texte : {{value|Left}}, {{value|Center}} ou {{value|Right}}.
* {{PropertyView|Justification|Enumeration}} : spécifie l'alignement du texte : {{value|Left}}, {{value|Center}} ou {{value|Right}}.
* {{PropertyView/fr|Line Spacing|Float}} : spécifie le facteur appliqué à la hauteur de ligne par défaut du texte.
* {{PropertyView|Line Spacing|Float}} : spécifie le facteur appliqué à la hauteur de ligne par défaut du texte.
* {{PropertyView/fr|Text Color|Color}} : spécifie la couleur 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|Débuter avec les scripts FreeCAD]].
Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].


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}}.
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}}.
Line 107: Line 112:
* 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}}.
* 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.
* {{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 caméra, sinon il est affiché dans un plan défini par {{PropertyData|Placement}}.
* 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}}.


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

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