Draft Text/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(40 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Draft_Rectangle/it|Rettangolo]]|[[Draft_Dimension/it|Quotatura]]|[[Draft_Module/it|Draft]]|IconL=Draft_Rectangle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Dimension.svg }}


{{Docnav/it
{{GuiCommand/it|Name=Draft Text|Name/it=Testo|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Testo|Shortcut={{KEY|T}} {{KEY|E}}
|[[Draft_Hatch/it|Tratteggio]]
|SeeAlso=[[Draft Label/it|Etichetta]], [[Draft ShapeString/it|Forma da testo]]
|[[Draft_Dimension/it|Quotatura]]
|Version=0.7}}
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Hatch.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/it
|Name=Draft Text
|Name/it=Testo
|MenuLocation=Drafting → Testo
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut={{KEY|T}} {{KEY|E}}
|Version=0.7
|SeeAlso=[[Draft_Label/it|Etichetta]], [[Draft_ShapeString/it|Forma da testo]]
}}


<span id="Description"></span>
==Descrizione==
==Descrizione==


Lo strumento [[Image:Draft_Text.svg|16px]] Testo inserisce una casella di testo su più righe in un determinato punto. Usa [[Draft Linestyle/it|il tipo di linea e il colore]] impostati nella [[Draft Tray/it|barra di Draft]].
Il comando [[Image:Draft_Text.svg|24px]] '''Testo''' crea un testo su più righe in un dato punto.


Per creare un'etichetta di testo con una linea guida e una freccia usare [[Draft Label/it|Etichetta]]. Per creare testo solido o lettere 3D usare [[Draft ShapeString/it|Forma da testo]] con [[Part Extrude/it|Estrusione]] di Part.
Per creare un elemento di testo con una freccia usare invece il comando [[Draft_Label/it|Etichetta]].


[[Image:Draft_Text_example.png|400px]]
[[Image:Draft_Text_example.png|400px]]
{{Caption|Per posizionare una casella di testo basta un singolo punto}}
{{Caption|Singolo punto richiesto per posizionare il testo}}


<span id="Usage"></span>
'''Attenzione:''' I testi creati con la [[Release notes 0.18/it|versione 0.18]] non sono retrocompatibili, quindi eseguire il backup del proprio lavoro se si prova ad aprire con versioni precedenti i file creati con la 0.18.
==Utilizzo==


Vedi anche: [[Draft_Tray/it|Barra di Draft]] e [[Draft_Snap/it|Aggancio]].
==Usage==


# Esistono diversi modi per invocare il comando:
<div class="mw-translate-fuzzy">
#* Premere il pulsante {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/it|Testo]]}}.
== Utilizzo ==
# Premere il pulsante {{Button|[[Image:Draft Text.png|16px]] [[Draft Text/it|Testo]]}}, o premere i tasti {{KEY|T}} e poi {{KEY|E}}.
#* Selezionare l'opzione {{MenuCommand|Annotazione → [[Image:Draft_Text.svg|16px]] Testo}} dal menu.
#* Usare la scorciatoia da tastiera: {{KEY|T}} poi {{KEY|E}}.
# Selezionare un punto nella vista 3D, oppure digitare le sue [[Draft_Coordinates/it|coordinate ]] e poi premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|Inserisci punto]]}}.
# Si apre il pannello delle attività {{MenuCommand|Text}}. Vedere [[#Options|Opzioni]] per maggiori informazioni.
# Immettere il testo desiderato, premendo {{KEY|Invio}} tra ogni riga.
# Scegliere un punto nella [[3D_view/it|Vista 3D]], oppure digitare le coordinate e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}}.
# Premere due volte {{KEY|Invio}} per completare l'operazione.
# Inserire il testo desiderato, premere {{KEY|Enter}} per iniziare una nuova riga.
</div>
# Premere {{KEY|Enter}} due volte o premere il pulsante {{Button|[[Image:Button_valid.svg|16px]] Crea testo}} per terminare il comando.


<span id="Options"></span>
== Opzioni ==
== Opzioni ==


È possibile modificare le scorciatoie da tastiera a carattere singolo disponibili nel pannello delle attività. Vedere [[Draft_Preferences/it|Preferenze di Draft]]. Le scorciatoie qui menzionate sono le scorciatoie predefinite (per la versione 0.22).
* Per inserire le coordinate manualmente, è sufficiente inserire i numeri, quindi premere {{KEY|Invio}} per ciascun componente X, Y e Z. È possibile premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|Inserisci punto]]}} quando si hanno i valori desiderati per inserire il punto.
* Tenere premuto {{KEY|Ctrl}} mentre si digita il testo per forzare [[Draft_Snap|l'aggancio]] del proprio punto alla posizione di aggancio più vicina, indipendentemente dalla distanza.
* Premere{{KEY|Invio}} o {{KEY|↓ freccia in giù}} per inserire una nuova riga di testo.
* Premere {{KEY|↑ freccia in su}} per modificare la riga di testo precedente.
* Premere due volte {{KEY|Invio}} o {{KEY|↓ freccia in giù}} per finire di editare il testo.
* Premere il tasto {{KEY|Esc}} o il pulsante {{button|Chiudi}} per interrompere il comando corrente.


* Per inserire manualmente le coordinate, inserire le componenti X, Y e Z e premere {{KEY|Enter}} dopo ognuna di esse. Oppure si può premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}} quando ha i valori desiderati. Si consiglia di spostare il puntatore fuori dalla [[3D_view/it|Vista 3D]] prima di inserire le coordinate.
* Premere {{KEY|G}} o fare clic sulla casella di controllo {{MenuCommand|Globale}} per attivare o disattivare la modalità globale. Se la modalità globale è attiva, le coordinate sono relative al sistema di coordinate globale, altrimenti sono relative al sistema di coordinate [[Draft_SelectPlane/it|piano di lavoro]]. {{Version/it|0.20}}
* Premere {{KEY|N}} o fare clic sulla casella di controllo {{MenuCommand|Continua}} per attivare o disattivare la modalità continua. Se la modalità continua è attiva, il comando si riavvierà al termine, consentendo di continuare a creare testi. Il collegamento non funziona nel secondo pannello delle attività. Questa opzione non è disponibile nel primo pannello delle attività in FreeCAD versione 0.19 e precedenti.
* Premere {{KEY|S}} per attivare o disattivare [[Draft_Snap/it|Aggancia]].
* Premere {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando.

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

* Un Testo può essere modificato facendo doppio clic su di esso nella [[Tree_view/it|Vista albero]]. {{Version/it|0.20}}
* I Testi creati o salvati con [[Release_notes_0.21/it|FreeCAD versione 0.21]] non sono compatibili con le versioni precedenti.

<span id="Properties"></span>
== Proprietà ==
== Proprietà ==


Vedere anche: [[Property_editor/it|Editor delle proprietà]].

Un oggetto Draft Testo deriva da un oggetto [[App_FeaturePython/it|App FeaturePython]] e ne eredita tutte le proprietà. Le seguenti proprietà sono aggiuntive se non diversamente specificato.

<span id="Data"></span>
=== Dati ===
=== Dati ===
* {{PropertyData|Text}}: specifica il contenuto del blocco di testo come un elenco di stringhe; ogni elemento dell'elenco separato da una virgola indica una nuova riga.
* {{PropertyData|Position}}: specifica il punto base della prima riga del blocco di testo.
* {{PropertyData|Angle}}: specifica la rotazione della linea di base della prima riga del blocco di testo.
* {{PropertyData|Axis}}: specifica l'asse da utilizzare per la rotazione.


{{TitleProperty|Base}}

* {{PropertyData|Placement|Placement}}: specifica la posizione del testo nella [[3D view/it|Vista 3D]]. Vedere [[Placement/it|Posizionamento]].
* {{PropertyData|Text|StringList}}: specifica il contenuto del testo. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.

<span id="View"></span>
=== Vista ===
=== Vista ===
* {{PropertyView|Display Mode}}: se è "3D text" il testo è allineato agli assi della scena, inizialmente situati sul piano XY; se è "2D text", il testo è sempre rivolto verso la fotocamera.
* {{PropertyView|Font Name}}: specifica il carattere da utilizzare per disegnare il testo. Può essere il nome di un carattere, ad esempio "Arial", uno stile predefinito come "sans", "serif" o "mono", una famiglia come "Arial,Helvetica,sans" o un nome con uno stile come "Arial:Bold". Se nel sistema non trova il font specificato, ne utilizza uno generico.
* {{PropertyView|Font Size}}: specifica la dimensione delle lettere. Se l'oggetto testo viene creato nella vista ad albero ma non è visibile alcun testo, aumentare la dimensione del testo fino a renderlo visibile.
* {{PropertyView|Justification}}: specifica se il testo è allineato a sinistra, a destra o al centro del punto base.
* {{PropertyView|Line Spacing}}: specifica lo spazio tra le righe di testo.


{{TitleProperty|Annotation}}
== Script ==

{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
* {{PropertyView|Annotation Style|Enumeration}}: specifica lo stile di annotazione applicato al testo. Vedere [[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]].
* {{PropertyView|Scale Multiplier|Float}}: specifica il fattore di scala generale applicato al testo.

{{TitleProperty|Display Options}}

* {{PropertyView|Display Mode|Enumeration}}: specifica come viene visualizzato il testo. Se è {{value|World}} il testo verrà visualizzato su un piano definito dal suo {{PropertyData|Placement}}. Se è {{value|Screen}} il testo sarà sempre rivolto verso lo schermo. Questa è una proprietà ereditata. Le opzioni menzionate sono le opzioni rinominate ({{Version/it|0.21}}).

{{TitleProperty|Graphics}}

* {{PropertyView|Line Color|Color}}: not used.
* {{PropertyView|Line Width|Float}}: not used.

{{TitleProperty|Text}}

* {{PropertyView|Font Name|Font}}: specifica il font utilizzato per disegnare il testo. Può essere un nome di font, come {{value|Arial}}, uno stile predefinito come {{value|sans}}, {{value|serif}} o {{value|mono}}, una famiglia come {{value|Arial,Helvetica,sans}}, o un nome con uno stile come {{value|Arial:Bold}}. Se il carattere specificato non viene trovato nel sistema, viene utilizzato un carattere predefinito.
* {{PropertyView|Font Size|Length}}: specifica la dimensione delle lettere. Il testo può essere invisibile nella [[3D_view/it|Vista 3D]] se questo valore è molto piccolo.
* {{PropertyView|Justification|Enumeration}}: specifica se l'allineamento del testo: {{value|Left}}, {{value|Center}} o {{value|Right}}.
* {{PropertyView|Line Spacing|Float}}: specifica il fattore applicato all'altezza di riga predefinita del testo.
* {{PropertyView|Text Color|Color}}: specifica il colore del testo.

<span id="Scripting"></span>
==Script==

Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].

Per creare un Draft Testo usare il metodo {{incode|make_text}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makeText}}.


Lo strumento Testo può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:
{{Code|code=
{{Code|code=
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
text = make_text(string, placement=None, screen=False)
}}
}}
* Crea un oggetto {{incode|Text}}, nel {{incode|point}} definito da un {{incode|FreeCAD.Vector}}.
* {{incode|stringlist}} è una stringa o un elenco di stringhe; se si tratta di una lista, ogni elemento viene visualizzato nella sua propria riga.
* Se {{incode|screen}} è {{incode|True}}, il testo è sempre rivolto verso la direzione della vista della telecamera, altrimenti si allinea con gli assi della scena e giace sul piano XY.


Il posizionamento del {{incode|Text}} può essere cambiato sovrascrivendo il suo attributo {{incode|Placement}}, o sovrascrivendo singolarmente i suoi attributi {{incode|Placement.Base}} e {{incode|Placement.Rotation}}.
* Crea un oggetto {{incode|text}}, in {{incode|placement}}, che può essere un {{incode|FreeCAD.Placement}}, ma anche un {{incode|FreeCAD.Rotation}} o un { {incode|FreeCAD.Vector}}.
* {{incode|stringa}} è una stringa o un elenco di stringhe. Se si tratta di un elenco, ogni elemento viene visualizzato su una propria riga.
* Se {{incode|screen}} è {{incode|True}}, il testo è sempre rivolto verso la telecamera, altrimenti viene visualizzato in un piano definito dal suo {{PropertyData|Placement}}.


Le proprietà di visualizzazione di {{incode|Text}} possono essere cambiate sovrascrivendo i suoi attributi; per esempio, sovrascrivendo {{incode|ViewObject.FontSize}} con le nuove dimensioni in millimetri.
Le proprietà di visualizzazione di {{incode|text}} possono essere cambiate sovrascrivendo i suoi attributi; per esempio, sovrascrivendo {{incode|ViewObject.FontSize}} con le nuove dimensioni in millimetri.


Esempio:
Esempio:

{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft

doc = App.newDocument()


p1 = FreeCAD.Vector(0, 0, 0)
t1 = "This is a sample text"
t1 = "This is a sample text"
p1 = App.Vector(0, 0, 0)


p2 = FreeCAD.Vector(1000, 1000, 0)
t2 = ["First line", "second line"]
t2 = ["First line", "second line"]
p2 = App.Vector(1000, 1000, 0)


Text1 = Draft.makeText(t1, point=p1)
text1 = Draft.make_text(t1, p1)
Text2 = Draft.makeText(t2, point=p2)
text2 = Draft.make_text(t2, p2)
Text1.ViewObject.FontSize = 200
text1.ViewObject.FontSize = 200
Text2.ViewObject.FontSize = 200
text2.ViewObject.FontSize = 200

zaxis = App.Vector(0, 0, 1)


p3 = FreeCAD.Vector(-1000, -500, 0)
t3 = ["Upside", "down"]
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()
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


{{Docnav/it
Text4 = Draft.makeText(t3, point=p3)
|[[Draft_Hatch/it|Tratteggio]]
Text4.ViewObject.FontSize = 200
|[[Draft_Dimension/it|Quotatura]]
Text4.Placement.Rotation = FreeCAD.Rotation(ZAxis, -30)
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Hatch.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}
}}

{{Docnav/it|[[Draft_Rectangle/it|Rettangolo]]|[[Draft_Dimension/it|Quotatura]]|[[Draft_Module/it|Draft]]|IconL=Draft_Rectangle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Dimension.svg }}


{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 14:39, 12 January 2024

Testo

Posizione nel menu
Drafting → Testo
Ambiente
Draft, Arch
Avvio veloce
T E
Introdotto nella versione
0.7
Vedere anche
Etichetta, Forma da testo

Descrizione

Il comando Testo crea un testo su più righe in un dato punto.

Per creare un elemento di testo con una freccia usare invece il comando Etichetta.

Singolo punto richiesto per posizionare il testo

Utilizzo

Vedi anche: Barra di Draft e Aggancio.

  1. Esistono diversi modi per invocare il comando:
    • Premere il pulsante Testo.
    • Selezionare l'opzione Annotazione → Testo dal menu.
    • Usare la scorciatoia da tastiera: T poi E.
  2. Si apre il pannello delle attività Text. Vedere Opzioni per maggiori informazioni.
  3. Scegliere un punto nella Vista 3D, oppure digitare le coordinate e premere il pulsante Inserisci punto.
  4. Inserire il testo desiderato, premere Enter per iniziare una nuova riga.
  5. Premere Enter due volte o premere il pulsante Crea testo per terminare il comando.

Opzioni

È possibile modificare le scorciatoie da tastiera a carattere singolo disponibili nel pannello delle attività. Vedere Preferenze di Draft. Le scorciatoie qui menzionate sono le scorciatoie predefinite (per la versione 0.22).

  • Per inserire manualmente le coordinate, inserire le componenti X, Y e Z e premere Enter dopo ognuna di esse. Oppure si può premere il pulsante Inserisci punto quando ha i valori desiderati. Si consiglia di spostare il puntatore fuori dalla Vista 3D prima di inserire le coordinate.
  • Premere G o fare clic sulla casella di controllo Globale per attivare o disattivare la modalità globale. Se la modalità globale è attiva, le coordinate sono relative al sistema di coordinate globale, altrimenti sono relative al sistema di coordinate piano di lavoro. disponibile dalla versione 0.20
  • Premere N o fare clic sulla casella di controllo Continua per attivare o disattivare la modalità continua. Se la modalità continua è attiva, il comando si riavvierà al termine, consentendo di continuare a creare testi. Il collegamento non funziona nel secondo pannello delle attività. Questa opzione non è disponibile nel primo pannello delle attività in FreeCAD versione 0.19 e precedenti.
  • Premere S per attivare o disattivare Aggancia.
  • Premere Esc o il pulsante Chiudi per interrompere il comando.

Note

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Draft Testo deriva da un oggetto App FeaturePython e ne eredita tutte le proprietà. Le seguenti proprietà sono aggiuntive se non diversamente specificato.

Dati

Base

  • DatiPlacement (Placement): specifica la posizione del testo nella Vista 3D. Vedere Posizionamento.
  • DatiText (StringList): specifica il contenuto del testo. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.

Vista

Annotation

  • VistaAnnotation Style (Enumeration): specifica lo stile di annotazione applicato al testo. Vedere Stile delle annotazioni.
  • VistaScale Multiplier (Float): specifica il fattore di scala generale applicato al testo.

Display Options

  • VistaDisplay Mode (Enumeration): specifica come viene visualizzato il testo. Se è World il testo verrà visualizzato su un piano definito dal suo DatiPlacement. Se è Screen il testo sarà sempre rivolto verso lo schermo. Questa è una proprietà ereditata. Le opzioni menzionate sono le opzioni rinominate (disponibile dalla versione 0.21).

Graphics

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

Text

  • VistaFont Name (Font): specifica il font utilizzato per disegnare il testo. Può essere un nome di font, come Arial, uno stile predefinito come sans, serif o mono, una famiglia come Arial,Helvetica,sans, o un nome con uno stile come Arial:Bold. Se il carattere specificato non viene trovato nel sistema, viene utilizzato un carattere predefinito.
  • VistaFont Size (Length): specifica la dimensione delle lettere. Il testo può essere invisibile nella Vista 3D se questo valore è molto piccolo.
  • VistaJustification (Enumeration): specifica se l'allineamento del testo: Left, Center o Right.
  • VistaLine Spacing (Float): specifica il fattore applicato all'altezza di riga predefinita del testo.
  • VistaText Color (Color): specifica il colore del testo.

Script

Vedere anche: Autogenerated API documentation e Script di base per FreeCAD.

Per creare un Draft Testo usare il metodo make_text (disponibile dalla versione 0.19) del modulo Draft. Questo metodo sostituisce il metodo deprecato makeText.

text = make_text(string, placement=None, screen=False)
  • Crea un oggetto text, in placement, che può essere un FreeCAD.Placement, ma anche un FreeCAD.Rotation o un { {incode|FreeCAD.Vector}}.
  • stringa è una stringa o un elenco di stringhe. Se si tratta di un elenco, ogni elemento viene visualizzato su una propria riga.
  • Se screen è True, il testo è sempre rivolto verso la telecamera, altrimenti viene visualizzato in un piano definito dal suo DatiPlacement.

Le proprietà di visualizzazione di text possono essere cambiate sovrascrivendo i suoi attributi; per esempio, sovrascrivendo ViewObject.FontSize con le nuove dimensioni in millimetri.

Esempio:

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