Draft AnnotationStyleEditor/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>


{{Docnav
{{Docnav/pl
|[[Draft_Label|Label]]
|[[Draft_Label/pl|Etykieta]]
|[[Draft_Move|Move]]
|[[Draft_Move/pl|Przesuń]]
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|[[Draft_Module|Draft]]
|IconL=Draft_Label.svg
|IconL=Draft_Label.svg
|IconR=Draft_Move.svg
|IconR=Draft_Move.svg
Line 10: Line 10:
}}
}}


{{GuiCommand
{{GuiCommand/pl
|Name=Draft AnnotationStyleEditor
|Name=Draft AnnotationStyleEditor
|Name/pl=Rysunek Roboczy: Edytor stylu opisu
|MenuLocation=AnnotationAnnotation styles...
|MenuLocation=OpisEdytor stylu opisu ...
|Workbenches=[[Draft Module|Draft]]
|Workbenches=[[Draft_Workbench/pl|Rysunek Roboczy]]
|SeeAlso=[[Draft_Text|Draft Text]], [[Draft_Label|Draft Label]], [[Draft_Dimension|Draft Dimension]]
|SeeAlso=[[Draft_Text/pl|Tekst]], [[Draft_Label/pl|Etykieta]], [[Draft_Dimension/pl|Wymiar]]
|Version=0.19
|Version=0.19
}}
}}


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


The [[Image:Draft_AnnotationStyleEditor.svg|24px]] [[Draft_AnnotationStyleEditor|Draft_AnnotationStyleEditor]] command allows you to define styles that affect the visual properties of annotation-like objects, such as those create by the [[Draft_Text|Draft Text]], [[Draft_Dimension|Draft Dimension]] and [[Draft_Label|Draft Label]] commands.
Polecenie [[Image:Draft_AnnotationStyleEditor.svg|24px]] '''Edytor stylu opisu''' umożliwia definiowanie stylów, które wpływają na właściwości wizualne obiektów podobnych do adnotacji, takich jak te tworzone za pomocą poleceń [[Draft_Text/pl|Tekst]], [[Draft_Dimension/pl|Wymiar]] i [[Draft_Label/pl|Etykieta]].


[[File:Draft_AnnotationStyleEditor_example.png]]
[[File:Draft_AnnotationStyleEditor_Dialog.png]]
{{Caption|The Annotation Styles Editor dialog box}}
{{Caption|Okno dialogowe Edytor stylu opisu.}}


== Usage ==
<span id="Usage"></span>
==Użycie==


# Polecenie można wywołać na kilka sposobów:
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]]}} button.
#* Naciśnij przycisk {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] '''Edytor stylu opisu'''}}.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Annotation styles...}} option from the menu.
#* Wybierz opcję z menu {{MenuCommand|Opisy → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Edytor stylu opisu ...}}.
# The {{MenuCommand|Annotation Styles Editor}} dialog box opens.
# Otworzy się okno dialogowe {{MenuCommand|Edytor stylów opisów}}.
# Select a style from the {{MenuCommand|Style name}} dropdown list, or choose {{Value|Add new...}} to define a new style.
# Wybierz styl z listy rozwijanej {{MenuCommand|Nazwa stylu}} lub wybierz {{Value|Dodaj nowy ...}}, aby zdefiniować nowy styl.
# Opcjonalnie dostosuj właściwości stylu.
# Optionally adjust the properties of the style.
# Optionally press the {{Button|[[File:Accessories-text-editor.svg|16px]] Rename}} button to rename the style.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Accessories-text-editor.svg|16px]] Zmień nazwę}}, aby zmienić nazwę stylu.
# Optionally press the {{Button|[[File:Edit_Cancel.svg|16px]] Delete}} button to delete the style.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Edit_Cancel.svg|16px]] Usuń}}, aby usunąć styl.
# Optionally press the {{Button|[[File:Std_Import.svg|16px]]}} button to import all styles from a {{FileName|.json}} file. This will overwrite existing styles with the same name.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Std_Import.svg|16px]]}}, aby zaimportować wszystkie style z pliku {{FileName|.json}}. Spowoduje to nadpisanie istniejących stylów o tej samej nazwie.
# Optionally press the {{Button|[[File:Std_Export.svg|16px]]}} button to export all styles to a {{FileName|.json}} file.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Std_Export.svg|16px]]}}, aby wyeksportować wszystkie style do pliku {{FileName|.json}}.
# Press the {{Button|OK}} button to close the dialog box and finish the command.
# Naciśnij przycisk {{Button|OK}}, aby zamknąć okno dialogowe i zakończyć polecenie.


== Scripting ==
<span id="Scripting"></span>
==Tworzenie skryptów==


Zobacz również stronę: [https://freecad.github.io/SourceDoc/ Dokumentacja API generowana automatycznie] oraz [[FreeCAD_Scripting_Basics/pl|Podstawy pisania skryptów dla 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.

Style adnotacji są zapisywane jako serializowane słowniki w atrybucie {{incode|Meta}} dokumentu. Atrybut ten jest sprawdzany przez edytor stylów adnotacji po jego otwarciu.


{{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.
Każdy styl pojawiający się w edytorze jest wewnętrznie zapisywany z nazwą stylu poprzedzoną {{incode|Draft_Style_}}; zapobiegnie to kolizji nazw z innymi kluczami, które mogą być zapisane w {{incode|Meta}}, który może przechowywać dowolne informacje.

Możesz zdefiniować dowolny nowy styl, dodając niezbędne informacje do klucza zaczynającego się od {{incode|Draft_Style_}}. Odpowiednią wartością tego klucza musi być słownik serializowany przy użyciu {{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.


Niewprowadzone właściwości zostaną wypełnione automatycznie po wybraniu tego stylu w edytorze stylów i naciśnięciu przycisku {{Button|OK}}.
In a similar way, any serialized dictionary can be unpacked for edition.

W podobny sposób, każdy serializowany słownik może zostać rozpakowany do edycji.

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


Właściwości muszą mieć następujące typy:
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.

Ciąg znaków:


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


Liczby zmiennoprzecinkowe ''(muszą być podawane z kropką dziesiętną)'':
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.


Liczby całkowite:
Boolean:

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

{{Incode|KolorTekstu}} i {{Incode|KolorLinii}} odpowiadają 32-bitowej liczbie całkowitej, z której można wyodrębnić poszczególne wartości RGBA. {{Incode|TypStrzałki}} jest typem listy.

Wartości logiczne:

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




{{Docnav
{{Docnav/pl
|[[Draft_Label|Label]]
|[[Draft_Label/pl|Etykieta]]
|[[Draft_Move|Move]]
|[[Draft_Move/pl|Przesuń]]
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|[[Draft_Module|Draft]]
|IconL=Draft_Label.svg
|IconL=Draft_Label.svg
|IconR=Draft_Move.svg
|IconR=Draft_Move.svg

Latest revision as of 14:57, 11 December 2023

Rysunek Roboczy: Edytor stylu opisu

Lokalizacja w menu
Opis → Edytor stylu opisu ...
Środowisko pracy
Rysunek Roboczy
Domyślny skrót
brak
Wprowadzono w wersji
0.19
Zobacz także
Tekst, Etykieta, Wymiar

Opis

Polecenie Edytor stylu opisu umożliwia definiowanie stylów, które wpływają na właściwości wizualne obiektów podobnych do adnotacji, takich jak te tworzone za pomocą poleceń Tekst, Wymiar i Etykieta.

Okno dialogowe Edytor stylu opisu.

Użycie

  1. Polecenie można wywołać na kilka sposobów:
    • Naciśnij przycisk Edytor stylu opisu.
    • Wybierz opcję z menu Opisy → Edytor stylu opisu ....
  2. Otworzy się okno dialogowe Edytor stylów opisów.
  3. Wybierz styl z listy rozwijanej Nazwa stylu lub wybierz Dodaj nowy ..., aby zdefiniować nowy styl.
  4. Opcjonalnie dostosuj właściwości stylu.
  5. Opcjonalnie naciśnij przycisk Zmień nazwę, aby zmienić nazwę stylu.
  6. Opcjonalnie naciśnij przycisk Usuń, aby usunąć styl.
  7. Opcjonalnie naciśnij przycisk , aby zaimportować wszystkie style z pliku .json. Spowoduje to nadpisanie istniejących stylów o tej samej nazwie.
  8. Opcjonalnie naciśnij przycisk , aby wyeksportować wszystkie style do pliku .json.
  9. Naciśnij przycisk OK, aby zamknąć okno dialogowe i zakończyć polecenie.

Tworzenie skryptów

Zobacz również stronę: Dokumentacja API generowana automatycznie oraz Podstawy pisania skryptów dla FreeCAD.

Style adnotacji są zapisywane jako serializowane słowniki w atrybucie Meta dokumentu. Atrybut ten jest sprawdzany przez edytor stylów adnotacji po jego otwarciu.

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

Każdy styl pojawiający się w edytorze jest wewnętrznie zapisywany z nazwą stylu poprzedzoną Draft_Style_; zapobiegnie to kolizji nazw z innymi kluczami, które mogą być zapisane w Meta, który może przechowywać dowolne informacje.

Możesz zdefiniować dowolny nowy styl, dodając niezbędne informacje do klucza zaczynającego się od Draft_Style_. Odpowiednią wartością tego klucza musi być słownik serializowany przy użyciu 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

Niewprowadzone właściwości zostaną wypełnione automatycznie po wybraniu tego stylu w edytorze stylów i naciśnięciu przycisku OK.

W podobny sposób, każdy serializowany słownik może zostać rozpakowany do edycji.

import json

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

Właściwości muszą mieć następujące typy:

Ciąg znaków:

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

Liczby zmiennoprzecinkowe (muszą być podawane z kropką dziesiętną):

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
}

Liczby całkowite:

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

KolorTekstu i KolorLinii odpowiadają 32-bitowej liczbie całkowitej, z której można wyodrębnić poszczególne wartości RGBA. TypStrzałki jest typem listy.

Wartości logiczne:

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