Draft Label/it: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(52 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Draft CubicBezCurve/it|Curva di Bézier cubica]]|[[Draft_Move/it|Sposta]]|[[Draft_Module/it|Draft]]|IconL=Draft CubicBezCurve.svg |IconC=Workbench_Draft.svg|IconR=Draft_Move.svg }}


{{Docnav/it
{{GuiCommand/it|Name=Draft Label|Name/it=Etichetta|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Arch]]|MenuLocation=Draft → Etichetta|Shortcut=D L|SeeAlso=[[Draft Text/it|Testo]], [[Draft ShapeString/it|Forma da testo]]
|[[Draft_Dimension/it|Quotatura]]
|Version=0.17}}
|[[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
}}


{{GuiCommand/it
|Name=Draft Label
|Name/it=Etichetta
|MenuLocation=Annotazione → Etichetta
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut={{KEY|D}} {{KEY|L}}
|Version=0.17
|SeeAlso=[[Draft_Text/it|Testo]], [[Draft_ShapeString/it|Forma da testo]]
}}

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

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 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]].
Per inserire un elemento di testo senza una freccia usare invece il comando [[Draft_Text/it|Testo]].


[[Image:Draft_Label_example.jpg|400px]]
[[Image:Draft_Label_example.jpg|400px]]
{{Caption|Varie etichette con diversi orientamenti, simboli terminali e informazioni}}
{{Caption|Varie etichette con diversi orientamenti, frecce ed informazioni}}


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


Vedere anche: [[Draft_Tray/it|Barra di Draft]], [[Draft_Snap/it|Aggancio]] e [[Draft_Constrain/it|Vincolare]].
# Premere il pulsante {{Button|[[Image:Draft Label.svg|16px]] [[Draft Label/it|Etichetta]]}}, o premere i tasti {{KEY|D}} e poi {{KEY|L}}.
# Selezionare un primo punto nella vista 3D, oppure digitare le sue [[Draft_Coordinates/it|coordinate ]] e poi premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|Aggiungi punto]]}}. Questo punto indica l'obiettivo (punta della freccia) che può essere ovunque, non è necessario che sia un elemento.
# Fare clic su un secondo punto nella vista 3D o digitare una [[Draft_Coordinates/it|coordinata]] e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|aggiungi punto]]}}. Questo punto indica l'inizio di una linea guida orizzontale o verticale.
# Fare clic su un terzo punto nella vista 3D o digitare una [[Draft_Coordinates/it|coordinata]] e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|aggiungi punto]]}}. Questo punto indica il punto base del testo.


# Facoltativamente selezionare un oggetto o un sottoelemento (vertice, bordo o faccia) di cui si desidera visualizzare gli attributi.
{{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.
# Esistono diversi modi per invocare il comando:

#* Premere il pulsante {{Button|[[Image:Draft_Label.svg|16px]] [[Draft_Label/it|Etichetta]]}}.
{{emphasis|Nota 2:}} preselezionando un oggetto, o un sottoelemento (vertice, bordo o faccia), prima di premere il pulsante dello strumento, l'etichetta diventa parametrica, cioè, ricorda a quale oggetto è vincolata, e sarà in grado per visualizzare un particolare attributo di quell'oggetto. Se in seguito gli attributi dell'oggetto cambiano, l'etichetta aggiorna le informazioni visualizzate.
#* Selezionare l'opzione {{MenuCommand|Annotazione → [[Image:Draft_Label.svg|16px]] Etichetta}} dal menu.
#* Usare la scorciatoia da tastiera: {{KEY|D}} poi {{KEY|L}}.
# Si apre il pannello attività {{MenuCommand|Etichetta}}. Vedere [[#Options|Opzioni]] per maggiori informazioni.
# 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.
* 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]])
* 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.
* 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.


* 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.
== Proprietà ==
* 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.
* 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}}
* Premere {{KEY|S}} per attivare o disattivare [[Draft_Snap/it|Aggancia]].
* Premere {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando.

<span id="Label_types"></span>
== Tipi di etichette ==

Sono disponibili i seguenti tipi di etichette:


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
* {{Value|Custom}}: visualizza il contenuto di {{PropertyData|Custom Text}}.
=== Dati ===
* {{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.
* {{PropertyData|Label Type}}: specifica il tipo di informazioni mostrate da questa etichetta (vedere sotto).
* {{Value|Label}}: visualizza l'etichetta dell'oggetto target. L'etichetta di un oggetto può essere modificata dall'utente.
* {{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.
* {{Value|Position}}: visualizza le coordinate del punto base dell'oggetto target, del vertice target o del centro di massa del sottoelemento target, se applicabile.
* {{PropertyData|Text}}: (sola lettura) indica il testo effettivo visualizzato dall'etichetta, secondo {{PropertyData|Label Type}}.
* {{Value|Length}}: visualizza la lunghezza dell'oggetto o del sottoelemento di destinazione, se applicabile.
* {{PropertyData|Target Point}}: specifica la posizione della punta della linea guida.
* {{Value|Area}}: visualizza l'area dell'oggetto o sottoelemento di destinazione, se applicabile.
* {{PropertyData|Straight Direction}}: specifica la direzione del segmento retto della linea guida, orizzontale o verticale.
* {{Value|Volume}}: visualizza il volume dell'oggetto target, se applicabile.
* {{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.
* {{Value|Tag}}: visualizza l'attributo {{incode|Tag}} dell'oggetto target, se applicabile. Gli oggetti creati con [[Arch_Workbench|Arch Workbench]] possono avere questo attributo.
* {{PropertyData|Position}}: specifica il punto base della prima riga del blocco di testo; influenza anche come viene disegnata la linea guida.
* {{Value|Material}}: visualizza l'etichetta del materiale dell'oggetto target, se applicabile.
* {{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.
* {{Value|Label + Position}}
* {{PropertyData|Axis}}: specifica l'asse da utilizzare per la rotazione.
* {{Value|Label + Length}}
* {{Value|Label + Area}}
* {{Value|Label + Volume}}
* {{Value|Label + Material}}
</div>
</div>


<span id="Notes"></span>
==== Tipi di etichette ====
==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.
* {{Emphasis|Custom:}} visualizza il contenuto di {{PropertyData|Custom Text}}.
* Le Etichette create o salvate con [[Release_notes_0.21/it|FreeCAD versione 0.21]] non sono compatibili con le versioni precedenti.
* {{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.
* {{Emphasis|Label:}} visualizza l'etichetta dell'oggetto destinatario; l'etichetta dell'oggetto può essere modificata dall'utente in qualsiasi momento.
* {{Emphasis|Position:}} visualizza le coordinate del punto base dell'oggetto, del vertice o del centro di massa del sottoelemento destinatari, se applicabile.
* {{Emphasis|Length:}} mostra la lunghezza del sottoelemento di destinazione, se possibile.
* {{Emphasis|Area:}} mostra l'area del sottoelemento di destinazione, se possibile.
* {{Emphasis|Volume:}} mostra il volume dell'oggetto di destinazione, se possibile.
* {{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]].
* {{Emphasis|Material:}} mostra l'etichetta del materiale dell'oggetto di destinazione, se l'oggetto di destinazione ha tale proprietà.


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

Vedere anche: [[Property_editor/it|Editor delle proprietà]].

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

{{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.
* {{PropertyData|Label Type|Enumeration}}: specifica il tipo di informazioni visualizzate dall'etichetta. Vedi [[#Tipi di etichette|Tipi di etichette]].
* {{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|Text|StringList}}: (read-only) specifica il contenuto del testo che viene effettivamente visualizzato. Ciascun elemento nell'elenco rappresenta una nuova riga di testo.

{{TitleProperty|Leader}}

* {{PropertyData|Points|VectorList}}: specifica i punti della direttrice.
* {{PropertyData|Straight Direction|Enumeration}}: specifica la direzione del primo segmento della direttrice: {{Value|Custom}}, {{Value|Horizontal}} o {{Value|Vertical}}.
* {{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}}

* {{PropertyData|Target|LinkSub}}: specifica l'oggetto e il sottoelemento facoltativo a cui è collegata l'etichetta.
* {{PropertyData|Target Point|Vector}}: specifica la posizione della punta della direttrice, ovvero dove è attaccata la freccia.

<span id="View"></span>
=== Vista ===
=== Vista ===
* {{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|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|Text Color}}: specifica il colore del testo in una tupla RGB (R, G, B).
* {{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.


{{TitleProperty|Annotation}}
== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].


* {{PropertyView|Annotation Style|Enumeration}}: specifica lo stile di annotazione applicato all'etichetta. Vedere [[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]].
Lo strumento Etichetta può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:
* {{PropertyView|Scale Multiplier|Float}}: specifica il fattore di scala generale applicato all'etichetta.
{{Code|code=
Label = makeLabel(targetpoint=None, target=None, direction=None, distance=None, labeltype=None, placement=None)
}}


{{TitleProperty|Display Options}}
* Crea un oggetto {{incode|Label}} con la punta rivolta verso il {{incode|targetpoint}}, e il collegamento all'oggetto {{incode|target}} che deve essere un {{incode|DocumentObject}} ({{emphasis|Editor:}} or a SelectionObject? This is unclear).
* {{incode|direction}} può essere "Horizontal", "Vertical", o "Custom".
* {{incode|distance}} è la distanza dal punto base del testo alla linea guida.
* {{incode|labeltype}} può essere "Custom", "Name", "Label", "Position", "Length", "Area", "Volume", "Tag", o "Material".
* Se viene dato un {{incode|placement}} esso è usato per il punto base del testo; altrimenti il testo viene creato all'origine.


* {{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}}).
Modificare il testo personalizzato sovrascrivendo l'attributo {{incode|CustomText}}. È possibile utilizzare un elenco di stringhe; ogni elemento viene visualizzato nella propria riga.


{{TitleProperty|Graphics}}
Le proprietà di visualizzazione di {{incode|Label}} possono essere modificate sovrascrivendo i suoi attributi; ad esempio, sovrascrivere {{incode|ViewObject.TextSize}} con una nuova dimensione in millimetri.

* {{PropertyView|Arrow Size|Length}}: specifica la dimensione del simbolo visualizzato sulla punta della direttrice.
* {{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}}.
* {{PropertyView|Frame|Enumeration}}: specifica quale tipo di cornice viene disegnata attorno al testo. Le opzioni correnti sono {{value|None}} o {{value|Rectangle}}.
* {{PropertyView|Line|Bool}}: specifica se visualizzare la linea guida. Se è {{FALSE}} vengono visualizzati solo la freccia e il testo.
* {{PropertyView|Line Color|Color}}: specifica il colore della direttrice e della freccia. Viene utilizzato anche per la cornice ({{Version/it|0.20}}).
* {{PropertyView|Line Width|Float}}: specifica la larghezza della direttrice. Viene utilizzato anche per la cornice ({{Version/it|0.20}}).

{{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|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|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|Interlinea|Float}}: specifica il fattore applicato all'altezza di riga predefinita del testo.
* {{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 Color|Color}}: specifica il colore del testo.

<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 un'Etichetta Draft usare il metodo {{incode|make_label}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makeLabel}}.

{{Code|code=
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:
Esempio:

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


doc = App.newDocument()
Rectangle = Draft.makeRectangle(4000, 1000)


p1 = FreeCAD.Vector(-200, 1000, 0)
rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()
place1 = FreeCAD.Placement(FreeCAD.Vector(-1000, 1300, 0), FreeCAD.Rotation())


p1 = App.Vector(-200, 1000, 0)
Label1 = Draft.makeLabel(p1, Rectangle, "Horizontal", 500, "Label", place1)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())
Label1.ViewObject.TextSize = 200


label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
p2 = FreeCAD.Vector(-200, 0, 0)
label1.ViewObject.TextSize = 200
place2 = FreeCAD.Placement(FreeCAD.Vector(-1000, -300, 0), FreeCAD.Rotation())


p2 = App.Vector(-200, 0, 0)
Label2 = Draft.makeLabel(p2, Rectangle, "Horizontal", 500, "Custom", place2)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())
Label2.CustomText = ["Beware of the", "sharp edges"]
Label2.ViewObject.TextSize = 200
FreeCAD.ActiveDocument.recompute()


label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
p3 = FreeCAD.Vector(1000, 1200, 0)
custom_text="Beware of the sharp edges")
place3 = FreeCAD.Placement(FreeCAD.Vector(2000, 1800, 0), FreeCAD.Rotation())
label2.ViewObject.TextSize = 200


p3 = App.Vector(1000, 1200, 0)
Label3 = Draft.makeLabel(p3, Rectangle, "Horizontal", -500, "Area", place3)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())
Label3.ViewObject.TextSize = 200

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

doc.recompute()
}}
}}



{{Docnav/it|[[Draft CubicBezCurve/it|Curva di Bézier cubica]]|[[Draft_Move/it|Sposta]]|[[Draft_Module/it|Draft]]|IconL=Draft CubicBezCurve.svg |IconC=Workbench_Draft.svg|IconR=Draft_Move.svg }}
{{Docnav/it
|[[Draft_Dimension/it|Quotatura]]
|[[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconC=Workbench_Draft.svg
}}


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

Latest revision as of 08:45, 28 March 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, del vertice target o del centro di massa del sottoelemento target, se applicabile.
  • Length: visualizza la lunghezza dell'oggetto o del sottoelemento di destinazione, se applicabile.
  • Area: visualizza l'area dell'oggetto o sottoelemento di destinazione, se applicabile.
  • Volume: visualizza il volume dell'oggetto target, se applicabile.
  • Tag: visualizza l'attributo Tag dell'oggetto target, se applicabile. Gli oggetti creati con Arch Workbench possono avere questo attributo.
  • Material: visualizza l'etichetta del materiale dell'oggetto target, se applicabile.
  • 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.TextSize = 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.TextSize = 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.TextSize = 200

doc.recompute()