Draft AnnotationStyleEditor/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(24 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|Draft]]
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|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_Workbench|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''' 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]].

{{Version|0.21}}: The Text color property and Text spacing property have been added.


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

== Usage ==


<span id="Usage"></span>
# There are several ways to invoke the command:
==Użycie==
#* Press the {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]]}} button.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Annotation styles...}} option from the menu.
# The {{MenuCommand|Annotation Styles Editor}} dialog box opens.
# Select a style from the {{MenuCommand|Style name}} dropdown list, or choose {{Value|Add new...}} to define a new style.
# Optionally adjust the properties of the style.
# Optionally press the {{Button|[[File:Accessories-text-editor.svg|16px]] Rename}} button to rename the style.
# Optionally press the {{Button|[[File:Edit_Cancel.svg|16px]] Delete}} button to delete the style.
# 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.
# Optionally press the {{Button|[[File:Std_Export.svg|16px]]}} button to export all styles to a {{FileName|.json}} file.
# Press the {{Button|OK}} button to close the dialog box and finish the command.


# Polecenie można wywołać na kilka sposobów:
== Scripting ==
#* Naciśnij przycisk {{Button|[[Image:Draft_AnnotationStyleEditor.svg|16px]] '''Edytor stylu opisu'''}}.
#* Wybierz opcję z menu {{MenuCommand|Opisy → [[Image:Draft_AnnotationStyleEditor.svg|16px]] Edytor stylu opisu ...}}.
# Otworzy się okno dialogowe {{MenuCommand|Edytor stylów opisów}}.
# Wybierz styl z listy rozwijanej {{MenuCommand|Nazwa stylu}} lub wybierz {{Value|Dodaj nowy ...}}, aby zdefiniować nowy styl.
# Opcjonalnie dostosuj właściwości stylu.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Accessories-text-editor.svg|16px]] Zmień nazwę}}, aby zmienić nazwę stylu.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Edit_Cancel.svg|16px]] Usuń}}, aby usunąć styl.
# 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.
# Opcjonalnie naciśnij przycisk {{Button|[[File:Std_Export.svg|16px]]}}, aby wyeksportować wszystkie style do pliku {{FileName|.json}}.
# Naciśnij przycisk {{Button|OK}}, aby zamknąć okno dialogowe i zakończyć polecenie.


<span id="Scripting"></span>
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
==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]].
{{Version|0.21}}: The information in this paragraph has been updated and reflects FreeCAD version 0.21.


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.
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=
Line 54: Line 54:
}}
}}


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.


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


{{Code|code=
{{Code|code=
Line 67: Line 67:
}}
}}


Niewprowadzone właściwości zostaną wypełnione automatycznie po wybraniu tego stylu w edytorze stylów i naciśnięciu przycisku {{Button|OK}}.
The properties not entered will be filled automatically when this style is selected in the style editor and the {{Button|OK}} button is pressed.


W podobny sposób, każdy serializowany słownik może zostać rozpakowany do edycji.
In a similar way, any serialized dictionary can be unpacked for edition.


{{Code|code=
{{Code|code=
Line 78: Line 78:
}}
}}


Właściwości muszą mieć następujące typy:
The properties must have the following types:


Ciąg znaków:
Strings:


{{Code|code=
{{Code|code=
Line 89: Line 89:
}}
}}


Liczby zmiennoprzecinkowe ''(muszą być podawane z kropką dziesiętną)'':
Floats (must be supplied with a decimal point):


{{Code|code=
{{Code|code=
Line 104: Line 104:
}}
}}


Liczby całkowite:
Integers:


{{Code|code=
{{Code|code=
Line 116: Line 116:
}}
}}


The {{Incode|TextColor}} and {{Incode|LineColor}} correspond to a 32-bit integer, from which the individual RGBA values can be extracted. The {{Incode|ArrowType}} is an enumerator.
{{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:
Booleans:


{{Code|code=
{{Code|code=
Line 128: Line 128:




{{Docnav
{{Docnav/pl
|[[Draft_Label|Label]]
|[[Draft_Label/pl|Etykieta]]
|[[Draft_Move|Move]]
|[[Draft_Move/pl|Przesuń]]
|[[Draft_Workbench|Draft]]
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|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,
}