Draft AnnotationStyleEditor/de: Difference between revisions

From FreeCAD Documentation
(Created page with "{{GuiCommand/de |Name=Draft AnnotationStyleEditor |Name/de=Entwurf AnmerkungsStilEditor |MenuLocation=Anmerkung → Anmerkungsstile |Workbenches=Entwurf |S...")
No edit summary
 
(56 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/de
|[[Draft_Label/de|Etikett]]
|[[Draft_Move/de|Bewegen]]
|[[Draft_Workbench/de|Draft-Arbeitsbereich]]
|IconL=Draft_Label.svg
|IconR=Draft_Move.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/de
{{GuiCommand/de
|Name=Draft AnnotationStyleEditor
|Name=Draft AnnotationStyleEditor
|Name/de=Entwurf AnmerkungsStilEditor
|Name/de=Draft BeschriftungsstilEditor
|MenuLocation=Anmerkung → Anmerkungsstile
|MenuLocation=Anmerkung → Beschriftungsstile...
|Workbenches=[[Draft Module/de|Entwurf]]
|Workbenches=[[Draft_Workbench/de|Draft]]
|SeeAlso=[[Draft_Text/de|Draft Text]], [[Draft_Label/de|Draft Hinweis]], [[Draft_Dimension/de|Draft Maß]]
|Shortcut=-
|SeeAlso=[[Draft_Text/de|Entwurf Text]], [[Draft_Dimension/de|Entwurf Abmessung]], [[Draft_Label/de|Entwurf Beschriftung]]
|Version=0.19
|Version=0.19
}}
}}


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


The {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor|Annotation style editor]]}} tool allows you to define styles that affect the visual properties of annotation-like objects, like those create by {{Button|[[File:Draft_Text.svg|16px]] [[Draft_Text|Text]]}}, {{Button|[[File:Draft_Dimension.svg|16px]] [[Draft_Dimension|Dimension]]}}, and {{Button|[[File:Draft_Label.svg|16px]] [[Draft Label|Label]]}}.
Das Werkzeug {{Button|[[Image:Draft_AnnotationStyleEditor.svg|24px]] [[Draft_AnnotationStyleEditor/de|BeschriftungsstilEditor]]}}ermöglicht Stile festzulegen, die die visuellen Eigenschaften von Beschriftungsobjekten beeinflussen, die durch die Befehle [[Draft_Text/de|Draft Text]], [[Draft_Dimension/de|Draft Maß]] und [[Draft Label/de|Draft Hinweis]] erstellt werden.


[[File:Draft_AnnotationStyleEditor_example.png|400px]]
[[File:Draft_AnnotationStyleEditor_Dialog.png]]
{{Caption|Style editor to configure the annotations.}}
{{Caption|Das Dialogfenster Anmerkungsstil-Editor}}


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


# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
# Press {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor|Draft Annotation style editor]]}} button.
#* Die Schaltfläche {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor/de|Beschriftungsstile...]]}} drücken.
# Open the combobox, and then choose {{Button|Add new...}} to define a new style, or select one of the existing styles.
#* Den Menüeintrag {{MenuCommand|Anmerkung → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Beschriftungsstile...}} auswählen.
# Adjust the properties of the style, and then press {{Button|OK}} when satisfied.
# Das Dialogfenster {{MenuCommand|Anmerkungsstil-Editor}} wird geöffnet.
# Einen Stil aus der Aufklappliste {{MenuCommand|Stil-Name}} auswählen oder {{Value|Neu hinzufügen...}} auswählen, um einen neuen Stil zu definieren.
# Wahlweise die Eigenschaften des Stils anpassen.
# Wahlweise die Schaltläche {{Button|[[File:Accessories-text-editor.svg|16px]] Umbenennen}} drücken, um den Stil umzubenennen.
# Wahlweise die Schaltläche {{Button|[[File:Edit_Cancel.svg|16px]] Löschen}} drücken, um den Stil zu löschen.
# Wahlweise die Schaltläche {{Button|[[File:Std_Import.svg|16px]]}} drücken, um alle Stile aus einer {{FileName|.json}}-Datei zu importieren. Dies wird bestehende Stile mit dem gleichen Namen überschreiben.
# Wahlweise die Schaltläche {{Button|[[File:Std_Export.svg|16px]]}} drücken, um alle Stile in eine {{FileName|.json}}-Datei zu exportieren.
# Die Schaltfläche {{Button|OK}} drücken, um das Dialogfenster zu schließen und den Befehl zu beenden.


<span id="Scripting"></span>
Use the {{Button|[[File:Accessories-text-editor.svg|16px]] Rename}} or {{Button|[[File:Edit_Cancel.svg|16px]] Delete}} to rename or delete the active style.
==Skripten==


Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerierte API-Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].
== Scripting ==


Die Beschriftungsstile werden als geordnete Wörterbücher im {{incode|Meta}}-Attribut des Dokuments gespeichert. Dieses Attribut wird vom Beschriftungsstil-Editor gelesen, wenn er geöffnet wird.
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.


{{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.
Jeder Stil, der im Editor angezeigt wird, wird intern mit dem Stilnamen und vorangestelltem {{incode|Draft_Style_}} gespeichert; dies verhindert Namenskonflikte mit anderen Schlüsseln, die in {{incode|Meta}} gespeichert sein können, die beliebige Informationen enthalten können.

Du könntest jeden neuen Stil festlegen, durch hinzufügen der notwendigen Informationen zu einem Schlüssel, der mit {{incode|Draft_Style_}} beginnt. Der entsprechende Wert dieses Schlüssels muss ein serialisiertes Wörterbuch das mit {{incode|json}} verwendet.


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.


Die nicht eingegebenen Werte werden automatisch ausgefüllt, wenn dieser Stil im Stileditor ausgewählt ist und die Schaltfläche {{Button|OK}} gedrückt wird.
In a similar way, any serialized dictionary can be unpacked for edition.

Auf ähnliche Weise kann jedes serialisierte Wörterbuch für die Bearbeitung entpackt werden.

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


Die Eigenschaften müssen folgenden Typen entsprechen:
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.

Zeichenfolgen:


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 "
}
}
}}
}}


Fließkommazahlen (müssen mit einem Punkt als Dezimaltrennzeichen angegeben werden):
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.


Integer (Ganzzahlen):
Boolean:

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

Die Werte für {{Incode|TextColor}} und {{Incode|LineColor}} entsprechen einer 32-Bit-Ganzzahl, aus der die einzelnen RGBA-Werte entnommen werden können. {{Incode|ArrowType}} ist der Index einer Aufzählung.

Boolesche Werte:

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


{{Docnav/de
|[[Draft_Label/de|Etikett]]
|[[Draft_Move/de|Bewegen]]
|[[Draft_Workbench/de|Draft-Arbeitsbereich]]
|IconL=Draft_Label.svg
|IconR=Draft_Move.svg
|IconC=Workbench_Draft.svg
}}
}}



Latest revision as of 00:29, 31 December 2023

Draft BeschriftungsstilEditor

Menüeintrag
Anmerkung → Beschriftungsstile...
Arbeitsbereich
Draft
Standardtastenkürzel
Keiner
Eingeführt in Version
0.19
Siehe auch
Draft Text, Draft Hinweis, Draft Maß

Beschreibung

Das Werkzeug BeschriftungsstilEditorermöglicht Stile festzulegen, die die visuellen Eigenschaften von Beschriftungsobjekten beeinflussen, die durch die Befehle Draft Text, Draft Maß und Draft Hinweis erstellt werden.

Das Dialogfenster Anmerkungsstil-Editor

Anwendung

  1. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
    • Die Schaltfläche Beschriftungsstile... drücken.
    • Den Menüeintrag Anmerkung → Beschriftungsstile... auswählen.
  2. Das Dialogfenster Anmerkungsstil-Editor wird geöffnet.
  3. Einen Stil aus der Aufklappliste Stil-Name auswählen oder Neu hinzufügen... auswählen, um einen neuen Stil zu definieren.
  4. Wahlweise die Eigenschaften des Stils anpassen.
  5. Wahlweise die Schaltläche Umbenennen drücken, um den Stil umzubenennen.
  6. Wahlweise die Schaltläche Löschen drücken, um den Stil zu löschen.
  7. Wahlweise die Schaltläche drücken, um alle Stile aus einer .json-Datei zu importieren. Dies wird bestehende Stile mit dem gleichen Namen überschreiben.
  8. Wahlweise die Schaltläche drücken, um alle Stile in eine .json-Datei zu exportieren.
  9. Die Schaltfläche OK drücken, um das Dialogfenster zu schließen und den Befehl zu beenden.

Skripten

Siehe auch: Autogenerierte API-Dokumentation und FreeCAD Grundlagen Skripten.

Die Beschriftungsstile werden als geordnete Wörterbücher im Meta-Attribut des Dokuments gespeichert. Dieses Attribut wird vom Beschriftungsstil-Editor gelesen, wenn er geöffnet wird.

>>> 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": ""}

Jeder Stil, der im Editor angezeigt wird, wird intern mit dem Stilnamen und vorangestelltem Draft_Style_ gespeichert; dies verhindert Namenskonflikte mit anderen Schlüsseln, die in Meta gespeichert sein können, die beliebige Informationen enthalten können.

Du könntest jeden neuen Stil festlegen, durch hinzufügen der notwendigen Informationen zu einem Schlüssel, der mit Draft_Style_ beginnt. Der entsprechende Wert dieses Schlüssels muss ein serialisiertes Wörterbuch das mit json verwendet.

import json

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

Die nicht eingegebenen Werte werden automatisch ausgefüllt, wenn dieser Stil im Stileditor ausgewählt ist und die Schaltfläche OK gedrückt wird.

Auf ähnliche Weise kann jedes serialisierte Wörterbuch für die Bearbeitung entpackt werden.

import json

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

Die Eigenschaften müssen folgenden Typen entsprechen:

Zeichenfolgen:

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

Fließkommazahlen (müssen mit einem Punkt als Dezimaltrennzeichen angegeben werden):

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
}

Integer (Ganzzahlen):

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

Die Werte für TextColor und LineColor entsprechen einer 32-Bit-Ganzzahl, aus der die einzelnen RGBA-Werte entnommen werden können. ArrowType ist der Index einer Aufzählung.

Boolesche Werte:

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