Draft ShapeString/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(83 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<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
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/it|Name=Draft_ShapeString|Name/it=ShapeString|Workbenches=[[Draft Module|Draft]], [[Arch Module/it|Arch]]|MenuLocation=Draft → ShapeString|Shortcut=S S}}
{{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/it|[[Image:Draft_ShapeString16.png]] Draft ShapeString}}, oppure il tasto {{KEY/it|S}} poi {{KEY/it|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/it|ENTER}}
# Inserire l'altezza voluta poi premere {{KEY/it|ENTER}}
# Immettere il testo desiderato e premere {{KEY|Invio}}.
# Inserire la spaziatura desiderata poi premere {{KEY/it|ENTER}}
# Immettere la dimensione desiderata e premere {{KEY|Invio}}.
# Immettere il percorso desiderato e premere {{KEY|Invio}}.
# Premere {{KEY/it|ENTER}} per accettare il tipo di carattere visualizzato, oppure,
# Premere il pulsante con tre puntini {{KEY/it|...}} 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/it|ENTER}} tra ognuno dei componenti X, Y e Z.
* Premere {{KEY/it|ESC}} per annullare l'operazione.
* You can set a default font file in Draft/Prefences.


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


==== Vista ====
=== Limitazioni ===
* Altezze di testo molto ridotte possono causare deformazioni delle forme del carattere a causa della perdita di dettagli nel ridimensionamento.
Sono disponibili le [[DraftStandardProperty/it|Proprietà standard]] di visualizzazione.
* La versione corrente mostra solo un testo scritto in orizzontale da sinistra a destra.
==== Dati ====
* Per creare un testo curvo è possibile utilizzare la macro {{Button|[[File:FCCircularTextButtom.png|24px]] [[Macro_FCCircularText/it|Testo circolare]]}}.
{|
| [[File:DraftShapeStringProperty_it.png|left]]
|
{{KEY/it|2D}}
{{KEY/it|Base}}
* {{ProprietaDati|Label}}: nome
* {{ProprietaDati|Placement}}: [[Placement/it|posizionamento]] del punto base della forma costruita
{{KEY/it|Draft}}
* {{ProprietaDati|Font File}}: Il tipo di carattere utilizzato per disegnare la stringa di testo
* {{ProprietaDati|Size}}: L'altezza dei caratteri in unità FC
* {{ProprietaDati|String}}: Il contenuto della stringa di testo
* {{ProprietaDati|Tracking}}: La spaziatura tra i caratteri in unità FC
|}
{{clear}}


=== Script ===
== Opzioni ==


* 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.
Lo strumento ShapeString può essere utilizzato nelle [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console Python]] tramite la seguente funzione:
* Premere il tasto {{KEY|Esc}} o il pulsante {{button|Chiudi}} per interrompere il comando corrente.


== Proprietà ==

<div class="mw-translate-fuzzy">
* {{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">
== 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:
{{Code|code=
{{Code|code=
makeShapeString(String,FontFile,[Size],[Tracking])
ShapeString = makeShapeString(String, FontFile, Size=100, Tracking=0)
}}
}}
* Trasforma una stringa di testo in una Compound Shape utilizzando un font specificato.


* 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.
* {{incode|Tracking}} è la spaziatura aggiuntiva tra i 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}}.

Esempio:
{{Code|code=
{{Code|code=
import FreeCAD,Draft
import FreeCAD as App
import Draft
Draft.makeShapeString("This is a sample text",

"/usr/share/fonts/truetype/msttcorefonts/Arial.ttf",
doc = App.newDocument()
200.0,10)

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()
}}
}}
===Selezionare un Font===
[[Image:SSFontSelect.png]]


==Tutorial==
ShapeString utilizza la geometria interna di un font per creare delle forme di FreeCAD. Per fare questo deve poter leggere il file del font attivo (*.tff, etc). Se la casella di selezione dei font è vuota, è necessario digitare il percorso completo del file di font o usare {{KEY | ...}} per selezionare un file di font.
==Limitations==
* This tool is not available in FreeCAD versions anterior to 0.14
* TrueType(*.ttf), OpenType(*.otf) and Type1(*.pfb) font files are supported.
* Very small text heights may result in deformed character glyphs due to loss of detail in scaling.
* The current version is limited to left-to-right layouts on a horizontal baseline.


* [[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.
==Tutorials==
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623 How to use ShapeStrings in PartDesign]
+ [[Draft_ShapeString_tutorial|Draft ShapeString 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.
<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
}}

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