Draft Label/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>


<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it
|[[Draft_Dimension/it|Quotatura]]
|[[Draft CubicBezCurve/it|Curva di Bézier cubica]]
|[[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]]
|[[Draft_Move/it|Sposta]]
|[[Draft_Workbench/it|Draft]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft CubicBezCurve.svg
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Move.svg
}}
}}
</div>


<div class="mw-translate-fuzzy">
{{GuiCommand/it
{{GuiCommand/it
|Name=Draft Label
|Name=Draft Label
|Name/it=Etichetta
|Name/it=Etichetta
|MenuLocation=Draft → Etichetta
|MenuLocation=Annotazione → Etichetta
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut={{KEY|D}} {{KEY|L}}
|Shortcut={{KEY|D}} {{KEY|L}}
|Version=0.17
|Version=0.17
|SeeAlso=[[Draft Text/it|Testo]], [[Draft ShapeString/it|Forma da testo]]
|SeeAlso=[[Draft_Text/it|Testo]], [[Draft_ShapeString/it|Forma da testo]]
}}
}}
</div>


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


Il comando [[Image:Draft_Label.svg|24px]] '''Etichetta''' crea un testo su più righe con una linea guida a 2 segmenti e una freccia.
<div class="mw-translate-fuzzy">
Lo strumento Etichetta inserisce una casella di testo su più righe con una linea guida a 2 segmenti e una freccia. Se si seleziona un oggetto o un sottoelemento (faccia, bordo o vertice) all'avvio del comando, è possibile creare un'etichetta per visualizzare un determinato attributo dell'elemento selezionato, tra cui posizione, lunghezza, area, volume o materiale.
</div>


Se un oggetto o un sottoelemento (faccia, bordo o vertice) viene selezionato all'avvio del comando, il testo può visualizzare uno o due attributi dell'elemento selezionato, tra cui posizione, lunghezza, area, volume e materiale. Il testo sarà quindi collegato a detti attributi e si aggiornerà se i loro valori cambiano.
If an object or a sub-element (face, edge or vertex) is selected when starting the command, the text can be made to display one or two attributes of the selected element, including position, length, area, volume and material. The text will then be linked to the attributes and will update if their values change.


Per inserire un elemento di testo senza una freccia usare invece il comando [[Draft_Text/it|Testo]].
<div class="mw-translate-fuzzy">
Per inserire un elemento di testo più semplice senza una freccia usare [[Draft Text/it|Testo]]. Per creare forme di testo solido usare [[Draft ShapeString/it|Forma da testo]] con [[Part Extrude/it|Estrusione]].
</div>


[[Image:Draft_Label_example.jpg|400px]]
[[Image:Draft_Label_example.jpg|400px]]
{{Caption|Varie etichette con diversi orientamenti, frecce ed informazioni}}
<div class="mw-translate-fuzzy">
{{Caption|Varie etichette con diversi orientamenti, simboli terminali e informazioni}}
</div>


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


See also: [[Draft_Tray|Draft Tray]], [[Draft_Snap|Draft Snap]] and [[Draft_Constrain|Draft Constrain]].
Vedere anche: [[Draft_Tray/it|Barra di Draft]], [[Draft_Snap/it|Aggancio]] e [[Draft_Constrain/it|Vincolare]].


# Facoltativamente selezionare un oggetto o un sottoelemento (vertice, bordo o faccia) di cui si desidera visualizzare gli attributi.
<div class="mw-translate-fuzzy">
# Esistono diversi modi per invocare il comando:
# Premere il pulsante {{Button|[[Image:Draft Label.svg|16px]] [[Draft Label/it|Etichetta]]}}, o premere i tasti {{KEY|D}} e poi {{KEY|L}}.
#* Premere il pulsante {{Button|[[Image:Draft_Label.svg|16px]] [[Draft_Label/it|Etichetta]]}}.
# Selezionare un primo punto nella vista 3D, oppure digitare le sue coordinate e poi premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Aggiungi punto}}. Questo punto indica l'obiettivo (punta della freccia) che può essere ovunque, non è necessario che sia un elemento.
#* Selezionare l'opzione {{MenuCommand|Annotazione → [[Image:Draft_Label.svg|16px]] Etichetta}} dal menu.
# Fare clic su un secondo punto nella vista 3D o digitare una coordinata e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] aggiungi punto}}. Questo punto indica l'inizio di una linea guida orizzontale o verticale.
#* Usare la scorciatoia da tastiera: {{KEY|D}} poi {{KEY|L}}.
# Fare clic su un terzo punto nella vista 3D o digitare una coordinata e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] aggiungi punto}}. Questo punto indica il punto base del testo.
# Si apre il pannello attività {{MenuCommand|Etichetta}}. Vedere [[#Options|Opzioni]] per maggiori informazioni.
</div>
# Se si ha selezionato un elemento: selezionare un'opzione dall'elenco a discesa {{MenuCommand|Tipo di etichetta}}. Vedere [[#Tipi di etichette|Tipi di etichette]] di seguito.
# Scegliere il primo punto nella [[3D_view/it|Vista 3D]], oppure digitare le coordinate e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}}. Questo punto indica il bersaglio (punta della freccia). Questo può essere ovunque, non deve essere su un elemento.
# Scegliere il secondo punto nella [[3D_view/it|Vista 3D]], oppure digitare le coordinate e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}}. Questo punto indica l'inizio del segmento orizzontale o verticale della direttrice.
# Scegliere il terzo punto nella [[3D_view/it|Vista 3D]], oppure digitare le coordinate e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}}. Questo punto indica il punto base del testo.


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


Le scorciatoie da tastiera a carattere singolo disponibili nel pannello delle attività possono essere modificate. Vedere [[Draft_Preferences/it|Preferenze per l'ambiente Draft]]. Le scorciatoie menzionate qui sono le scorciatoie predefinite.
The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts.


* 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 si hanno i valori desiderati. Si consiglia di spostare il puntatore fuori dalla [[3D_view/it|Vista 3D]] prima di inserire le coordinate.
<div class="mw-translate-fuzzy">
* Premere {{KEY|R}} o fare clic sulla casella di controllo {{MenuCommand|Relativo}} per attivare o disattivare la modalità relativa. Se la modalità relativa è attiva, le coordinate sono relative all'ultimo punto, se disponibile, altrimenti sono relative all'origine del sistema di coordinate.
* Cliccare su {{Button|Label type}} per selezionare il tipo di informazioni da visualizzare, incluso "Custom", "Name", "Label", "Position", "Length", "Area", "Volume", "Tag", e "Material". (Vedere le spiegazioni sotto, in [[Draft_Label/it#Tipi_di_etichette|Tipi di etichette]])
* 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}}
* 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]] Inserisci punto}} quando si hanno i valori desiderati per inserire il punto.
* Premere {{KEY|S}} per attivare o disattivare [[Draft_Snap/it|Aggancia]].
* Tenere premuto {{KEY|Ctrl}} mentre si posiziona l'etichetta per forzare lo [[Draft_Snap|snap]] al punto di aggancio più vicino, indipendentemente dalla distanza.
* Premere il tasto {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando corrente.
* Premere {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando.
</div>


<span id="Label_types"></span>
<div class="mw-translate-fuzzy">
==== Tipi di etichette ====
== Tipi di etichette ==
</div>


Sono disponibili i seguenti tipi di etichette:
The following label types are available:


* {{Value|Custom}}: visualizza il contenuto di {{PropertyData|Custom Text}}.
<div class="mw-translate-fuzzy">
* {{Value|Name}}: visualizza il nome interno dell'oggetto target. Il nome interno viene assegnato quando viene creato un oggetto e rimane fisso per tutta l'esistenza dell'oggetto.
* {{Emphasis|Custom:}} visualizza il contenuto di {{PropertyData|Custom Text}}.
* {{Emphasis|Name:}} visualizza il nome interno dell'oggetto destinatario; il nome interno viene assegnato all'oggetto al momento della sua creazione e rimane fisso per tutta l'esistenza dell'oggetto.
* {{Value|Label}}: visualizza l'etichetta dell'oggetto target. L'etichetta di un oggetto può essere modificata dall'utente.
* {{Emphasis|Label:}} visualizza l'etichetta dell'oggetto destinatario; l'etichetta dell'oggetto può essere modificata dall'utente in qualsiasi momento.
* {{Value|Position}}: visualizza le coordinate del punto base dell'oggetto target o del vertice target.
* {{Emphasis|Position:}} visualizza le coordinate del punto base dell'oggetto, del vertice o del centro di massa del sottoelemento destinatari, se applicabile.
* {{Value|Length}}: visualizza la lunghezza dell'oggetto o del sottoelemento di destinazione.
* {{Emphasis|Length:}} mostra la lunghezza del sottoelemento di destinazione, se possibile.
* {{Value|Area}}: visualizza l'area dell'oggetto o sottoelemento di destinazione.
* {{Value|Volume}}: visualizza il volume dell'oggetto target.
* {{Emphasis|Area:}} mostra l'area del sottoelemento di destinazione, se possibile.
* {{Value|Tag}}: visualizza l'attributo {{incode|Tag}} dell'oggetto target. Gli oggetti creati con [[Arch_Workbench|Arch Workbench]] possono avere questo attributo.
* {{Emphasis|Volume:}} mostra il volume dell'oggetto di destinazione, se possibile.
* {{Value|Material}}: visualizza l'etichetta del materiale dell'oggetto target.
* {{Emphasis|Tag:}} mostra l'attributo {{incode|Tag}} dell'oggetto di destinazione, se l'oggetto di destinazione ha tale proprietà, come nel caso di tutti gli oggetti[[Arch Workbench/it|Arch]].
* {{Value|Label + Position}}
* {{Emphasis|Material:}} mostra l'etichetta del materiale dell'oggetto di destinazione, se l'oggetto di destinazione ha tale proprietà.
* {{Value|Label + Length}}
</div>
* {{Value|Label + Area}}
* {{Value|Label + Volume}}
* {{Value|Label + Material}}


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


* La direzione del secondo segmento della direttrice determina l'allineamento del testo. Se il segmento è orizzontale e punta a destra il testo è allineato a sinistra e viceversa. Se il secondo segmento va verticalmente verso l'alto, il testo è allineato a sinistra. Se va verticalmente verso il basso, il testo è allineato a destra.
<div class="mw-translate-fuzzy">
* Le Etichette create o salvate con [[Release_notes_0.21/it|FreeCAD versione 0.21]] non sono compatibili con le versioni precedenti.
{{emphasis|Nota:}} la direzione del segmento retto orizzontale, a destra o a sinistra, allinea automaticamente il testo nella direzione opposta. Se la linea guida sale verticalmente, il testo è allineato a sinistra; se scende verticalmente, è allineato a destra.
</div>


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


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


A Draft Label object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. The following properties are additional unless otherwise stated:
Un oggetto Draft Etichetta 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>
=== Data ===
=== Dati ===


{{TitleProperty|Label}}
{{TitleProperty|Label}}


* {{PropertyData|Custom Text|StringList}}: specifica il contenuto del testo se {{PropertyData|Label Type}} è {{Value|Custom}}. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.
<div class="mw-translate-fuzzy">
* {{PropertyData|Label Type|Enumeration}}: specifica il tipo di informazioni visualizzate dall'etichetta. Vedi [[#Tipi di etichette|Tipi di etichette]].
=== Dati ===
* {{PropertyData|Placement|Placement}}: specifica la posizione del testo nella [[3D view/it|Vista 3D]] e, a meno che {{PropertyData|Straight Direction}} sia {{Value|Custom}}, anche di il primo segmento della direttrice, che è il segmento in cui è allegato il testo. Vedere [[Placement/it|Posizionamento]].
* {{PropertyData|Label Type}}: specifica il tipo di informazioni mostrate da questa etichetta (vedere sotto).
* {{PropertyData|Custom Text}}: specifica il blocco di testo da visualizzare quando {{PropertyData|Label Type}} è impostato su "Custom", o l'etichetta non è parametrica. Il testo è dato come una lista di stringhe; ogni elemento dell'elenco, separato da una virgola, indica una nuova riga di testo.
* {{PropertyData|Text|StringList}}: (read-only) specifica il contenuto del testo che viene effettivamente visualizzato. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.
* {{PropertyData|Text}}: (sola lettura) indica il testo effettivo visualizzato dall'etichetta, secondo {{PropertyData|Label Type}}.
* {{PropertyData|Target Point}}: specifica la posizione della punta della linea guida.
* {{PropertyData|Straight Direction}}: specifica la direzione del segmento retto della linea guida, orizzontale o verticale.
* {{PropertyData|Straight Distance}}: specifica la lunghezza del segmento retto della linea guida, partendo dal punto base del testo. Se la distanza è positiva, la linea guida inizia dal lato destro del testo e il testo si allinea a destra; altrimenti, la linea guida inizia dal lato sinistro del testo e il testo si allinea a sinistra.
* {{PropertyData|Position}}: specifica il punto base della prima riga del blocco di testo; influenza anche come viene disegnata la linea guida.
* {{PropertyData|Angle}}: specifica la rotazione della linea di base della prima riga del blocco di testo; influenza anche come viene disegnata la linea guida, poiché non è più orizzontale o verticale.
* {{PropertyData|Axis}}: specifica l'asse da utilizzare per la rotazione.
</div>


{{TitleProperty|Leader}}
{{TitleProperty|Leader}}


* {{PropertyData|Points|VectorList}}: specifies the points of the leader.
* {{PropertyData|Points|VectorList}}: specifica i punti della direttrice.
* {{PropertyData|Straight Direction|Enumeration}}: specifies the direction of the first leader segment: {{Value|Custom}}, {{Value|Horizontal}} or {{Value|Vertical}}.
* {{PropertyData|Straight Direction|Enumeration}}: specifica la direzione del primo segmento della direttrice: {{Value|Custom}}, {{Value|Horizontal}} o {{Value|Vertical}}.
* {{PropertyData|Straight Distance|Distance}}: specifies the length of the first leader segment. Only used if {{PropertyData|Straight Direction}} is {{Value|Horizontal}} or {{Value|Vertical}}. If the distance is positive, the leader starts from the right side of the text and the text aligns to the right. Otherwise the leader starts from the left side of the text and the text aligns to the left.
* {{PropertyData|Straight Distance|Distance}}: specifica la lunghezza del primo segmento della direttrice. Utilizzato solo se {{PropertyData|Straight Direction}} è {{Value|Horizontal}} o {{Value|Vertical}}. Se la distanza è positiva, la direttrice inizia dal lato destro del testo e il testo si allinea a destra. Altrimenti la direttrice inizia dal lato sinistro del testo e il testo si allinea a sinistra.


{{TitleProperty|Target}}
{{TitleProperty|Target}}


* {{PropertyData|Target|LinkSub}}: specifies the object and optional subelement the label is linked to.
* {{PropertyData|Target|LinkSub}}: specifica l'oggetto e il sottoelemento facoltativo a cui è collegata l'etichetta.
* {{PropertyData|Target Point|Vector}}: specifies the position of the tip of the leader, which is where the arrow is attached.
* {{PropertyData|Target Point|Vector}}: specifica la posizione della punta della direttrice, ovvero dove è attaccata la freccia.


<span id="View"></span>
=== View ===
=== Vista ===


{{TitleProperty|Annotation}}
{{TitleProperty|Annotation}}


* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the label. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]].
* {{PropertyView|Annotation Style|Enumeration}}: specifica lo stile di annotazione applicato all'etichetta. Vedere [[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]].
* {{PropertyView|Scale Multiplier|Float}}: specifies the general scaling factor applied to the label.
* {{PropertyView|Scale Multiplier|Float}}: specifica il fattore di scala generale applicato all'etichetta.


{{TitleProperty|Display Options}}
{{TitleProperty|Display Options}}


* {{PropertyView|Display Mode|Enumeration}}: specifies how the text is displayed. If it is {{value|3D text}} the text will be displayed in a plane defined by the {{PropertyData|Placement}} of the label. If it is {{value|2D text}} the text will always face the camera. This is an inherited property.
* {{PropertyView|Display Mode|Enumeration}}: specifica come viene visualizzato il testo. Se è {{value|World}} il testo verrà visualizzato su un piano definito dal {{PropertyData|Placement}} dell'etichetta. 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}}
{{TitleProperty|Graphics}}


* {{PropertyView|Arrow Size|Length}}: specifica la dimensione del simbolo visualizzato sulla punta della direttrice.
<div class="mw-translate-fuzzy">
* {{PropertyView|Arrow Type|Enumeration}}: specifica il tipo di simbolo visualizzato sulla punta della direttrice, che può essere {{value|Dot}}, {{value|Circle}}, {{value|Arrow}}, {{value|Tick}} o {{value|Tick-2}}.
=== Vista ===
* {{PropertyView|Frame|Enumeration}}: specifica quale tipo di cornice viene disegnata attorno al testo. Le opzioni correnti sono {{value|None}} o {{value|Rectangle}}.
* {{PropertyView|Text Font}}: 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|Text 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|Line|Bool}}: specifica se visualizzare la linea guida. Se è {{FALSE}} vengono visualizzati solo la freccia e il testo.
* {{PropertyView|Text Alignment}}: specifica l'allineamento verticale della linea di base del testo rispetto alla linea guida. Può essere in alto, in mezzo o in basso.
* {{PropertyView|Line Color|Color}}: specifica il colore della direttrice e della freccia. Viene utilizzato anche per la cornice ({{Version/it|0.20}}).
* {{PropertyView|Text Color}}: specifica il colore del testo in una tupla RGB (R, G, B).
* {{PropertyView|Line Width|Float}}: specifica la larghezza della direttrice. Viene utilizzato anche per la cornice ({{Version/it|0.20}}).
* {{PropertyView|Line Width}}: specifica la larghezza della linea guida.
* {{PropertyView|Line Color}}: specifica il colore della linea guida.
* {{PropertyView|Arrow Size}}: specifica la dimensione del simbolo visualizzato alla fine della linea guida.
* {{PropertyView|Arrow Type}}: specifica il tipo di simbolo visualizzato alla fine della linea guida, che può essere dot, circle, arrow, o tick.
* {{PropertyView|Frame}}: se è "Rectangle" disegna una cornice attorno al testo.
* {{PropertyView|Line}}: se è {{TRUE}} visualizza la linea guida; altrimenti visualizza solo il testo e il simbolo finale.
* {{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.
</div>


{{TitleProperty|Text}}
{{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. {{Version/it|0.21}}
* {{PropertyView|Justification|Enumeration}}: specifies the horizontal alignment of the text: {{value|Left}}, {{value|Center}} or {{value|Right}}. Only used if {{PropertyData|Straight Direction}} is {{Value|Custom}}. Otherwise the horizontal alignment is based on the sign (positive or negative) of {{PropertyData|Straight Distance}}.
* {{PropertyView|Font Size|Length}}: specifica la dimensione del carattere. Il testo può essere invisibile nella [[3D_view/it|Vista 3D]] se questo valore è molto piccolo. {{Version/it|0.21}}
* {{PropertyView|Line Spacing|Float}}: specifies the factor applied to the default line height of the text.
* {{PropertyView|Justification|Enumeration}}: specifica l'allineamento orizzontale del testo: {{value|Left}}, {{value|Center}} o {{value|Right}}. Utilizzato solo se {{PropertyData|Straight Direction}} è {{Value|Custom}}. Altrimenti l'allineamento orizzontale si basa sul segno (positivo o negativo) di {{PropertyData|Straight Distance}}.
* {{PropertyView|Max Chars|Integer}}: specifies the maximum number of characters on each line of the text.
* {{PropertyView|Text Alignment|Enumeration}}: specifies the vertical alignment of the text: {{value|Top}}, {{value|Middle}} or {{value|Bottom}}.
* {{PropertyView|Interlinea|Float}}: specifica il fattore applicato all'altezza di riga predefinita del testo.
* {{PropertyView|Text Color|Color}}: specifies the color of the text.
* {{PropertyView|Max Chars|Integer}}: specifica il numero massimo di caratteri su ogni riga del testo.
* {{PropertyView|Text Alignment|Enumeration}}: specifica l'allineamento verticale del testo: {{value|Top}}, {{value|Middle}} o {{value|Bottom}}.
* {{PropertyView|Text Font|Font}}: specifies the font used to draw the text. It can be a font name, such as {{value|Arial}}, a default style such as {{value|sans}}, {{value|serif}} or {{value|mono}}, a family such as {{value|Arial,Helvetica,sans}}, or a name with a style such as {{value|Arial:Bold}}. If the given font is not found on the system, a default font is used instead.
* {{PropertyView|Text Color|Color}}: specifica il colore del testo.
* {{PropertyView|Font Size|Length}}: specifies the size of the letters. The text can be invisible in the [[3D_view|3D view]] if this value is very small.


==Scripting==
<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]].
<div class="mw-translate-fuzzy">
== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
</div>


Per creare un'Etichetta Draft usare il metodo {{incode|make_label}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makeLabel}}.
<div class="mw-translate-fuzzy">
Lo strumento Etichetta può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:
</div>


{{Code|code=
{{Code|code=
Line 194: Line 175:


label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.TextSize = 200
label1.ViewObject.FontSize= 200


p2 = App.Vector(-200, 0, 0)
p2 = App.Vector(-200, 0, 0)
Line 201: Line 182:
label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
custom_text="Beware of the sharp edges")
custom_text="Beware of the sharp edges")
label2.ViewObject.TextSize = 200
label2.ViewObject.FontSize= 200


p3 = App.Vector(1000, 1200, 0)
p3 = App.Vector(1000, 1200, 0)
Line 207: Line 188:


label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.TextSize = 200
label3.ViewObject.FontSize= 200


doc.recompute()
doc.recompute()
Line 213: Line 194:




<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it
|[[Draft_Dimension/it|Quotatura]]
|[[Draft CubicBezCurve/it|Curva di Bézier cubica]]
|[[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]]
|[[Draft_Move/it|Sposta]]
|[[Draft_Workbench/it|Draft]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft CubicBezCurve.svg
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Move.svg
}}
}}
</div>


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

Latest revision as of 17:14, 7 April 2024

Etichetta

Posizione nel menu
Annotazione → Etichetta
Ambiente
Draft, Arch
Avvio veloce
D L
Introdotto nella versione
0.17
Vedere anche
Testo, Forma da testo

Descrizione

Il comando Etichetta crea un testo su più righe con una linea guida a 2 segmenti e una freccia.

Se un oggetto o un sottoelemento (faccia, bordo o vertice) viene selezionato all'avvio del comando, il testo può visualizzare uno o due attributi dell'elemento selezionato, tra cui posizione, lunghezza, area, volume e materiale. Il testo sarà quindi collegato a detti attributi e si aggiornerà se i loro valori cambiano.

Per inserire un elemento di testo senza una freccia usare invece il comando Testo.

Varie etichette con diversi orientamenti, frecce ed informazioni

Utilizzo

Vedere anche: Barra di Draft, Aggancio e Vincolare.

  1. Facoltativamente selezionare un oggetto o un sottoelemento (vertice, bordo o faccia) di cui si desidera visualizzare gli attributi.
  2. Esistono diversi modi per invocare il comando:
    • Premere il pulsante Etichetta.
    • Selezionare l'opzione Annotazione → Etichetta dal menu.
    • Usare la scorciatoia da tastiera: D poi L.
  3. Si apre il pannello attività Etichetta. Vedere Opzioni per maggiori informazioni.
  4. Se si ha selezionato un elemento: selezionare un'opzione dall'elenco a discesa Tipo di etichetta. Vedere Tipi di etichette di seguito.
  5. Scegliere il primo punto nella Vista 3D, oppure digitare le coordinate e premere il pulsante Inserisci punto. Questo punto indica il bersaglio (punta della freccia). Questo può essere ovunque, non deve essere su un elemento.
  6. Scegliere il secondo punto nella Vista 3D, oppure digitare le coordinate e premere il pulsante Inserisci punto. Questo punto indica l'inizio del segmento orizzontale o verticale della direttrice.
  7. Scegliere il terzo punto nella Vista 3D, oppure digitare le coordinate e premere il pulsante Inserisci punto. Questo punto indica il punto base del testo.

Opzioni

Le scorciatoie da tastiera a carattere singolo disponibili nel pannello delle attività possono essere modificate. Vedere Preferenze per l'ambiente Draft. Le scorciatoie menzionate qui sono le scorciatoie predefinite.

  • 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 si hanno i valori desiderati. Si consiglia di spostare il puntatore fuori dalla Vista 3D prima di inserire le coordinate.
  • Premere R o fare clic sulla casella di controllo Relativo per attivare o disattivare la modalità relativa. Se la modalità relativa è attiva, le coordinate sono relative all'ultimo punto, se disponibile, altrimenti sono relative all'origine del sistema di 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 S per attivare o disattivare Aggancia.
  • Premere Esc o il pulsante Chiudi per interrompere il comando.

Tipi di etichette

Sono disponibili i seguenti tipi di etichette:

  • Custom: visualizza il contenuto di DatiCustom Text.
  • Name: visualizza il nome interno dell'oggetto target. Il nome interno viene assegnato quando viene creato un oggetto e rimane fisso per tutta l'esistenza dell'oggetto.
  • Label: visualizza l'etichetta dell'oggetto target. L'etichetta di un oggetto può essere modificata dall'utente.
  • Position: visualizza le coordinate del punto base dell'oggetto target o del vertice target.
  • Length: visualizza la lunghezza dell'oggetto o del sottoelemento di destinazione.
  • Area: visualizza l'area dell'oggetto o sottoelemento di destinazione.
  • Volume: visualizza il volume dell'oggetto target.
  • Tag: visualizza l'attributo Tag dell'oggetto target. Gli oggetti creati con Arch Workbench possono avere questo attributo.
  • Material: visualizza l'etichetta del materiale dell'oggetto target.
  • Label + Position
  • Label + Length
  • Label + Area
  • Label + Volume
  • Label + Material

Note

  • La direzione del secondo segmento della direttrice determina l'allineamento del testo. Se il segmento è orizzontale e punta a destra il testo è allineato a sinistra e viceversa. Se il secondo segmento va verticalmente verso l'alto, il testo è allineato a sinistra. Se va verticalmente verso il basso, il testo è allineato a destra.
  • Le Etichette create o salvate con FreeCAD versione 0.21 non sono compatibili con le versioni precedenti.

Proprietà

Vedere anche: Editor delle proprietà.

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

Dati

Label

  • DatiCustom Text (StringList): specifica il contenuto del testo se DatiLabel Type è Custom. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.
  • DatiLabel Type (Enumeration): specifica il tipo di informazioni visualizzate dall'etichetta. Vedi Tipi di etichette.
  • DatiPlacement (Placement): specifica la posizione del testo nella Vista 3D e, a meno che DatiStraight Direction sia Custom, anche di il primo segmento della direttrice, che è il segmento in cui è allegato il testo. Vedere Posizionamento.
  • DatiText (StringList): (read-only) specifica il contenuto del testo che viene effettivamente visualizzato. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.

Leader

  • DatiPoints (VectorList): specifica i punti della direttrice.
  • DatiStraight Direction (Enumeration): specifica la direzione del primo segmento della direttrice: Custom, Horizontal o Vertical.
  • DatiStraight Distance (Distance): specifica la lunghezza del primo segmento della direttrice. Utilizzato solo se DatiStraight Direction è Horizontal o Vertical. Se la distanza è positiva, la direttrice inizia dal lato destro del testo e il testo si allinea a destra. Altrimenti la direttrice inizia dal lato sinistro del testo e il testo si allinea a sinistra.

Target

  • DatiTarget (LinkSub): specifica l'oggetto e il sottoelemento facoltativo a cui è collegata l'etichetta.
  • DatiTarget Point (Vector): specifica la posizione della punta della direttrice, ovvero dove è attaccata la freccia.

Vista

Annotation

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

Display Options

  • VistaDisplay Mode (Enumeration): specifica come viene visualizzato il testo. Se è World il testo verrà visualizzato su un piano definito dal DatiPlacement dell'etichetta. 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

  • VistaArrow Size (Length): specifica la dimensione del simbolo visualizzato sulla punta della direttrice.
  • VistaArrow Type (Enumeration): specifica il tipo di simbolo visualizzato sulla punta della direttrice, che può essere Dot, Circle, Arrow, Tick o Tick-2.
  • VistaFrame (Enumeration): specifica quale tipo di cornice viene disegnata attorno al testo. Le opzioni correnti sono None o Rectangle.
  • VistaLine (Bool): specifica se visualizzare la linea guida. Se è false vengono visualizzati solo la freccia e il testo.
  • VistaLine Color (Color): specifica il colore della direttrice e della freccia. Viene utilizzato anche per la cornice (disponibile dalla versione 0.20).
  • VistaLine Width (Float): specifica la larghezza della direttrice. Viene utilizzato anche per la cornice (disponibile dalla versione 0.20).

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. disponibile dalla versione 0.21
  • VistaFont Size (Length): specifica la dimensione del carattere. Il testo può essere invisibile nella Vista 3D se questo valore è molto piccolo. disponibile dalla versione 0.21
  • VistaJustification (Enumeration): specifica l'allineamento orizzontale del testo: Left, Center o Right. Utilizzato solo se DatiStraight Direction è Custom. Altrimenti l'allineamento orizzontale si basa sul segno (positivo o negativo) di DatiStraight Distance.
  • VistaInterlinea (Float): specifica il fattore applicato all'altezza di riga predefinita del testo.
  • VistaMax Chars (Integer): specifica il numero massimo di caratteri su ogni riga del testo.
  • VistaText Alignment (Enumeration): specifica l'allineamento verticale del testo: Top, Middle o Bottom.
  • VistaText Color (Color): specifica il colore del testo.

Script

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

Per creare un'Etichetta Draft usare il metodo make_label (disponibile dalla versione 0.19) del modulo Draft. Questo metodo sostituisce il metodo deprecato makeLabel.

label = make_label(target_point=App.Vector(0, 0, 0),
                   placement=App.Vector(30, 30, 0),
                   target_object=None, subelements=None,
                   label_type="Custom", custom_text="Label",
                   direction="Horizontal", distance=-10,
                   points=None)

Esempio:

import FreeCAD as App
import Draft

doc = App.newDocument()

rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()

p1 = App.Vector(-200, 1000, 0)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())

label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.FontSize= 200

p2 = App.Vector(-200, 0, 0)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())

label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
                          custom_text="Beware of the sharp edges")
label2.ViewObject.FontSize= 200

p3 = App.Vector(1000, 1200, 0)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())

label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.FontSize= 200

doc.recompute()