Draft AnnotationStyleEditor/it: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Docnav/it |Etichetta |Muovi |Draft |IconL=Draft_Label.svg |IconR=Draft_Move.svg |IconC=Workbench_Draft.svg }}")
No edit summary
 
(24 intermediate revisions by 2 users not shown)
Line 3: Line 3:
{{Docnav/it
{{Docnav/it
|[[Draft_Label/it|Etichetta]]
|[[Draft_Label/it|Etichetta]]
|[[Draft_Move/it|Muovi]]
|[[Draft_Move/it|Sposta]]
|[[Draft_Workbench/it|Draft]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Label.svg
|IconL=Draft_Label.svg
Line 10: Line 10:
}}
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/it
{{GuiCommand/it
|Name=Draft AnnotationStyleEditor
|Name=Draft AnnotationStyleEditor
|Name/it=Draft AnnotationStyleEditor
|Name/it=Stile delle annotazioni
|MenuLocation=Annotazioni → Stile delle annotazioni...
|MenuLocation=Annotazioni → Stile delle annotazioni...
|Workbenches=[[Draft_Workbench/it|Draft]]
|Workbenches=[[Draft_Workbench/it|Draft]]
|SeeAlso=[[Draft_Text/it|Testo]], [[Draft_Label/it|Etichetta]], [[Draft_Dimension/it|Quotatura]]
|Shortcut=
|SeeAlso=[[Draft_Text/it|Testo]], [[Draft_Dimension/it|Quota]], [[Draft_Label/it|Etichetta]]
|Version=0.19
|Version=0.19
}}
}}
</div>


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


Il comando [[Image:Draft_AnnotationStyleEditor.svg|24px]] '''Stile delle annotazioni''' consente di definire gli stili che influenzano le proprietà visive di oggetti simili ad annotazioni, come quelli creati con i comandi [[Draft_Text/it|Testo]], [[Draft_Dimension/it|Quotatura]] ed [[Draft_Label/it|Etichetta]].
<div class="mw-translate-fuzzy">
Lo strumento [[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]] permette di definire stili che influenzano le proprietà visive di oggetti simili ad annotazioni, come quelli creati da [[File:Draft_Text.svg|16px]] [[Draft_Text/it|Testo]], [[File:Draft_Dimension.svg|16px]] [[Draft_Dimension/it|Quota]], e [[File:Draft_Label.svg|16px]] [[Draft Label/it|Etichetta]].
</div>

{{Version|1.0}}: Several bugs have been fixed and a separate Text color button has been added.


[[File:Draft_AnnotationStyleEditor_Dialog.png]]
[[File:Draft_AnnotationStyleEditor_Dialog.png]]
{{Caption|La finestra di dialogo Editor Stile delle Annotazioni}}
<div class="mw-translate-fuzzy">
[[File:Draft_AnnotationStyleEditor_example.png|400px]]
{{Caption|Editor di stile per configurare le annotazioni.}}
</div>


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


# Esistono diversi modi per invocare il comando:
<div class="mw-translate-fuzzy">
# Premere il pusante {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor/it|Stile delle annotazioni]]}}.
#* Premere il pulsante {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor/it|Stili di annotazione...]]}}.
#* Selezionare l'opzione {{MenuCommand|Annotazione → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Stili di annotazione...}} dal menu.
# Aprire la casella combinata, quindi scegliere {{Button|Aggiungi nuovo...}} per definire un nuovo stile o selezionare uno degli stili esistenti.
# Si apre la finestra di dialogo {{MenuCommand|Editor degli stili di annotazione}}.
# Regolare le proprietà dello stile, quindi premere {{Button|OK}}.
# Selezionare uno stile dall'elenco a discesa {{MenuCommand|Nome stile}} o scegliere {{Value|Aggiungi nuovo...}} per definire un nuovo stile.
</div>
# Regolare facoltativamente le proprietà dello stile.
# Facoltativamente, premere il pulsante {{Button|[[File:Accessories-text-editor.svg|16px]] Rinomina}} per rinominare lo stile.
# Facoltativamente, premere il pulsante {{Button|[[File:Edit_Cancel.svg|16px]] Elimina}} per eliminare lo stile.
# Facoltativamente, premere il pulsante {{Button|[[File:Std_Import.svg|16px]]}} per importare tutti gli stili da un file {{FileName|.json}}. Questo sovrascriverà gli stili esistenti con lo stesso nome.
# Facoltativamente, premere il pulsante {{Button|[[File:Std_Export.svg|16px]]}} per esportare tutti gli stili in un file {{FileName|.json}}.
# Premere il pulsante {{Button|OK}} per chiudere la finestra di dialogo e terminare il comando.


<span id="Scripting"></span>
<span id="Scripting"></span>
==Script==
==Script==


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].

{{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 {{incode|Meta}} del documento. Questo attributo viene ispezionato dall'editor dello stile di annotazione quando viene aperto.
Gli stili di annotazione vengono salvati come dizionari serializzati nell'attributo {{incode|Meta}} del documento. Questo attributo viene ispezionato dall'editor dello stile di annotazione quando viene aperto.
Line 57: Line 51:
{{Code|code=
{{Code|code=
>>> print(App.ActiveDocument.Meta["Draft_Style_Text red"])
>>> 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}
{"ArrowSize": 2.0, "ArrowType": 0, "Decimals": 2, "DimOvershoot": 4.0, "ExtLines": 0.0, "ExtOvershoot": 4.0, "FontName": "DejaVu Sans", "FontSize": 10.0, "LineColor": 255, "LineSpacing": 1.0, "LineWidth": 2, "ScaleMultiplier": 1.0, "ShowLine": true, "ShowUnit": false, "TextColor": 4278190335, "TextSpacing": 3.0, "UnitOverride": ""}
}}
}}


Line 68: Line 62:


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


Le proprietà non inserite verranno compilate automaticamente quando questo stile viene selezionato nell'editor di stile e viene premuto il pulsante {{Button|OK}}.
<div class="mw-translate-fuzzy">
I valori non inseriti verranno riempiti automaticamente quando si seleziona questo stile nell'editor di stile.
</div>


Allo stesso modo, qualsiasi dizionario serializzato può essere decompresso per essere editato.
Allo stesso modo, qualsiasi dizionario serializzato può essere decompresso per essere editato.
Line 86: Line 78:
}}
}}


Le proprietà devono avere i seguenti tipi:
The properties must have the following types:


Stringhe:
Stringhe:
Line 97: Line 89:
}}
}}


Numeri decimali (devono essere forniti con un punto decimale):
Floats (must be supplied with a decimal point):


{{Code|code=
{{Code|code=
props = {
props = {
"ArrowSize": 2.0,
"DimOvershoot": 4.0,
"ExtLines": 0.0,
"ExtOvershoot": 4.0
"FontSize": 10.0,
"FontSize": 10.0,
"LineSpacing": 1.0,
"LineSpacing": 1.0,
"ScaleMultiplier": 1.0,
"ScaleMultiplier": 1.0,
"ArrowSize": 2.0,
"TextSpacing": 3.0
"DimOvershoot": 0.0,
"ExtLines": 0.0,
"ExtOvershoot": 4.0
}
}
}}
}}


Numeri interi:
Integers:


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


{{Incode|TextColor}} e {{Incode|LineColor}} corrispondono a un numero intero a 32 bit, da cui è possibile estrarre i singoli valori RGBA. {{Incode|ArrowType}} è un enumeratore.
<div class="mw-translate-fuzzy">
Il colore della linea corrisponde all'intero a 32 bit, dal quale è possibile estrarre i singoli valori RGBA.
</div>


<div class="mw-translate-fuzzy">
Booleane:
Booleane:
</div>


{{Code|code=
{{Code|code=
props = {
props = {
"ShowUnit": false,
"ShowLine": true
"ShowLine": true
"ShowUnit": false,
}
}
}}
}}
Line 141: Line 130:
{{Docnav/it
{{Docnav/it
|[[Draft_Label/it|Etichetta]]
|[[Draft_Label/it|Etichetta]]
|[[Draft_Move/it|Muovi]]
|[[Draft_Move/it|Sposta]]
|[[Draft_Workbench/it|Draft]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Label.svg
|IconL=Draft_Label.svg

Latest revision as of 15:36, 8 December 2023

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

Il comando Stile delle annotazioni consente di definire gli stili che influenzano le proprietà visive di oggetti simili ad annotazioni, come quelli creati con i comandi Testo, Quotatura ed Etichetta.

La finestra di dialogo Editor Stile delle Annotazioni

Utilizzo

  1. Esistono diversi modi per invocare il comando:
    • Premere il pulsante Stili di annotazione....
    • Selezionare l'opzione Annotazione → Stili di annotazione... dal menu.
  2. Si apre la finestra di dialogo Editor degli stili di annotazione.
  3. Selezionare uno stile dall'elenco a discesa Nome stile o scegliere Aggiungi nuovo... per definire un nuovo stile.
  4. Regolare facoltativamente le proprietà dello stile.
  5. Facoltativamente, premere il pulsante Rinomina per rinominare lo stile.
  6. Facoltativamente, premere il pulsante Elimina per eliminare lo stile.
  7. Facoltativamente, premere il pulsante per importare tutti gli stili da un file .json. Questo sovrascriverà gli stili esistenti con lo stesso nome.
  8. Facoltativamente, premere il pulsante per esportare tutti gli stili in un file .json.
  9. Premere il pulsante OK per chiudere la finestra di dialogo e terminare il comando.

Script

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

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"])
{"ArrowSize": 2.0, "ArrowType": 0, "Decimals": 2, "DimOvershoot": 4.0, "ExtLines": 0.0, "ExtOvershoot": 4.0, "FontName": "DejaVu Sans", "FontSize": 10.0, "LineColor": 255, "LineSpacing": 1.0, "LineWidth": 2, "ScaleMultiplier": 1.0, "ShowLine": true, "ShowUnit": false, "TextColor": 4278190335, "TextSpacing": 3.0, "UnitOverride": ""}

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 = {"ArrowSize": 7.0, "LineWidth": 6}
meta["Draft_Style_Thick_lines"] = json.dumps(props)
App.ActiveDocument.Meta = meta

Le proprietà non inserite verranno compilate automaticamente quando questo stile viene selezionato nell'editor di stile e viene premuto il pulsante OK.

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"])

Le proprietà devono avere i seguenti tipi:

Stringhe:

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

Numeri decimali (devono essere forniti con un punto decimale):

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

Numeri interi:

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

TextColor e LineColor corrispondono a un numero intero a 32 bit, da cui è possibile estrarre i singoli valori RGBA. ArrowType è un enumeratore.

Booleane:

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