Draft: Stile delle annotazioni

From FreeCAD Documentation
Revision as of 23:14, 11 March 2023 by Marco T (talk | contribs)

Stile delle annotazioni

Posizione nel menu
Annotazioni → Stile delle annotazioni...
Ambiente
Draft
Avvio veloce
Nessuno
Introdotto nella versione
0.19
Vedere anche
Testo, Etichetta, Quotatura

Descrizione

Lo strumento Stile delle annotazioni permette di definire stili che influenzano le proprietà visive di oggetti simili ad annotazioni, come quelli creati da Testo, Quota, e Etichetta.

introduced in version 1.0: Several bugs have been fixed and a separate Text color button has been added.

File:Draft AnnotationStyleEditor example.png

Editor di stile per configurare le annotazioni.

Utilizzo

  1. Premere il pusante Stile delle annotazioni.
  2. Aprire la casella combinata, quindi scegliere Aggiungi nuovo... per definire un nuovo stile o selezionare uno degli stili esistenti.
  3. Regolare le proprietà dello stile, quindi premere OK.

Script

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

introduced in version 1.0: The information in this paragraph has been updated and reflects FreeCAD version 1.0.

Gli stili di annotazione vengono salvati come dizionari serializzati nell'attributo Meta del documento. Questo attributo viene ispezionato dall'editor dello stile di annotazione quando viene aperto.

>>> print(App.ActiveDocument.Meta["Draft_Style_Text red"])
{"FontName": "DejaVu Sans", "FontSize": 10.0, "LineSpacing": 1.0, "TextColor": 4278190335, "ScaleMultiplier": 1.0, "ShowUnit": false, "UnitOverride": "", "Decimals": 2, "ShowLine": true, "LineWidth": 2, "ArrowType": 0, "ArrowSize": 2.0, "LineColor": 255, "DimOvershoot": 0.0, "ExtLines": 0.0, "ExtOvershoot": 4.0}

Ogni stile che appare nell'editor viene salvato internamente con il nome dello stile preceduto da Draft_Style_; questo evita i conflitti di nomi con altre chiavi che possono essere salvate in Meta, che può contenere informazioni arbitrarie.

Si può definire qualsiasi nuovo stile aggiungendo le informazioni necessarie a una chiave che inizia con Draft_Style_. Il valore corrispondente di questa chiave deve essere un dizionario serializzato usando json.

import json

meta = App.ActiveDocument.Meta
props = {"LineWidth": 6, "ArrowSize": 7.0}
meta["Draft_Style_Thick_lines"] = json.dumps(props)
App.ActiveDocument.Meta = meta

I valori non inseriti verranno riempiti automaticamente quando si seleziona questo stile nell'editor di stile.

Allo stesso modo, qualsiasi dizionario serializzato può essere decompresso per essere editato.

import json

meta = App.ActiveDocument.Meta
new_dict = json.loads(meta["Draft_Style_Thick_lines"])

The properties must have the following types:

Stringhe:

props = {
    "FontName": "DejaVu Sans",
    "UnitOverride": ""
}

Floats (must be supplied with a decimal point):

props = {
    "FontSize": 10.0,
    "LineSpacing": 1.0,
    "ScaleMultiplier": 1.0,
    "ArrowSize": 2.0,
    "DimOvershoot": 0.0,
    "ExtLines": 0.0,
    "ExtOvershoot": 4.0
}

Integers:

props = {
    "TextColor": 4278190335,
    "Decimals": 2,
    "LineWidth": 2,
    "ArrowType": 0,
    "LineColor": 255
}

Il colore della linea corrisponde all'intero a 32 bit, dal quale è possibile estrarre i singoli valori RGBA.

Booleane:

props = {
    "ShowUnit": false,
    "ShowLine": true
}