Draft ShapeString/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(35 intermediate revisions by 2 users not shown)
Line 47: Line 47:
#* Premere il pulsante {{Button|...}} e selezionare un file.
#* Premere il pulsante {{Button|...}} e selezionare un file.
# Premere il pulsante {{Button|OK}} per terminare il comando.
# Premere il pulsante {{Button|OK}} per terminare il comando.
# Facoltativamente, modificare il {{PropertyData|Justification}} di ShapeString. Vedere [[#Proprietà|Proprietà]].


<span id="Options"></span>
<span id="Options"></span>
Line 58: Line 59:
* Una Forma da testo può essere modificata facendo doppio clic su di essa nella [[Tree_view/it|Vista ad albero]]. {{Version/it|0.20}}
* Una Forma da testo può essere modificata facendo doppio clic su di essa nella [[Tree_view/it|Vista ad albero]]. {{Version/it|0.20}}
* I font supportati includono TrueType ({{FileName|.ttf}}), OpenType ({{FileName|.otf}}) e Type 1 ({{FileName|.pfb}}).
* I font supportati includono TrueType ({{FileName|.ttf}}), OpenType ({{FileName|.otf}}) e Type 1 ({{FileName|.pfb}}).
* Il comando è limitato al testo LTR (da sinistra a destra). Pertanto al momento il testo RTL (da destra a sinistra + dall'alto verso il basso) non è supportato.
* 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.
* Altezze del testo molto piccole possono causare forme dei caratteri deformate a causa della perdita di dettagli nel ridimensionamento.
* Molti font genereranno geometrie problematiche. Questo perché i contorni dei caratteri possono sovrapporsi, avere piccoli spazi e avere direzioni diverse all'interno di un glifo. Queste condizioni sono considerate errori nelle poliline utilizzate per definire le facce.
* 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]].
* 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]].
* Per creare Forme da testo disposte in modo circolare utilizzare il [[Macro_FCCircularText/it|Macro FCCircularText]].
Line 67: Line 68:
==Selezione file font su Windows==
==Selezione file font su Windows==


On Windows access to the default font folder is restricted. This affects the font file selection for ShapeStrings. There are three cases in FreeCAD where a font file for ShapeStrings can be specified: in the ShapeString task panel, when changing the {{PropertyData|Font File}} property of a ShapeString, and when specifying the default font file in the [[Draft_Preferences#Texts_and_dimensions|Draft Preferences]].
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]].


Pressing the {{Button|...}} button and then selecting a file from the default Windows font folder is not possible when using the native file dialog. There are a number of workarounds:
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:
* Make sure {{MenuCommand|DontUseNativeFontDialog}} is set to {{True}}, which is the default value for this preference. This will only call a different, non-native, file dialog when pressing the {{Button|...}} button in the ShapeString task panel. With this file dialog the default Windows font folder can be accessed.
* 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.
* Change {{MenuCommand|DontUseNativeDialog}} to {{True}}. This instructs FreeCAD to always use the non-native file dialog.
* Cambiare {{MenuCommand|DontUseNativeDialog}} in {{True}}. Ciò indica a FreeCAD di utilizzare sempre la finestra di dialogo dei file non nativi.
* Specify the font file in the input box. You can of course type the full path or copy-paste the path from the Windows File Explorer. But there is also another way to enter the path. If you enter {{Value|C:\}} a dropdown list will appear. Select {{Value|Windows}} from that list and add {{Value|\F}}. Select {{Value|Fonts}} from the new dropdown list. Finally add {{Value|\}} and the first letter(s) of the font file, and then select it from the dropdown list.
* 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.
* Create a custom folder for your font files.


Vedere il paragrafo [[#Preferenze|Preferenze]] di seguito per la posizione delle preferenze citate.
See the [[#Preferences|Preferences]] paragraph below for the location of the mentioned preferences.


<span id="Tutorials"></span>
<span id="Tutorials"></span>
Line 83: Line 84:
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623 How to use ShapeStrings in PartDesign]
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623 How to use ShapeStrings in PartDesign]


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


See also: [[Preferences_Editor|Preferences Editor]], [[Draft_Preferences|Draft Preferences]] and [[Std_DlgParameter|Std DlgParameter]].
Vedere anche: [[Preferences_Editor/it|Impostare le Preferenze]], [[Draft_Preferences/it|Preferenze per l'ambiente Draft]] e [[Std_DlgParameter/it|Modifica parametri]].


* The default font file can be changed in the preferences: {{MenuCommand|EditPreferences... → Draft → Texts and dimensionsDefault ShapeString font file}}.
* Il file di font predefinito può essere modificato nelle preferenze: {{MenuCommand|ModificaPreferenze... → Draft → Testi e quotatureFont predefinito per Forma da testo}}.
* For Windows users:
* Per utenti Windows:
** Set {{MenuCommand|ToolsEdit parameters... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog}} to {{True}} to use the non-native file dialog when selecting a font file from the ShapeString task panel.
** Impostare {{MenuCommand|StrumentiModifica 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.
** Alternatively, set {{MenuCommand|ToolsEdit parameters... → BaseApp → Preferences → Dialog → DontUseNativeDialog}} to {{True}} to always use the non-native file dialog.
** In alternativa, impostare {{MenuCommand|StrumentiModifica parametri... → BaseApp → Preferences → Dialog → DontUseNativeDialog}} su {{True}} per utilizzare sempre la finestra di dialogo del file non nativo.


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


See also: [[Property_editor|Property editor]].
Vedere anche: [[Property_editor/it|Editor delle proprietà]].


A Draft ShapeString object is derived from a [[Part_Part2DObject|Part Part2DObject]] and inherits all its properties. It also has the following additional properties:
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:


===Data===
<span id="Data"></span>
===Dati===


{{TitleProperty|Draft}}
{{TitleProperty|Draft}}


* {{PropertyData|Font File|File}}: nome del file di carattere.
<div class="mw-translate-fuzzy">
* {{PropertyData|Fuse|Bool}}: fonde le facce se si sovrappongono, solitamente non richiesto (può essere molto lento). Ignorato se {{PropertyData|Make Face}} è {{FALSE}}. {{Version/it|1.0}}
* {{PropertyData|Position}}: specifica la posizione del punto base della forma composta.
* {{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|1.0}}
* {{PropertyData|Angle}}: specifica la rotazione della linea di base della forma.
* {{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|1.0}}
* {{PropertyData|Axis}}: specifica l'asse da utilizzare per la rotazione.
* {{PropertyData|Keep Left Margin|Bool}}: mantiene il margine sinistro e lo spazio bianco iniziale quando viene lasciata la giustificazione. {{Version/it|1.0}}
* {{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|Make Face|Bool}}: riempie le lettere con facce.
* {{PropertyData|Oblique Angle|Angolo}}: angolo obliquo (inclinato). Deve essere compreso tra -80° e +80°. {{Version/it|1.0}}
* {{PropertyData|Tracking}}: specifica la spaziatura inter-carattere aggiuntiva nella stringa.
* {{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|1.0}}
* {{PropertyData|Font File}}: specifica il percorso completo del file di font utilizzato per disegnare la stringa.
* {{PropertyData|Size|Length}}: altezza del testo.
</div>
* {{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|1.0}}).


[[Image:Draft_ShapeString_Justification.png|200px]]
===View===
{{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>
{{TitleProperty|Draft}}
==Script==

* {{PropertyView|Pattern|Enumeration}}: specifies the [[Draft_Pattern|Draft Pattern]] with which to fill the faces of the text. This property only works if {{PropertyView|Display Mode}} is {{value|Flat Lines}}.
* {{PropertyView|Pattern Size|Float}}: specifies the size of the [[Draft_Pattern|Draft Pattern]].

==Scripting==


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
<div class="mw-translate-fuzzy">
== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|API Draft]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
</div>


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}}.
<div class="mw-translate-fuzzy">
Lo strumento ShapeString può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] tramite la seguente funzione:
</div>


{{Code|code=
{{Code|code=
Line 135: Line 135:
}}
}}


* Crea una forma composta {{incode|shapestring}} usando la {{incode|String}} specificata e il percorso completo di un {{incode|FontFile}} supportato.
<div class="mw-translate-fuzzy">
* 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.
</div>


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

Revision as of 20:28, 23 April 2024

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 1.0
  • 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 1.0
  • 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 1.0
  • DatiKeep Left Margin (Bool): mantiene il margine sinistro e lo spazio bianco iniziale quando viene lasciata la giustificazione. disponibile dalla versione 1.0
  • DatiMake Face (Bool): riempie le lettere con facce.
  • DatiOblique Angle (Angolo): angolo obliquo (inclinato). Deve essere compreso tra -80° e +80°. disponibile dalla versione 1.0
  • 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 1.0
  • 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 1.0).

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