Draftː Etichetta

From FreeCAD Documentation
This page is a translated version of the page Draft Label and the translation is 100% complete.

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