Draft ShapeString/it: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
(116 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Draft_ShapeString|Workbenches=[[Draft Module|Draft]]|MenuLocation=Draft -> ShapeString|Shortcut=S S}}
{{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
}}

<div class="mw-translate-fuzzy">
{{GuiCommand/it
|Name=Draft_ShapeString
|Name/it=ShapeString
|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Arch]]
|MenuLocation=Draft → Forma da testo...
|Shortcut={{KEY|S}} {{KEY|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}}
</div>

==Descrizione==
==Descrizione==


<div class="mw-translate-fuzzy">
Lo strumento ShapeString inserisce una forma composta che riproduce una stringa di testo in un dato punto del documento corrente.
Lo strumento ShapeString inserisce una forma composta che riproduce una stringa di testo in un dato punto del documento corrente.
Si possono definire gli attributi del testo quali altezza, tipo di carattere, ecc..
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.
</div>

<div class="mw-translate-fuzzy">
Per inserire un elemento di testo più semplice senza una forma chiusa, utilizzare [[Image:Draft_Text.svg|24px]] [[Draft Text/it|Testo]]. Per creare un'etichetta di testo con una linea guida e una freccia usare [[Image:Draft_Label.svg|24px]] [[Draft Label/it|Etichetta]].
</div>


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

==Utilizzo==
==Utilizzo==


Se la modalità dell'interfaccia di Draft è impostata su ToolBar:
# Premere il pulsante {{KEY|[[Image:Draft_ShapeString16.png]] [[Draft ShapeString]]}}, oppure il tasto {{KEY|S}} poi {{KEY|S}}
# Premere il pulsante {{Button|[[Image:Draft_ShapeString.svg|16px]] [[Draft_ShapeString/it|Forma da testo...]]}} , o premere i tasti {{KEY|S}} e poi {{KEY|S}}.
# Cliccare in un punto della vista in 3D, oppure inserire le sue [[Draft_Coordinates/it|coordinate]]
# 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]]}}.
# Inserire il testo poi premere {{KEY|ENTER}}
# Inserire l'altezza voluta poi premere {{KEY|ENTER}}
# Immettere il testo desiderato e premere {{KEY|Invio}}.
# Inserire la spaziatura desiderata poi premere {{KEY|ENTER}}
# Immettere la dimensione desiderata e premere {{KEY|Invio}}.
# Immettere il percorso desiderato e premere {{KEY|Invio}}.
# Premere {{KEY|ENTER}} per accettare il tipo di carattere visualizzato, oppure,
# Premere il pulsante con tre puntini {{KEY|...}} per selezionare un tipo di carattere diverso.
# Premere {{KEY|Invio}} per accettare il file di font visualizzato, o premere {{Button|...}} per selezionare un file di font.
[[Image:SSFontSelect.png]]


Se la modalità dell'interfaccia di Draft è impostata su Vista azioni:
==Opzioni==
# Premere il pulsante {{Button|[[Image:Draft_ShapeString.svg|16px]] [[Draft_ShapeString/it|Forma da testo]]}}, o premere i tasti {{KEY|S}} e poi {{KEY|S}}.
# Appare una finestra di dialogo in cui è possibile specificare i parametri.
# Premere {{KEY|OK}} per creare la forma dal testo.


* Per inserire le coordinate manualmente, basta inserire i numeri, quindi premere {{KEY|ENTER}} tra ognuno dei componenti X, Y e Z.
* Premere {{KEY|ESC}} per annullare l'operazione.


* Il testo, le dimensioni, il percorso e il carattere possono essere modificati dopo la creazione, modificando i valori nell'editor delle proprietà.
==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).


=== Limitazioni ===
[[File:DraftShapeStringProperty_it.png|left]]
* 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_FCCircularText/it|Testo circolare]]}}.


== Opzioni ==
* {{ProprietaDati|Position}}: Il punto base della forma composta
* {{ProprietaDati|String}}: Il contenuto della stringa di testo
* {{ProprietaDati|Size}}: L'altezza dei caratteri in unità FC
* {{ProprietaDati|Tracking}}: La spaziatura tra i caratteri in unità FC
* {{ProprietaDati|Font File}}: Il tipo di carattere utilizzato per disegnare la stringa di testo
{{clear}}


* 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.
Inoltre sono disponibili le [[DraftStandardProperty/it|Proprietà standard]] di visualizzazione e di [[Placement/it|posizionamento]] degli oggetti.
* Premere il tasto {{KEY|Esc}} o il pulsante {{button|Chiudi}} per interrompere il comando corrente.


== Proprietà ==
* {{ProprietaDati|Size}}: L'altezza dei caratteri in unità FC
* {{ProprietaDati|Tracking}}: La spaziatura tra i caratteri in unità FC
* {{ProprietaDati|Font File}}: Il tipo di carattere utilizzato per disegnare la stringa di testo


<div class="mw-translate-fuzzy">
==Script==
* {{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.
</div>


<div class="mw-translate-fuzzy">
Lo strumento ShapeString può essere utilizzato nelle [[macros/it|macro]] e dalla console python tramite la seguente funzione:
== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|API Draft]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
</div>


Lo strumento ShapeString può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] tramite la seguente funzione:
'''makeShapeString(String,FontFile,[Size],[Tracking])''' : Turns a text string into a
{{Code|code=
Compound Shape using a specified font.
ShapeString = makeShapeString(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.
Esempio:
* {{incode|Size}} è l'altezza in millimetri del testo risultante.
<syntaxhighlight>
* {{incode|Tracking}} è la spaziatura aggiuntiva tra i caratteri, in millimetri.
import FreeCAD,Draft
Draft.makeShapeString("This is a sample text",
"/usr/share/fonts/truetype/msttcorefonts/Arial.ttf',
200.0,10)</syntaxhighlight>
==Limitazioni==
* Questo strumento non è ancora disponibile. Sarà incluso nella prossima versione. (post v0.13)
* Sono supportati i caratteri di tipo TrueType(*.ttf), OpenType(*.otf) e Type1(*.pfb).
* Altezze di testo molto piccole possono comportare la deformazione dei glifi dei caratteri a causa della perdita dei dettagli nella scalatura.
* La versione corrente mostra solo un testo scritto in orizzontale da sinistra a destra.
* Very small text heights may result in deformed character glyphs due to loss of detail in scaling.


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

Esempio:
{{Code|code=
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.makeShapeString("This is a sample text", font1, 200)

S2 = Draft.makeShapeString("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.makeShapeString("Upside-down text", font3, 200, 10)
S3.Placement.Base = App.Vector(0, -1000, 0)
S3.Placement.Rotation = App.Rotation(ZAxis, 180)

doc.recompute()
}}

==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]

==Note==

* Molti caratteri generano problemi geometrici. Questo perché i contorni dei caratteri possono sovrapporsi, avere piccoli spazi vuoti e direzioni diverse all'interno di un glifo. Queste condizioni sono considerate errori nei contorni utilizzati per definire le facce. Le opzioni sono di correggere la definizione del carattere con uno strumento come FontForge o di usare un altro carattere.

{{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{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 20:58, 20 November 2020

ShapeString

Posizione nel menu
Draft → Forma da testo...
Ambiente
Draft, Arch
Avvio veloce
S S
Introdotto nella versione
0.14
Vedere anche
Testo Draft, Part Estrusione,
Macro Fonts Win10 PYMP

Descrizione

Lo strumento ShapeString inserisce una forma composta che riproduce una stringa di testo in un dato punto del documento corrente. Si possono definire gli attributi del testo quali altezza, tipo di carattere, ecc.. La forma risultante può essere utilizzata con lo strumento Estrusione di Part per creare lettere 3D.

Per inserire un elemento di testo più semplice senza una forma chiusa, utilizzare Testo. Per creare un'etichetta di testo con una linea guida e una freccia usare Etichetta.

Per posizionare una Shapestring basta un singolo punto

Utilizzo

Se la modalità dell'interfaccia di Draft è impostata su ToolBar:

  1. Premere il pulsante Forma da testo... , o premere i tasti S e poi S.
  2. Selezionare un punto nella vista 3D, o digitare le sue coordinate e poi premere il pulsante aggiungi punto.
  3. Immettere il testo desiderato e premere Invio.
  4. Immettere la dimensione desiderata e premere Invio.
  5. Immettere il percorso desiderato e premere Invio.
  6. Premere Invio per accettare il file di font visualizzato, o premere ... per selezionare un file di font.

Se la modalità dell'interfaccia di Draft è impostata su Vista azioni:

  1. Premere il pulsante Forma da testo, o premere i tasti S e poi S.
  2. Appare una finestra di dialogo in cui è possibile specificare i parametri.
  3. Premere OK per creare la forma dal testo.


  • 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 Preferenze di Draft, nella scheda 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).

Limitazioni

  • 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 Testo circolare.

Opzioni

  • Per inserire le coordinate manualmente, è sufficiente inserire i numeri, quindi premere Invio per ciascun componente X, Y e Z.. È possibile premere il pulsante Inserisci punto quando si hanno i valori desiderati per inserire il punto.
  • Premere il tasto Esc o il pulsante Chiudi per interrompere il comando corrente.

Proprietà

  • DatiPosition: specifica la posizione del punto base della forma composta.
  • DatiAngle: specifica la rotazione della linea di base della forma.
  • DatiAxis: specifica l'asse da utilizzare per la rotazione.
  • DatiString: specifica la stringa di testo da visualizzare; a differenza dello strumento Testo, Forma da testo può visualizzare solo una singola riga.
  • DatiSize: specifica l'altezza generale delle lettere.
  • DatiTracking: specifica la spaziatura inter-carattere aggiuntiva nella stringa.
  • DatiFont File: specifica il percorso completo del file di font utilizzato per disegnare la stringa.

Lo strumento ShapeString può essere utilizzato nelle macro e dalla console Python tramite la seguente funzione:

ShapeString = makeShapeString(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 aggiuntiva tra i 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.makeShapeString("This is a sample text", font1, 200)

S2 = Draft.makeShapeString("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.makeShapeString("Upside-down text", font3, 200, 10)
S3.Placement.Base = App.Vector(0, -1000, 0)
S3.Placement.Rotation = App.Rotation(ZAxis, 180)

doc.recompute()

Tutorial

Note

  • Molti caratteri generano problemi geometrici. Questo perché i contorni dei caratteri possono sovrapporsi, avere piccoli spazi vuoti e direzioni diverse all'interno di un glifo. Queste condizioni sono considerate errori nei contorni utilizzati per definire le facce. Le opzioni sono di correggere la definizione del carattere con uno strumento come FontForge o di usare un altro carattere.