Draft AnnotationStyleEditor/it: Difference between revisions

From FreeCAD Documentation
(Created page with "==Script==")
No edit summary
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/it
|[[Draft_Label/it|Etichetta]]
|[[Draft_Move/it|Sposta]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Label.svg
|IconR=Draft_Move.svg
|IconC=Workbench_Draft.svg
}}

{{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 Module/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
}}
}}


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


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


[[File:Draft_AnnotationStyleEditor_example.png|400px]]
[[File:Draft_AnnotationStyleEditor_Dialog.png]]
{{Caption|Editor di stile per configurare le annotazioni.}}
{{Caption|La finestra di dialogo Editor Stile delle Annotazioni}}


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


# Esistono diversi modi per invocare il comando:
# 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...]]}}.
# Aprire la casella combinata, quindi scegliere {{Button|Aggiungi nuovo...}} per definire un nuovo stile o selezionare uno degli stili esistenti.
#* Selezionare l'opzione {{MenuCommand|Annotazione → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Stili di annotazione...}} dal menu.
# Regolare le proprietà dello stile, quindi premere {{Button|OK}}.
# Si apre la finestra di dialogo {{MenuCommand|Editor degli stili di annotazione}}.

# Selezionare uno stile dall'elenco a discesa {{MenuCommand|Nome stile}} o scegliere {{Value|Aggiungi nuovo...}} per definire un nuovo stile.
Usare {{Button|[[File:Accessories-text-editor.svg|16px]] Rnomina}} o {{Button|[[File:Edit_Cancel.svg|16px]] Elimina}} per rinominare o eliminare lo stile attivo.
# 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>
==Script==
==Script==


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
The annotation styles are saved as serialized dictionaries in the {{incode|Meta}} attribute of the document. This attribute is inspected by the annotation style editor when it is opened.

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.


{{Code|code=
{{Code|code=
>>> print(App.ActiveDocument.Meta["Draft_Style_Lane 1:100"])
>>> print(App.ActiveDocument.Meta["Draft_Style_Text red"])
{"FontName": "DejaVu Sans", "FontSize": "8.0000 ", "LineSpacing": "1 cm", "ScaleMultiplier": 1.0, "ShowUnit": false, "UnitOverride": "", "Decimals": 2, "ShowLines": true, "LineWidth": 2, "LineColor": 1095216660480, "ArrowType": 0, "ArrowSize": "5.0000 ", "DimensionOvershoot": "1.0000 ", "ExtensionLines": "5.0000 ", "ExtensionOvershoot": "1.0000 "}
{"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": ""}
}}
}}


Each style that appears in the editor is internally saved with the style name prefixed by {{incode|Draft_Style_}}; this will prevent name clashes with other keys that may be saved in {{incode|Meta}}, which can hold arbitrary information.
Ogni stile che appare nell'editor viene salvato internamente con il nome dello stile preceduto da {{incode|Draft_Style_}}; questo evita i conflitti di nomi con altre chiavi che possono essere salvate in {{incode|Meta}}, che può contenere informazioni arbitrarie.

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


You may define any new style by adding the necessary information to a key that starts with {{incode|Draft_Style_}}. The corresponding value of this key must be a dictionary serialized using {{incode|json}}.
{{Code|code=
{{Code|code=
import json
import json


meta = App.ActiveDocument.Meta
meta = App.ActiveDocument.Meta
props = {"LineWidth": 6, "ArrowSize": "7"}
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
}}
}}
The values not entered will be filled automatically when this style is selected in the style editor.


Le proprietà non inserite verranno compilate automaticamente quando questo stile viene selezionato nell'editor di stile e viene premuto il pulsante {{Button|OK}}.
In a similar way, any serialized dictionary can be unpacked for edition.

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

{{Code|code=
{{Code|code=
import json

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


Le proprietà devono avere i seguenti tipi:
Because the graphical interface widgets check the units of the input values, many of these values must be saved as strings, rather than floating point numbers.

Stringhe:


Strings:
{{Code|code=
{{Code|code=
props = {
props = {
"FontName": "DejaVu Sans",
"FontName": "DejaVu Sans",
"FontSize": "12.0000 ",
"UnitOverride": ""
"LineSpacing": "1 cm",
"UnitOverride": "m",
"ArrowSize": "5.0000 ",
"DimensionOvershoot": "1.0000 ",
"ExtensionLines": "5.0000 ",
"ExtensionOvershoot": "1.0000 "
}
}
}}
}}


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

{{Code|code=
{{Code|code=
props = {
props = {
"ScaleMultiplier": 1.0,
"ArrowSize": 2.0,
"Decimals": 2,
"DimOvershoot": 4.0,
"LineWidth": 1,
"ExtLines": 0.0,
"ExtOvershoot": 4.0
"LineColor": 1095216660480,
"ArrowType": 0
"FontSize": 10.0,
"LineSpacing": 1.0,
"ScaleMultiplier": 1.0,
"TextSpacing": 3.0
}
}
}}
}}
The line color corresponds to the 32-bit integer, from which the individual RGBA values can be extracted.


Numeri interi:
Boolean:

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

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

Booleane:

{{Code|code=
props = {
"ShowLine": true
"ShowUnit": false,
}
}}


{{Docnav/it
|[[Draft_Label/it|Etichetta]]
|[[Draft_Move/it|Sposta]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Label.svg
|IconR=Draft_Move.svg
|IconC=Workbench_Draft.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,
}