Draft ShapeString/it: Difference between revisions

From FreeCAD Documentation
(Created page with "==Note==")
No edit summary
Tag: Manual revert
 
(79 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Draft_Point/it|Punto]]|[[Draft_Facebinder/it|Lega facce]]|[[Draft_Module/it|Draft]]|IconL=Draft_Point.svg |IconC=Workbench_Draft.svg|IconR=Draft_Facebinder.svg }}


{{Docnav/it
{{GuiCommand/it|Name=Draft_ShapeString|Name/it=ShapeString|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Arch]]|MenuLocation=Draft → Forma da testo...|Shortcut=S S|SeeAlso=[[Draft Text/it|Testo Draft]], [[Part Extrude/it|Part Estrusione]],<br /> [[Macro_Fonts_Win10_PYMP/it|Macro Fonts Win10 PYMP]] [[Image:Macro_Fonts_Win10_PYMP.png|24px]]|Version=0.14}}
|[[Draft_Facebinder/it|Lega facce]]
|[[Draft_Hatch/it|Tratteggio]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Facebinder.svg
|IconR=Draft_Hatch.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/it
|Name=Draft_ShapeString
|Name/it=Forma da testo
|MenuLocation=Drafting → Forma da testo
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut=
|Version=0.14
|SeeAlso=[[Draft_Text/it|Testo]], [[Draft_Label/it|Etichetta]] [[Part_Extrude/it|Estrusione]]
}}


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


Lo strumento ShapeString inserisce una forma composta che riproduce una stringa di testo in un dato punto del documento corrente.
Il comando [[Image:Draft_ShapeString.svg|24px]] '''Forma da testo''' crea una forma composta che rappresenta una stringa di testo. Questa forma può essere utilizzata per creare lettere 3D con il comando [[Part_Extrude/it|Part Estrusione]].
Si possono definire gli attributi del testo quali altezza, tipo di carattere, ecc..
La forma risultante può essere utilizzata con lo strumento [[Part Extrude/it|Estrusione]] di Part per creare lettere 3D.


Il comando Forma da testo non è destinato alle annotazioni di testo standard. Il comando [[Draft_Text/it|Testo]] o il comando [[Draft_Label/it|Etichetta]] dovrebbe essere utilizzato a tale scopo.
Per inserire un elemento di testo più semplice senza una forma chiusa, utilizzare [[Draft Text/it|Testo]]. Per creare un'etichetta di testo con una linea guida e una freccia usare [[Draft Label/it|Etichetta]].


[[Image:Draft_ShapeString_Example400.png]]
[[Image:Draft_ShapeString_Example400.png]]
{{Caption|Per posizionare una Shapestring basta un singolo punto}}
{{Caption|Per posizionare una Forma da testo basta un singolo punto}}


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


Per gli utenti Windows: leggere prima il paragrafo [[#Selezione file font su Windows|Selezione file font su Windows]].
Se la modalità dell'interfaccia di Draft è impostata su ToolBar:
# Premere il pulsante {{Button|[[Image:Draft_ShapeString16.png]] [[Draft_ShapeString/it|Forma da testo...]]}} , o premere i tasti {{KEY|S}} e poi {{KEY|S}}.
# Selezionare un punto nella vista 3D, o digitare le sue [[Draft_Coordinates/it|coordinate]] e poi premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|aggiungi punto]]}}.
# Immettere il testo desiderato e premere {{KEY|Invio}}.
# Immettere la dimensione desiderata e premere {{KEY|Invio}}.
# Immettere il percorso desiderato e premere {{KEY|Invio}}.
# Premere {{KEY|Invio}} per accettare il file di font visualizzato, o premere {{Button|...}} per selezionare un file di font.
[[Image:SSFontSelect.png]]


# Esistono diversi modi per invocare il comando:
Se la modalità dell'interfaccia di Draft è impostata su Vista azioni:
# Premere il pulsante {{Button|[[Image:Draft_ShapeString16.png]] [[Draft_ShapeString/it|Forma da testo]]}}, o premere i tasti {{KEY|S}} e poi {{KEY|S}}.
#* Premere il pulsante {{Button|[[Image:Draft_ShapeString.svg|16px]] [[Draft_ShapeString/it|Forma da testo]]}}.
#* Selezionare l'opzione {{MenuCommand|Drafting → [[Image:Draft_ShapeString.svg|16px]] Forma da testo}} dal menu.
# Appare una finestra di dialogo in cui è possibile specificare i parametri.
# Si apre il pannello attività {{MenuCommand|Forma da testo}}.
# Premere {{KEY|OK}} per creare la forma dal testo.
# Fare clic su un punto nella [[3D_view/it|Vista 3D]] o digitare le coordinate.
# Facoltativamente, premere il pulsante {{Button|Reimposta punto}} per reimpostare il punto all'origine.
# Inserire una {{MenuCommand|Stringa}}.
# Specificare l'{{MenuCommand|Altezza}}.
# Per selezionare un carattere, eseguire una delle seguenti operazioni:
#* Inserire un percorso file nella casella di input {{MenuCommand|Font file}}.
#* Premere il pulsante {{Button|...}} e selezionare un file.
# Premere il pulsante {{Button|OK}} per terminare il comando.
# Facoltativamente, modificare il {{PropertyData|Justification}} di ShapeString. Vedere [[#Proprietà|Proprietà]].


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


* Premer {{KEY|Esc}} o il pulsante {{Button|Annulla}} per interrompere il comando.
* Il testo, le dimensioni, il percorso e il carattere possono essere modificati dopo la creazione, modificando i valori nell'editor delle proprietà.
* Si deve impostare il file di caratteri predefinito nelle [[Draft Preferences/it|Preferenze di Draft]], nella scheda {{Button|Testi e dimensioni}}. Questo precompila la casella del file del carattere nella finestra di dialogo.
*I font supportati includono TrueType (.ttf), OpenType (.otf), and Type 1 (.pfb).


<span id="Notes"></span>
=== Limitazioni ===
==Note==
* Altezze di testo molto ridotte possono causare deformazioni delle forme del carattere a causa della perdita di dettagli nel ridimensionamento.
* La versione corrente mostra solo un testo scritto in orizzontale da sinistra a destra.
* Per creare un testo curvo è possibile utilizzare la macro {{Button|[[File:FCCircularTextButtom.png|24px]] [[Macro_Circular Text/it|Testo circolare]]}}.


* Una Forma da testo può essere modificata facendo doppio clic su di essa nella [[Tree_view/it|Vista ad albero]]. {{Version/it|0.20}}
== Opzioni ==
* I font supportati includono TrueType ({{FileName|.ttf}}), OpenType ({{FileName|.otf}}) e Type 1 ({{FileName|.pfb}}).
* Il comando è limitato al testo da sinistra a destra. Il testo da destra a sinistra e dall'alto in basso non è supportato.
* Altezze del testo molto piccole possono causare forme dei caratteri deformate a causa della perdita di dettagli nel ridimensionamento.
* I font possono genererare geometrie problematiche. Questo perché i contorni dei caratteri possono sovrapporsi e avere piccoli spazi. Queste condizioni sono considerate errori nelle poliline utilizzate per definire le facce.
* Forma da testo può anche essere creato con [[Macro_Fonts_Win10_PYMP/it|Macro Fonts Win10 PYMP]].
* Per creare Forme da testo disposte in modo circolare utilizzare il [[Macro_FCCircularText/it|Macro FCCircularText]].

<span id="Font_file_selection_on_Windows"></span>
==Selezione file font su Windows==

In Windows l'accesso alla cartella dei caratteri predefinita è limitato. Ciò influisce sulla selezione del file di carattere per Forma da testo. Esistono tre casi in FreeCAD in cui è possibile specificare un file di font per Forma da testo: nel pannello attività Forma da testo, quando si modifica la proprietà {{PropertyData|Font File}} di una Forma da testo e quando si specifica il file di font predefinito in [[Draft_Preferences/it#Testi e quotature|Preferenze per l'ambiente Draft]].

Non è possibile premere il pulsante {{Button|...}} e quindi selezionare un file dalla cartella predefinita dei font di Windows quando si utilizza la finestra di dialogo dei file nativi. Ci sono una serie di soluzioni alternative:
* Assicurarsi che {{MenuCommand|DontUseNativeFontDialog}} sia impostato su {{True}}, che è il valore predefinito per questa preferenza. Questo chiamerà una finestra di dialogo file diversa, non nativa, solo quando si preme il pulsante {{Button|...}} nel pannello attività Forma da testo. Con questa finestra di dialogo è possibile accedere alla cartella predefinita dei font di Windows.
* Cambiare {{MenuCommand|DontUseNativeDialog}} in {{True}}. Ciò indica a FreeCAD di utilizzare sempre la finestra di dialogo dei file non nativi.
* Specificare il file del carattere nella casella di immissione. Ovviamente è possibile digitare il percorso completo o copiare e incollare il percorso da Esplora file di Windows. Ma c'è anche un altro modo per entrare nella cartella. Se si inserisce {{Value|C:\}} apparirà un elenco a tendina. Selezionare {{Value|Windows}} da quell'elenco e aggiungere {{Value|\F}}. Selezionare {{Value|Fonts}} dal nuovo elenco a discesa. Infine aggiungere {{Value|\}} e le prime lettere del file del font, quindi selezionalo dall'elenco a discesa.
* Creare una cartella personalizzata contenente i file dei font.

Vedere il paragrafo [[#Preferenze|Preferenze]] di seguito per la posizione delle preferenze citate.

<span id="Tutorials"></span>
==Tutorial==

* [[Draft_ShapeString_tutorial/it|Tutorial Forma da testo - ShapeString]]: come estrudere un testo, posizionarlo nello spazio 3D e creare un'incisione in un altro corpo.
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623 How to use ShapeStrings in PartDesign]

<span id="Preferences"></span>
==Preferenze==

Vedere anche: [[Preferences_Editor/it|Impostare le Preferenze]], [[Draft_Preferences/it|Preferenze per l'ambiente Draft]] e [[Std_DlgParameter/it|Modifica parametri]].


* Il file di font predefinito può essere modificato nelle preferenze: {{MenuCommand|Modifica → Preferenze... → Draft → Testi e quotature → Font predefinito per Forma da testo}}.
* 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.
* Per utenti Windows:
* Premere il tasto {{KEY|Esc}} o il pulsante {{button|Chiudi}} per interrompere il comando corrente.
** Impostare {{MenuCommand|Strumenti → Modifica parametri... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog}} su {{True}} per utilizzare la finestra di dialogo del file non nativo quando si seleziona un file di carattere dal pannello delle attività Forma da testo.
** In alternativa, impostare {{MenuCommand|Strumenti → Modifica parametri... → BaseApp → Preferences → Dialog → DontUseNativeDialog}} su {{True}} per utilizzare sempre la finestra di dialogo del file non nativo.


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


Vedere anche: [[Property_editor/it|Editor delle proprietà]].
* {{PropertyData|Position}}: specifica la posizione del punto base della forma composta.
* {{PropertyData|Angle}}: specifica la rotazione della linea di base della forma.
* {{PropertyData|Axis}}: specifica l'asse da utilizzare per la rotazione.
* {{PropertyData|String}}: specifica la stringa di testo da visualizzare; a differenza dello strumento [[Draft Text/it|Testo]], [[Draft ShapeString/it|Forma da testo]] può visualizzare solo una singola riga.
* {{PropertyData|Size}}: specifica l'altezza generale delle lettere.
* {{PropertyData|Tracking}}: specifica la spaziatura inter-carattere aggiuntiva nella stringa.
* {{PropertyData|Font File}}: specifica il percorso completo del file di font utilizzato per disegnare la stringa.


Un oggetto Forma da testo è derivato da un [[Part_Part2DObject/it|Part Part2DObject]] e ne eredita tutte le proprietà. Ha anche le seguenti proprietà aggiuntive:
== Script ==

{{Emphasis|Vedere anche:}} [[Draft API/it|API Draft]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
<span id="Data"></span>
===Dati===

{{TitleProperty|Draft}}

* {{PropertyData|Font File|File}}: nome del file di carattere.
* {{PropertyData|Fuse|Bool}}: fonde le facce se si sovrappongono, solitamente non richiesto (può essere molto lento). Ignorato se {{PropertyData|Make Face}} è {{FALSE}}. {{Version/it|0.22}}
* {{PropertyData|Justification|Enumeration}}: allineamento orizzontale e verticale. Opzioni: {{value|Top-Left}}, {{value|Top-Center}}, {{value|Top-Right}}, {{value|Middle-Left}}, {{value|Middle-Center}}, {{value|Middle-Right}}, {{value|Bottom-Left}}, {{value|Bottom-Center}}, {{value|Bottom-Right}}. {{Version/it|0.22}}
* {{PropertyData|Justification Reference|Enumeration}}: riferimento di altezza utilizzato per la giustificazione. Opzioni: {{value|Cap Height}}, {{value|Shape Height}}. L'altezza della forma dipende dai caratteri in {{PropertyData|String}}. {{Version/it|0.22}}
* {{PropertyData|Keep Left Margin|Bool}}: mantiene il margine sinistro e lo spazio bianco iniziale quando viene lasciata la giustificazione. {{Version/it|0.22}}
* {{PropertyData|Make Face|Bool}}: riempie le lettere con facce.
* {{PropertyData|Oblique Angle|Angolo}}: angolo obliquo (inclinato). Deve essere compreso tra -80° e +80°. {{Version/it|0.22}}
* {{PropertyData|Scale To Size|Bool}}: scala per garantire che l'altezza del limite sia uguale alla dimensione. Se impostato su {{FALSE}}, a seconda del carattere, l'altezza del limite non corrisponderà esattamente a {{PropertyData|Size}}. {{Version/it|0.22}}
* {{PropertyData|Size|Length}}: altezza del testo.
* {{PropertyData|String|String}}: stringa di testo. Un ShapeString può visualizzare solo una singola riga di testo.
* {{PropertyData|Tracking|Distance}}: spaziatura tra caratteri. Il tipo di proprietà è stato aggiornato ({{Version/it|0.22}}).

[[Image:Draft_ShapeString_Justification.png|200px]]
{{Caption|L'altezza del rettangolo rosso (linea continua) è uguale all'altezza del carattere maiuscolo.<br>
L'altezza del rettangolo verde (linea tratteggiata) è uguale all'altezza della forma.<br>
Gli angoli, i punti medi dei bordi e il centro dei rettangoli<br>
corrispondono alle 9 opzioni di giustificazione: in alto a sinistra a in basso a destra.}}

<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 una Draft Forma da testo usare il metodo {{incode|make_shapestring}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makeShapeString}}.


Lo strumento ShapeString può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] tramite la seguente funzione:
{{Code|code=
{{Code|code=
ShapeString = makeShapeString(String, FontFile, Size=100, Tracking=0)
shapestring = make_shapestring(String, FontFile, Size=100, Tracking=0)
}}
}}


* Crea una forma composta {{incode|ShapeString}} usando la {{incode|String}} specificata e il percorso completo di un {{incode|FontFile}} supportato.
* Crea una forma composta {{incode|shapestring}} usando la {{incode|String}} specificata e il percorso completo di un {{incode|FontFile}} supportato.
* {{incode|Size}} è l'altezza in millimetri del testo risultante.
* {{incode|Size}} è l'altezza in millimetri del testo risultante.
* {{incode|Tracking}} è la spaziatura aggiuntiva tra i caratteri, in millimetri.
* {{incode|Tracking}} è la spaziatura tra caratteri in millimetri.


Il posizionamento di {{incode|ShapeString}} può essere cambiato sovrascrivendo il suo attributo {{incode|Placement}}, o sovrascrivendo singolarmente i suoi attributi {{incode|Placement.Base}} e {{incode|Placement.Rotation}}.
Il posizionamento di {{incode|ShapeString}} può essere cambiato sovrascrivendo il suo attributo {{incode|Placement}}, o sovrascrivendo singolarmente i suoi attributi {{incode|Placement.Base}} e {{incode|Placement.Rotation}}.


Esempio:
Esempio:

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

doc = App.newDocument()


font1 = "/usr/share/fonts/truetype/msttcorefonts/Arial.ttf"
font1 = "/usr/share/fonts/truetype/msttcorefonts/Arial.ttf"
Line 78: Line 153:
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"


S1 = Draft.makeShapeString("This is a sample text", font1, 200)
S1 = Draft.make_shapestring("This is a sample text", font1, 200)


S2 = Draft.makeShapeString("Inclined text", font2, 200, 10)
S2 = Draft.make_shapestring("Inclined text", font2, 200, 10)


ZAxis = FreeCAD.Vector(0, 0, 1)
zaxis = App.Vector(0, 0, 1)
p2 = FreeCAD.Vector(-1000, 500, 0)
p2 = App.Vector(-1000, 500, 0)
place2 = FreeCAD.Placement(p2, FreeCAD.Rotation(ZAxis, 45))
place2 = App.Placement(p2, App.Rotation(zaxis, 45))
S2.Placement = place2
S2.Placement = place2


S3 = Draft.makeShapeString("Upside-down text", font3, 200, 10)
S3 = Draft.make_shapestring("Upside-down text", font3, 200, 10)
S3.Placement.Base = FreeCAD.Vector(0, -1000, 0)
S3.Placement.Base = App.Vector(0, -1000, 0)
S3.Placement.Rotation = FreeCAD.Rotation(ZAxis, 180)
S3.Placement.Rotation = App.Rotation(zaxis, 180)

doc.recompute()
}}
}}


==Tutorial==


{{Docnav/it
* [[Draft_ShapeString_tutorial/it|Tutorial Forma da testo - ShapeString]]: come estrudere un testo, posizionarlo nello spazio 3D e creare un'incisione in un altro corpo.
|[[Draft_Facebinder/it|Lega facce]]
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623| Nice write up on using ShapeString with PartDesign]
|[[Draft_Hatch/it|Tratteggio]]

|[[Draft_Workbench/it|Draft]]
==Note==
|IconL=Draft_Facebinder.svg

|IconR=Draft_Hatch.svg
* Many fonts will generate problematic geometric. This is because font contours are allowed to overlap, have small gaps and have varying directions within a glyph. These conditions are considered errors in the Wires used to define Faces. Options are to correct the font definition with a tool like FontForge or to use another font.
|IconC=Workbench_Draft.svg

}}
{{Docnav/it|[[Draft_Point/it|Punto]]|[[Draft_Facebinder/it|Lega facce]]|[[Draft_Module/it|Draft]]|IconL=Draft_Point.svg |IconC=Workbench_Draft.svg|IconR=Draft_Facebinder.svg }}

{{Draft Tools navi/it}}


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

Latest revision as of 16:54, 8 December 2023

Forma da testo

Posizione nel menu
Drafting → Forma da testo
Ambiente
Draft, Arch
Avvio veloce
Nessuno
Introdotto nella versione
0.14
Vedere anche
Testo, Etichetta Estrusione

Descrizione

Il comando Forma da testo crea una forma composta che rappresenta una stringa di testo. Questa forma può essere utilizzata per creare lettere 3D con il comando Part Estrusione.

Il comando Forma da testo non è destinato alle annotazioni di testo standard. Il comando Testo o il comando Etichetta dovrebbe essere utilizzato a tale scopo.

Per posizionare una Forma da testo basta un singolo punto

Utilizzo

Per gli utenti Windows: leggere prima il paragrafo Selezione file font su Windows.

  1. Esistono diversi modi per invocare il comando:
    • Premere il pulsante Forma da testo.
    • Selezionare l'opzione Drafting → Forma da testo dal menu.
  2. Si apre il pannello attività Forma da testo.
  3. Fare clic su un punto nella Vista 3D o digitare le coordinate.
  4. Facoltativamente, premere il pulsante Reimposta punto per reimpostare il punto all'origine.
  5. Inserire una Stringa.
  6. Specificare l'Altezza.
  7. Per selezionare un carattere, eseguire una delle seguenti operazioni:
    • Inserire un percorso file nella casella di input Font file.
    • Premere il pulsante ... e selezionare un file.
  8. Premere il pulsante OK per terminare il comando.
  9. Facoltativamente, modificare il DatiJustification di ShapeString. Vedere Proprietà.

Opzioni

  • Premer Esc o il pulsante Annulla per interrompere il comando.

Note

  • Una Forma da testo può essere modificata facendo doppio clic su di essa nella Vista ad albero. disponibile dalla versione 0.20
  • I font supportati includono TrueType (.ttf), OpenType (.otf) e Type 1 (.pfb).
  • Il comando è limitato al testo da sinistra a destra. Il testo da destra a sinistra e dall'alto in basso non è supportato.
  • Altezze del testo molto piccole possono causare forme dei caratteri deformate a causa della perdita di dettagli nel ridimensionamento.
  • I font possono genererare geometrie problematiche. Questo perché i contorni dei caratteri possono sovrapporsi e avere piccoli spazi. Queste condizioni sono considerate errori nelle poliline utilizzate per definire le facce.
  • Forma da testo può anche essere creato con Macro Fonts Win10 PYMP.
  • Per creare Forme da testo disposte in modo circolare utilizzare il Macro FCCircularText.

Selezione file font su Windows

In Windows l'accesso alla cartella dei caratteri predefinita è limitato. Ciò influisce sulla selezione del file di carattere per Forma da testo. Esistono tre casi in FreeCAD in cui è possibile specificare un file di font per Forma da testo: nel pannello attività Forma da testo, quando si modifica la proprietà DatiFont File di una Forma da testo e quando si specifica il file di font predefinito in Preferenze per l'ambiente Draft.

Non è possibile premere il pulsante ... e quindi selezionare un file dalla cartella predefinita dei font di Windows quando si utilizza la finestra di dialogo dei file nativi. Ci sono una serie di soluzioni alternative:

  • Assicurarsi che DontUseNativeFontDialog sia impostato su true, che è il valore predefinito per questa preferenza. Questo chiamerà una finestra di dialogo file diversa, non nativa, solo quando si preme il pulsante ... nel pannello attività Forma da testo. Con questa finestra di dialogo è possibile accedere alla cartella predefinita dei font di Windows.
  • Cambiare DontUseNativeDialog in true. Ciò indica a FreeCAD di utilizzare sempre la finestra di dialogo dei file non nativi.
  • Specificare il file del carattere nella casella di immissione. Ovviamente è possibile digitare il percorso completo o copiare e incollare il percorso da Esplora file di Windows. Ma c'è anche un altro modo per entrare nella cartella. Se si inserisce C:\ apparirà un elenco a tendina. Selezionare Windows da quell'elenco e aggiungere \F. Selezionare Fonts dal nuovo elenco a discesa. Infine aggiungere \ e le prime lettere del file del font, quindi selezionalo dall'elenco a discesa.
  • Creare una cartella personalizzata contenente i file dei font.

Vedere il paragrafo Preferenze di seguito per la posizione delle preferenze citate.

Tutorial

Preferenze

Vedere anche: Impostare le Preferenze, Preferenze per l'ambiente Draft e Modifica parametri.

  • Il file di font predefinito può essere modificato nelle preferenze: Modifica → Preferenze... → Draft → Testi e quotature → Font predefinito per Forma da testo.
  • Per utenti Windows:
    • Impostare Strumenti → Modifica parametri... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog su true per utilizzare la finestra di dialogo del file non nativo quando si seleziona un file di carattere dal pannello delle attività Forma da testo.
    • In alternativa, impostare Strumenti → Modifica parametri... → BaseApp → Preferences → Dialog → DontUseNativeDialog su true per utilizzare sempre la finestra di dialogo del file non nativo.

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Forma da testo è derivato da un Part Part2DObject e ne eredita tutte le proprietà. Ha anche le seguenti proprietà aggiuntive:

Dati

Draft

  • DatiFont File (File): nome del file di carattere.
  • DatiFuse (Bool): fonde le facce se si sovrappongono, solitamente non richiesto (può essere molto lento). Ignorato se DatiMake Face è false. disponibile dalla versione 0.22
  • DatiJustification (Enumeration): allineamento orizzontale e verticale. Opzioni: Top-Left, Top-Center, Top-Right, Middle-Left, Middle-Center, Middle-Right, Bottom-Left, Bottom-Center, Bottom-Right. disponibile dalla versione 0.22
  • DatiJustification Reference (Enumeration): riferimento di altezza utilizzato per la giustificazione. Opzioni: Cap Height, Shape Height. L'altezza della forma dipende dai caratteri in DatiString. disponibile dalla versione 0.22
  • DatiKeep Left Margin (Bool): mantiene il margine sinistro e lo spazio bianco iniziale quando viene lasciata la giustificazione. disponibile dalla versione 0.22
  • DatiMake Face (Bool): riempie le lettere con facce.
  • DatiOblique Angle (Angolo): angolo obliquo (inclinato). Deve essere compreso tra -80° e +80°. disponibile dalla versione 0.22
  • DatiScale To Size (Bool): scala per garantire che l'altezza del limite sia uguale alla dimensione. Se impostato su false, a seconda del carattere, l'altezza del limite non corrisponderà esattamente a DatiSize. disponibile dalla versione 0.22
  • DatiSize (Length): altezza del testo.
  • DatiString (String): stringa di testo. Un ShapeString può visualizzare solo una singola riga di testo.
  • DatiTracking (Distance): spaziatura tra caratteri. Il tipo di proprietà è stato aggiornato (disponibile dalla versione 0.22).

L'altezza del rettangolo rosso (linea continua) è uguale all'altezza del carattere maiuscolo.
L'altezza del rettangolo verde (linea tratteggiata) è uguale all'altezza della forma.
Gli angoli, i punti medi dei bordi e il centro dei rettangoli
corrispondono alle 9 opzioni di giustificazione: in alto a sinistra a in basso a destra.

Script

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

Per creare una Draft Forma da testo usare il metodo make_shapestring (disponibile dalla versione 0.19) del modulo Draft. Questo metodo sostituisce il metodo deprecato makeShapeString.

shapestring = make_shapestring(String, FontFile, Size=100, Tracking=0)
  • Crea una forma composta shapestring usando la String specificata e il percorso completo di un FontFile supportato.
  • Size è l'altezza in millimetri del testo risultante.
  • Tracking è la spaziatura tra caratteri in millimetri.

Il posizionamento di ShapeString può essere cambiato sovrascrivendo il suo attributo Placement, o sovrascrivendo singolarmente i suoi attributi Placement.Base e Placement.Rotation.

Esempio:

import FreeCAD as App
import Draft

doc = App.newDocument()

font1 = "/usr/share/fonts/truetype/msttcorefonts/Arial.ttf"
font2 = "/usr/share/fonts/truetype/dejavu/DejaVuSerif.ttf"
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"

S1 = Draft.make_shapestring("This is a sample text", font1, 200)

S2 = Draft.make_shapestring("Inclined text", font2, 200, 10)

zaxis = App.Vector(0, 0, 1)
p2 = App.Vector(-1000, 500, 0)
place2 = App.Placement(p2, App.Rotation(zaxis, 45))
S2.Placement = place2

S3 = Draft.make_shapestring("Upside-down text", font3, 200, 10)
S3.Placement.Base = App.Vector(0, -1000, 0)
S3.Placement.Rotation = App.Rotation(zaxis, 180)

doc.recompute()