Draft Label/pl: Difference between revisions

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


{{Docnav
{{Docnav/pl
|[[Draft_Dimension|Dimension]]
|[[Draft_Dimension/pl|Etykieta]]
|[[Draft_AnnotationStyleEditor|AnnotationStyleEditor]]
|[[Draft_AnnotationStyleEditor/pl|Edytor stylów adnotacji]]
|[[Draft_Workbench|Draft]]
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|IconL=Draft_Dimension.svg
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconR=Draft_AnnotationStyleEditor.svg
Line 10: Line 10:
}}
}}


{{GuiCommand
{{GuiCommand/pl
|Name=Draft Label
|Name=Draft Label
|Name/pl=Rysunek Roboczy: Etykieta
|MenuLocation=AnnotationLabel
|MenuLocation=AdnotacjaEtykieta
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]]
|Workbenches=[[Draft_Workbench/pl|Rysunek roboczy]], [[Arch_Workbench/pl|Architektura]]
|Shortcut={{KEY|D}} {{KEY|L}}
|Shortcut={{KEY|D}} {{KEY|L}}
|Version=0.17
|Version=0.17
|SeeAlso=[[Draft_Text|Draft Text]], [[Draft_ShapeString|Draft ShapeString]]
|SeeAlso=[[Draft_Text/pl|tekst]], [[Draft_ShapeString/pl|Kształt z tekstu]]
}}
}}


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


The [[Image:Draft_Label.svg|24px]] '''Draft Label''' command creates a multi-line text with a 2-segment leader line and an arrow.
Polecenie [[Image:Draft_Label.svg|24px]] '''Etykieta''' tworzy wielowierszowy tekst z dwu-segmentową linią prowadzącą i strzałką.


Jeśli obiekt lub element podrzędny (ściana, krawędź lub wierzchołek) jest zaznaczony podczas uruchamiania polecenia, obiekt tekstu może wyświetlać jeden lub dwa atrybuty wybranego elementu, w tym położenie, długość, powierzchnię, objętość i materiał. Tekst będzie wówczas powiązany z atrybutami i będzie aktualizowany w przypadku zmiany ich wartości.
If an object or a sub-element (face, edge or vertex) is selected when starting the command, the text can be made to display one or two attributes of the selected element, including position, length, area, volume and material. The text will then be linked to the attributes and will update if their values change.


To insert a text element without an arrow use the [[Draft_Text|Draft Text]] command instead.
Aby wstawić element tekstowy bez strzałki, należy użyć polecenia [[Draft_Text/pl|Tekst]].


[[Image:Draft_Label_example.jpg|400px]]
[[Image:Draft_Label_example.jpg|400px]]
{{Caption|Various labels with different orientations, arrows and information}}
{{Caption|Różne etykiety z różnymi orientacjami, strzałkami i informacjami.}}


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


See also: [[Draft_Tray|Draft Tray]], [[Draft_Snap|Draft Snap]] and [[Draft_Constrain|Draft Constrain]].
Zapoznaj się również z informacjami na stronie: [[Draft_Tray/pl|Tacka narzędziowa]], [[Draft_Snap/pl|Przyciąganie]] oraz [[Draft_Constrain/pl|Wiązania]].


# Opcjonalnie wybierz obiekt lub jego element podrzędny (wierzchołek, krawędź lub ścianę), którego atrybuty chcesz wyświetlić.
# Optionally select an object or a sub-element (vertex, edge or face) that you want to display attributes of.
# Polecenie można wywołać na kilka sposobów:
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Draft_Label.svg|16px]] [[Draft_Label|Draft Label]]}} button.
#* Naciśnij przycisk {{Button|[[Image:Draft_Label.svg|16px]] '''Etykieta'''}}.
#* Select the {{MenuCommand|Annotation → [[Image:Draft_Label.svg|16px]] Label}} option from the menu.
#* Wybierz z menu opcję {{MenuCommand|Opisy → [[Image:Draft_Label.svg|16px]] Etykieta}}.
#* Use the keyboard shortcut: {{KEY|D}} then {{KEY|L}}.
#* Użyj skrótu klawiaturowego: {{KEY|D}}, a następnie {{KEY|L}}.
# The {{MenuCommand|Label}} task panel opens. See [[#Options|Options]] for more information.
# Otworzy się panel zadań {{MenuCommand|Etykieta}}. Więcej informacji można znaleźć w sekcji [[#Opcje|Opcje]].
# If you have selected an element: select an option from the {{MenuCommand|Label type}} dropdown list. See [[#Label_types|Label types]] below.
# Jeśli wybrałeś element: wybierz opcję z rozwijanej listy {{MenuCommand|Typ etykiety}}. Zobacz sekcję [[#Typ_etykiety|Typ etykiety]] poniżej.
# Pick the first point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. This point indicates the target (arrow head). This can be anywhere, it does not have to be on an element.
# Wybierz pierwszy punkt w oknie [[3D_view/pl|widoku 3D]] lub wpisz współrzędne i naciśnij przycisk {{Button|[[Image:Draft_AddPoint.svg|16px]] Wprowadź punkt}}. Ten punkt wskazuje cel ''(główkę strzałki)''. Może to być dowolne miejsce, nie musi znajdować się na elemencie.
# Pick the second point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. This point indicates the start of the horizontal or vertical segment of the leader.
# Wybierz drugi punkt w oknie [[3D_view/pl|widoku 3D]] lub wpisz współrzędne i naciśnij przycisk {{Button|[[Image:Draft_AddPoint.svg|16px]] Wprowadź punkt}}. Punkt ten wskazuje początek poziomego lub pionowego segmentu linii prowadzącej.
# Pick the third point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. This point indicates the base point of the text.
# Wybierz trzeci punkt w oknie [[3D_view/pl|widoku 3D]] lub wpisz współrzędne i naciśnij przycisk {{Button|[[Image:Draft_AddPoint.svg|16px]] Wprowadź punkt}}. Punkt ten wskazuje punkt bazowy tekstu.


==Options==
<span id="Options"></span>
==Opcje==


Skróty klawiaturowe jedno znakowe dostępne w panelu zadań można zmienić. Zobacz stronę [[Draft_Preferences/pl|Preferencji]]. Skróty wymienione tutaj są skrótami domyślnymi.
The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts.


* To manually enter coordinates enter the X, Y and Z component, and press {{KEY|Enter}} after each. Or you can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button when you have the desired values. It is advisable to move the pointer out of the [[3D_view|3D view]] before entering coordinates.
* Aby ręcznie wprowadzić współrzędne, wprowadź element X, Y i Z i naciśnij {{KEY|Enter}} po każdym z nich. Możesz też nacisnąć przycisk {{Button|[[Image:Draft_AddPoint.svg|16px]] Wprowadź punkt}}, gdy uzyskasz żądane wartości. Zaleca się przesunięcie wskaźnika poza okno [[3D_view/pl|widoku 3D]] przed wprowadzeniem współrzędnych.
* Wciśnij {{KEY|R}} lub kliknij pole wyboru {{MenuCommand|Względnie}}, aby przełączyć tryb względny. Jeśli tryb względny jest włączony, współrzędne są względne do ostatniego punktu, jeśli jest dostępny, w przeciwnym razie są one względne do początku układu współrzędnych.
* Press {{KEY|R}} or click the {{MenuCommand|Relative}} checkbox to toggle relative mode. If relative mode is on, coordinates are relative to the last point, if available, else they are relative to the coordinate system origin.
* Press {{KEY|G}} or click the {{MenuCommand|Global}} checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the [[Draft_SelectPlane|working plane]] coordinate system. {{Version|0.20}}
* Naciśnij {{KEY|G}} lub kliknij pole wyboru {{MenuCommand|Globalnie}}, aby przełączyć tryb globalny. Jeśli tryb globalny jest włączony, współrzędne odnoszą się do globalnego układu współrzędnych, w przeciwnym razie odnoszą się do układu współrzędnych [[Draft_SelectPlane/pl|płaszczyzny roboczej]]. {{Version/pl|0.20}}
* Press {{KEY|S}} to switch [[Draft_Snap|Draft snapping]] on or off.
* Naciśnij {{KEY|S}}, aby włączyć lub wyłączyć [[Draft_Snap/pl|Przyciąganie]].
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.
* Naciśnij {{KEY|Esc}} lub przycisk {{Button|Zamknij}}, aby przerwać polecenie.


<span id="Label_types"></span>
== Label types ==
==Typ etykiety==


Dostępne są następujące typy etykiet:
The following label types are available:


* {{Value|Custom}}: displays the contents of {{PropertyData|Custom Text}}.
* {{Value|Użytkownika}}: wyświetla zawartość {{PropertyData|Tekst użytkownika}}.
* {{Value|Nazwa}}: wyświetla wewnętrzną nazwę obiektu docelowego. Nazwa wewnętrzna jest przypisywana podczas tworzenia obiektu i pozostaje niezmienna przez cały okres istnienia obiektu.
* {{Value|Name}}: displays the internal name of the target object. The internal name is assigned when an object is created and remains fixed throughout the existence of the object.
* {{Value|Etykieta}}: wyświetla etykietę obiektu docelowego. Etykieta obiektu może zostać zmieniona przez użytkownika.
* {{Value|Label}}: displays the label of the target object. The label of an object can be changed by the user.
* {{Value|Pozycja}}: wyświetla współrzędne punktu bazowego obiektu docelowego lub wierzchołka docelowego.
* {{Value|Position}}: displays the coordinates of the base point of the target object, of the target vertex, or of the center of mass of the target subelement, if applicable.
* {{Value|Długość}}: wyświetla długość docelowego obiektu lub elementu podrzędnego.
* {{Value|Length}}: displays the length of the target object or subelement, if applicable.
* {{Value|Powierzchnia}}: wyświetla obszar docelowego obiektu lub elementu podrzędnego.
* {{Value|Area}}: displays the area of the target object or subelement, if applicable.
* {{Value|Objętość}}: wyświetla objętość obiektu docelowego.
* {{Value|Volume}}: displays the volume of the target object, if applicable.
* {{Value|Tag}}: displays the {{incode|Tag}} attribute of the target object, if applicable. Objects created with the [[Arch_Workbench|Arch Workbench]] can have this attribute.
* {{Value|Znacznik}}: wyświetla atrybut {{incode|Znacznik}} obiektu docelowego. Obiekty utworzone za pomocą środowiska pracy [[Arch_Workbench/pl|Architektura]] mogą mieć ten atrybut.
* {{Value|Materiał}}: wyświetla etykietę materiału obiektu docelowego.
* {{Value|Material}}: displays the label of the material of the target object, if applicable.
* {{Value|Label + Position}}
* {{Value|Etykieta + pozycja}},
* {{Value|Label + Length}}
* {{Value|Etykieta + długość}},
* {{Value|Label + Area}}
* {{Value|Etykieta + powierzchnia}},
* {{Value|Label + Volume}}
* {{Value|Etykieta + objętość}},
* {{Value|Label + Material}}
* {{Value|Etykieta + materiał}}.


==Notes==
<span id="Notes"></span>
==Uwagi==


* Kierunek drugiego segmentu lidera określa wyrównanie tekstu. Jeśli segment jest poziomy i skierowany w prawo, tekst jest wyrównany do lewej i odwrotnie. Jeśli drugi segment jest skierowany pionowo w górę, tekst jest wyrównany do lewej. Jeśli jest skierowany pionowo w dół, tekst jest wyrównany do prawej.
* The direction of the second segment of the leader determines the alignment of the text. If the segment is horizontal and pointing to the right the text is aligned to the left and vice versa. If the second segment goes vertically up, the text is aligned to the left. If it goes vertically down, the text is aligned to the right.
* Draft Labels created or saved with [[Release_notes_0.21|FreeCAD version 0.21]] are not backward compatible.
* Wersje robocze etykiet utworzone lub zapisane w [[Release_notes_0.21/pl|FreeCAD w wersji 0.21]] nie kompatybilne wstecz.


==Properties==
<span id="Properties"></span>
==Właściwości==


See also: [[Property_editor|Property editor]].
Zapoznaj się również z informacjami na stronie: [[Property_editor/pl|Edytor właściwości]].


A Draft Label object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. The following properties are additional unless otherwise stated:
Etykieta środowispa pracy Rysunek Roboczy wywodzi się z obiektu [[App_FeaturePython/pl|App: FeaturePython]] i dziedziczy wszystkie jego właściwości. Poniższe właściwości dodatkowe, chyba że zaznaczono inaczej.


<span id="Data"></span>
=== Data ===
===Dane===


{{TitleProperty|Label}}
{{TitleProperty|Etykieta}}


* {{PropertyData|Custom Text|StringList}}: specifies the contents of the text if {{PropertyData|Label Type}} is {{Value|Custom}}. Each item in the list represents a new text line.
* {{PropertyData|Tekst użytkownika|StringList}}: określa zawartość tekstu, jeśli {{PropertyData|Typ etykiety}} to {{Value|Użytkownika}}. Każda pozycja na liście reprezentuje nową linię tekstu.
* {{PropertyData|Label Type|Enumeration}}: specifies the type of information displayed by the label. See [[#Label_types|Label types]].
* {{PropertyData|Typ etykiety|Enumeration}}: określa typ informacji wyświetlanych przez etykietę. Zobacz sekcję [[#Typ_etykiety|Typy etykiet]].
* {{PropertyData|Placement|Placement}}: specifies the position of the text in the [[3D view|3D view]] and, unless {{PropertyData|Straight Direction}} is {{Value|Custom}}, also of the first leader segment, which is the segment where the text is attached. See [[Placement|Placement]].
* {{PropertyData|Umiejscowienie|Placement}}: określa położenie tekstu w oknie [[3D_view/pl|widoku 3D]] i, o ile {{PropertyData|Kierunek prosty}} nie ma wartości {{Value|Użytkownika}}, także pierwszego segmentu prowadzącego, czyli segmentu, do którego dołączony jest tekst. Zobacz stronę [[Placement/pl|Umiejscowienie]].
* {{PropertyData|Text|StringList}}: (read-only) specifies the contents of the text that is actually displayed. Each item in the list represents a new text line.
* {{PropertyData|Tekst|StringList}}: ''(tylko do odczytu)'' określa zawartość wyświetlanego tekstu. Każdy element na liście reprezentuje nową linię tekstu.


{{TitleProperty|Leader}}
{{TitleProperty|Odniesienie}}


* {{PropertyData|Points|VectorList}}: specifies the points of the leader.
* {{PropertyData|Punkt|VectorList}}: określa punkty lidera.
* {{PropertyData|Straight Direction|Enumeration}}: specifies the direction of the first leader segment: {{Value|Custom}}, {{Value|Horizontal}} or {{Value|Vertical}}.
* {{PropertyData|Kierunek prosty|Enumeration}}: określa kierunek pierwszego segmentu prowadzącego: {{Value|Użytkownika}}, {{Value|Poziomo}} lub {{Value|Pionowo}}.
* {{PropertyData|Straight Distance|Distance}}: specifies the length of the first leader segment. Only used if {{PropertyData|Straight Direction}} is {{Value|Horizontal}} or {{Value|Vertical}}. If the distance is positive, the leader starts from the right side of the text and the text aligns to the right. Otherwise the leader starts from the left side of the text and the text aligns to the left.
* {{PropertyData|Odległość prosta|Distance}}: określa długość pierwszego segmentu prowadzącego. Używane tylko jeśli {{PropertyData|Kierunek prosty}} ma wartość {{Value|Poziomo}} lub {{Value|Pionowo}}. Jeśli odległość jest dodatnia, linia pomocnicza zaczyna się od prawej strony tekstu, a tekst jest wyrównywany do prawej. W przeciwnym razie lider zaczyna od lewej strony tekstu, a tekst jest wyrównany do lewej.


{{TitleProperty|Target}}
{{TitleProperty|Cel}}


* {{PropertyData|Target|LinkSub}}: specifies the object and optional subelement the label is linked to.
* {{PropertyData|Cel|LinkSub}}: określa obiekt i opcjonalny element podrzędny, z którym powiązana jest etykieta.
* {{PropertyData|Target Point|Vector}}: specifies the position of the tip of the leader, which is where the arrow is attached.
* {{PropertyData|Punkt docelowy|Vector}}: określa pozycję końcówki linii prowadzącej, do której przymocowana jest strzałka.


<span id="View"></span>
=== View ===
===Widok===


{{TitleProperty|Annotation}}
{{TitleProperty|Adnotacja}}


* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the label. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]].
* {{PropertyView|Styl adnotacji|Enumeration}}: określa styl adnotacji zastosowany do etykiety. Zobacz stronę [[Draft_AnnotationStyleEditor/pl|Edytor stylów adnotacji]].
* {{PropertyView|Scale Multiplier|Float}}: specifies the general scaling factor applied to the label.
* {{PropertyView|Mnożnik skali|Float}}: określa ogólny współczynnik skalowania zastosowany do etykiety.


{{TitleProperty|Display Options}}
{{TitleProperty|Opcje wyświetlania}}


* {{PropertyView|Display Mode|Enumeration}}: specifies how the text is displayed. If it is {{value|World}} the text will be displayed on a plane defined by the {{PropertyData|Placement}} of the label. If it is {{value|Screen}} the text will always face the screen. This is an inherited property. The mentioned options are the renamed options ({{Version|0.21}}).
* {{PropertyView|Tryb wyświetlania|Enumeration}}: określa sposób wyświetlania tekstu. Jeśli wartością jest {{value|Świat}}, tekst będzie wyświetlany na płaszczyźnie zdefiniowanej przez jego {{PropertyData|Umiejscowienie}}. Jeśli jest to {{value|Ekran}}, tekst będzie zawsze skierowany w stronę ekranu. To jest własność dziedziczona. Wspomniane opcje to opcje o zmienionych nazwach ''({{Version/pl|0.21}})''.


{{TitleProperty|Graphics}}
{{TitleProperty|Grafika}}


* {{PropertyView|Arrow Size|Length}}: specifies the size of the symbol displayed at the tip of the leader.
* {{PropertyView|Rozmiar strzałki|Length}}: określa rozmiar symbolu wyświetlanego na końcu linii prowadzącej.
* {{PropertyView|Arrow Type|Enumeration}}: specifies the type of symbol displayed at the tip of the leader, which can be {{value|Dot}}, {{value|Circle}}, {{value|Arrow}}, {{value|Tick}} or {{value|Tick-2}}.
* {{PropertyView|Typ strzałki|Enumeration}}: określa typ symbolu wyświetlanego na końcu wskaźnika, którym może być {{value|Punkt}}, {{value|Okrąg}}, {{value|Strzałka}}, {{value|Grot}} lub {{value|Grot-2}}.
* {{PropertyView|Frame|Enumeration}}: specifies what type of frame is drawn around the text. The current options are {{Value|None}} or {{Value|Rectangle}}.
* {{PropertyView|Ramka|Enumeration}}: określa typ ramki rysowanej wokół tekstu. Dostępne opcje to {{Value|Brak}} lub {{Value|Prostokąt}}.
* {{PropertyView|Line|Bool}}: specifies whether to display the leader line. If it is {{FALSE}} only the arrow and the text are displayed.
* {{PropertyView|Linia|Bool}}: określa, czy ma być wyświetlana linia prowadząca. Jeśli ma wartość {{FALSE/pl}}, wyświetlane tylko strzałka i tekst.
* {{PropertyView|Line Color|Color}}: specifies the color of the leader and the arrow. This is also used for the frame ({{Version|0.20}}).
* {{PropertyView|Kolor linii|Color}}: określa kolor linii prowadzącej i strzałki. Jest on również używany dla ramki ({{Version/pl|0.20}}).
* {{PropertyView|Line Width|Float}}: specifies the width of the leader. This is also used for the frame ({{Version|0.20}}).
* {{PropertyView|Szerokość linii|Float}}: określa szerokość linii odniesienia. Jest używana także dla ramki ({{Version/pl|0.20}}).


{{TitleProperty|Text}}
{{TitleProperty|Tekst}}


* {{PropertyView|Font Name|Font}}: specifies the font used to draw the text. It can be a font name, such as {{value|Arial}}, a default style such as {{value|sans}}, {{value|serif}} or {{value|mono}}, a family such as {{value|Arial,Helvetica,sans}}, or a name with a style such as {{value|Arial:Bold}}. If the given font is not found on the system, a default font is used instead. {{Version|0.21}}
* {{PropertyView|Nazwa czcionki|Font}}: określa czcionkę używaną do rysowania tekstu. Może to być nazwa czcionki, taka jak {{value|Arial}}, domyślny styl, taki jak {{value|sans}}, {{value|serif}} lub {{value|mono}}, rodzina, taka jak {{value|Arial,Helvetica,sans}}, lub nazwa ze stylem, takim jak {{value|Arial:Bold}}. Jeśli podana czcionka nie zostanie znaleziona w systemie, zamiast niej zostanie użyta czcionka domyślna. {{Version|0.21}}
* {{PropertyView|Font Size|Length}}: specifies the size of the letters. The text can be invisible in the [[3D_view|3D view]] if this value is very small. {{Version|0.21}}
* {{PropertyView|Rozmiar czcionki|Length}}: określa rozmiar liter. Tekst może być niewidoczny w oknie [[3D_view/pl|widoku 3D]], jeśli ta wartość jest bardzo mała. {{Version|0.21}}.
* {{PropertyView|Justification|Enumeration}}: specifies the horizontal alignment of the text: {{value|Left}}, {{value|Center}} or {{value|Right}}. Only used if {{PropertyData|Straight Direction}} is {{Value|Custom}}. Otherwise the horizontal alignment is based on the sign (positive or negative) of {{PropertyData|Straight Distance}}.
* {{PropertyView|Wyrównanie|Enumeration}}: określa poziome wyrównanie tekstu: {{value|Do lewej}}, {{value|Wyśrodkuj}} lub {{value|Do prawej}}. Używane tylko jeśli {{PropertyData|Kierunek prosty}} ma wartość {{Value|Użytkownika}}. W przeciwnym razie wyrównanie poziome jest oparte na znaku ''(dodatnim lub ujemnym)'' {{PropertyData|Odległość prosta}}.
* {{PropertyView|Line Spacing|Float}}: specifies the factor applied to the default line height of the text.
* {{PropertyView|Odstępy między wierszami|Float}}: określa współczynnik stosowany do domyślnej wysokości linii tekstu.
* {{PropertyView|Max Chars|Integer}}: specifies the maximum number of characters on each line of the text.
* {{PropertyView|Maksymalna liczba znaków|Integer}}: określa maksymalną liczbę znaków w każdej linii tekstu.
* {{PropertyView|Text Alignment|Enumeration}}: specifies the vertical alignment of the text: {{value|Top}}, {{value|Middle}} or {{value|Bottom}}.
* {{PropertyView|Wyrównanie tekstu|Enumeration}}: określa pionowe wyrównanie tekstu: {{value|Do góry}}, {{value|Pośrodku}} lub {{value|W dół}}.
* {{PropertyView|Text Color|Color}}: specifies the color of the text.
* {{PropertyView|Tekst Color|Color}}: określa kolor tekstu.


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


See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
Zobacz również stronę: [https://freecad.github.io/SourceDoc/ Dokumentacja API generowana automatycznie] oraz [[FreeCAD_Scripting_Basics/pl|Podstawy pisania skryptów dla FreeCAD]].


To create a Draft Label use the {{incode|make_label}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makeLabel}} method.
Aby utworzyć Etykietę środowiska pracy Rysunek Roboczy użyj metody {{incode|make_label}} modułu Rysunek Roboczy ({{Version/pl|0.19}}). Ta metoda zastępuje przestarzałą metodę {{incode|makeLabel}}.


{{Code|code=
{{Code|code=
Line 150: Line 160:
}}
}}


Przykład:
Example:


{{Code|code=
{{Code|code=
Line 165: Line 175:


label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.TextSize = 200
label1.ViewObject.FontSize= 200


p2 = App.Vector(-200, 0, 0)
p2 = App.Vector(-200, 0, 0)
Line 172: Line 182:
label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
custom_text="Beware of the sharp edges")
custom_text="Beware of the sharp edges")
label2.ViewObject.TextSize = 200
label2.ViewObject.FontSize= 200


p3 = App.Vector(1000, 1200, 0)
p3 = App.Vector(1000, 1200, 0)
Line 178: Line 188:


label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.TextSize = 200
label3.ViewObject.FontSize= 200


doc.recompute()
doc.recompute()
Line 184: Line 194:




{{Docnav
{{Docnav/pl
|[[Draft_Dimension|Dimension]]
|[[Draft_Dimension/pl|Etykieta]]
|[[Draft_AnnotationStyleEditor|AnnotationStyleEditor]]
|[[Draft_AnnotationStyleEditor/pl|Edytor stylów adnotacji]]
|[[Draft_Workbench|Draft]]
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|IconL=Draft_Dimension.svg
|IconL=Draft_Dimension.svg
|IconR=Draft_AnnotationStyleEditor.svg
|IconR=Draft_AnnotationStyleEditor.svg

Latest revision as of 17:15, 7 April 2024

Rysunek Roboczy: Etykieta

Lokalizacja w menu
Adnotacja → Etykieta
Środowisko pracy
Rysunek roboczy, Architektura
Domyślny skrót
D L
Wprowadzono w wersji
0.17
Zobacz także
tekst, Kształt z tekstu

Opis

Polecenie Etykieta tworzy wielowierszowy tekst z dwu-segmentową linią prowadzącą i strzałką.

Jeśli obiekt lub element podrzędny (ściana, krawędź lub wierzchołek) jest zaznaczony podczas uruchamiania polecenia, obiekt tekstu może wyświetlać jeden lub dwa atrybuty wybranego elementu, w tym położenie, długość, powierzchnię, objętość i materiał. Tekst będzie wówczas powiązany z atrybutami i będzie aktualizowany w przypadku zmiany ich wartości.

Aby wstawić element tekstowy bez strzałki, należy użyć polecenia Tekst.

Różne etykiety z różnymi orientacjami, strzałkami i informacjami.

Użycie

Zapoznaj się również z informacjami na stronie: Tacka narzędziowa, Przyciąganie oraz Wiązania.

  1. Opcjonalnie wybierz obiekt lub jego element podrzędny (wierzchołek, krawędź lub ścianę), którego atrybuty chcesz wyświetlić.
  2. Polecenie można wywołać na kilka sposobów:
    • Naciśnij przycisk Etykieta.
    • Wybierz z menu opcję Opisy → Etykieta.
    • Użyj skrótu klawiaturowego: D, a następnie L.
  3. Otworzy się panel zadań Etykieta. Więcej informacji można znaleźć w sekcji Opcje.
  4. Jeśli wybrałeś element: wybierz opcję z rozwijanej listy Typ etykiety. Zobacz sekcję Typ etykiety poniżej.
  5. Wybierz pierwszy punkt w oknie widoku 3D lub wpisz współrzędne i naciśnij przycisk Wprowadź punkt. Ten punkt wskazuje cel (główkę strzałki). Może to być dowolne miejsce, nie musi znajdować się na elemencie.
  6. Wybierz drugi punkt w oknie widoku 3D lub wpisz współrzędne i naciśnij przycisk Wprowadź punkt. Punkt ten wskazuje początek poziomego lub pionowego segmentu linii prowadzącej.
  7. Wybierz trzeci punkt w oknie widoku 3D lub wpisz współrzędne i naciśnij przycisk Wprowadź punkt. Punkt ten wskazuje punkt bazowy tekstu.

Opcje

Skróty klawiaturowe jedno znakowe dostępne w panelu zadań można zmienić. Zobacz stronę Preferencji. Skróty wymienione tutaj są skrótami domyślnymi.

  • Aby ręcznie wprowadzić współrzędne, wprowadź element X, Y i Z i naciśnij Enter po każdym z nich. Możesz też nacisnąć przycisk Wprowadź punkt, gdy uzyskasz żądane wartości. Zaleca się przesunięcie wskaźnika poza okno widoku 3D przed wprowadzeniem współrzędnych.
  • Wciśnij R lub kliknij pole wyboru Względnie, aby przełączyć tryb względny. Jeśli tryb względny jest włączony, współrzędne są względne do ostatniego punktu, jeśli jest dostępny, w przeciwnym razie są one względne do początku układu współrzędnych.
  • Naciśnij G lub kliknij pole wyboru Globalnie, aby przełączyć tryb globalny. Jeśli tryb globalny jest włączony, współrzędne odnoszą się do globalnego układu współrzędnych, w przeciwnym razie odnoszą się do układu współrzędnych płaszczyzny roboczej. dostępne w wersji 0.20
  • Naciśnij S, aby włączyć lub wyłączyć Przyciąganie.
  • Naciśnij Esc lub przycisk Zamknij, aby przerwać polecenie.

Typ etykiety

Dostępne są następujące typy etykiet:

  • Użytkownika: wyświetla zawartość DANETekst użytkownika.
  • Nazwa: wyświetla wewnętrzną nazwę obiektu docelowego. Nazwa wewnętrzna jest przypisywana podczas tworzenia obiektu i pozostaje niezmienna przez cały okres istnienia obiektu.
  • Etykieta: wyświetla etykietę obiektu docelowego. Etykieta obiektu może zostać zmieniona przez użytkownika.
  • Pozycja: wyświetla współrzędne punktu bazowego obiektu docelowego lub wierzchołka docelowego.
  • Długość: wyświetla długość docelowego obiektu lub elementu podrzędnego.
  • Powierzchnia: wyświetla obszar docelowego obiektu lub elementu podrzędnego.
  • Objętość: wyświetla objętość obiektu docelowego.
  • Znacznik: wyświetla atrybut Znacznik obiektu docelowego. Obiekty utworzone za pomocą środowiska pracy Architektura mogą mieć ten atrybut.
  • Materiał: wyświetla etykietę materiału obiektu docelowego.
  • Etykieta + pozycja,
  • Etykieta + długość,
  • Etykieta + powierzchnia,
  • Etykieta + objętość,
  • Etykieta + materiał.

Uwagi

  • Kierunek drugiego segmentu lidera określa wyrównanie tekstu. Jeśli segment jest poziomy i skierowany w prawo, tekst jest wyrównany do lewej i odwrotnie. Jeśli drugi segment jest skierowany pionowo w górę, tekst jest wyrównany do lewej. Jeśli jest skierowany pionowo w dół, tekst jest wyrównany do prawej.
  • Wersje robocze etykiet utworzone lub zapisane w FreeCAD w wersji 0.21 nie są kompatybilne wstecz.

Właściwości

Zapoznaj się również z informacjami na stronie: Edytor właściwości.

Etykieta środowispa pracy Rysunek Roboczy wywodzi się z obiektu App: FeaturePython i dziedziczy wszystkie jego właściwości. Poniższe właściwości są dodatkowe, chyba że zaznaczono inaczej.

Dane

Etykieta

  • DANETekst użytkownika (StringList): określa zawartość tekstu, jeśli DANETyp etykiety to Użytkownika. Każda pozycja na liście reprezentuje nową linię tekstu.
  • DANETyp etykiety (Enumeration): określa typ informacji wyświetlanych przez etykietę. Zobacz sekcję Typy etykiet.
  • DANEUmiejscowienie (Placement): określa położenie tekstu w oknie widoku 3D i, o ile DANEKierunek prosty nie ma wartości Użytkownika, także pierwszego segmentu prowadzącego, czyli segmentu, do którego dołączony jest tekst. Zobacz stronę Umiejscowienie.
  • DANETekst (StringList): (tylko do odczytu) określa zawartość wyświetlanego tekstu. Każdy element na liście reprezentuje nową linię tekstu.

Odniesienie

  • DANEPunkt (VectorList): określa punkty lidera.
  • DANEKierunek prosty (Enumeration): określa kierunek pierwszego segmentu prowadzącego: Użytkownika, Poziomo lub Pionowo.
  • DANEOdległość prosta (Distance): określa długość pierwszego segmentu prowadzącego. Używane tylko jeśli DANEKierunek prosty ma wartość Poziomo lub Pionowo. Jeśli odległość jest dodatnia, linia pomocnicza zaczyna się od prawej strony tekstu, a tekst jest wyrównywany do prawej. W przeciwnym razie lider zaczyna od lewej strony tekstu, a tekst jest wyrównany do lewej.

Cel

  • DANECel (LinkSub): określa obiekt i opcjonalny element podrzędny, z którym powiązana jest etykieta.
  • DANEPunkt docelowy (Vector): określa pozycję końcówki linii prowadzącej, do której przymocowana jest strzałka.

Widok

Adnotacja

  • WIDOKStyl adnotacji (Enumeration): określa styl adnotacji zastosowany do etykiety. Zobacz stronę Edytor stylów adnotacji.
  • WIDOKMnożnik skali (Float): określa ogólny współczynnik skalowania zastosowany do etykiety.

Opcje wyświetlania

  • WIDOKTryb wyświetlania (Enumeration): określa sposób wyświetlania tekstu. Jeśli wartością jest Świat, tekst będzie wyświetlany na płaszczyźnie zdefiniowanej przez jego DANEUmiejscowienie. Jeśli jest to Ekran, tekst będzie zawsze skierowany w stronę ekranu. To jest własność dziedziczona. Wspomniane opcje to opcje o zmienionych nazwach (dostępne w wersji 0.21).

Grafika

  • WIDOKRozmiar strzałki (Length): określa rozmiar symbolu wyświetlanego na końcu linii prowadzącej.
  • WIDOKTyp strzałki (Enumeration): określa typ symbolu wyświetlanego na końcu wskaźnika, którym może być Punkt, Okrąg, Strzałka, Grot lub Grot-2.
  • WIDOKRamka (Enumeration): określa typ ramki rysowanej wokół tekstu. Dostępne opcje to Brak lub Prostokąt.
  • WIDOKLinia (Bool): określa, czy ma być wyświetlana linia prowadząca. Jeśli ma wartość FAŁSZ, wyświetlane są tylko strzałka i tekst.
  • WIDOKKolor linii (Color): określa kolor linii prowadzącej i strzałki. Jest on również używany dla ramki (dostępne w wersji 0.20).
  • WIDOKSzerokość linii (Float): określa szerokość linii odniesienia. Jest używana także dla ramki (dostępne w wersji 0.20).

Tekst

  • WIDOKNazwa czcionki (Font): określa czcionkę używaną do rysowania tekstu. Może to być nazwa czcionki, taka jak Arial, domyślny styl, taki jak sans, serif lub mono, rodzina, taka jak Arial,Helvetica,sans, lub nazwa ze stylem, takim jak Arial:Bold. Jeśli podana czcionka nie zostanie znaleziona w systemie, zamiast niej zostanie użyta czcionka domyślna. introduced in version 0.21
  • WIDOKRozmiar czcionki (Length): określa rozmiar liter. Tekst może być niewidoczny w oknie widoku 3D, jeśli ta wartość jest bardzo mała. introduced in version 0.21.
  • WIDOKWyrównanie (Enumeration): określa poziome wyrównanie tekstu: Do lewej, Wyśrodkuj lub Do prawej. Używane tylko jeśli DANEKierunek prosty ma wartość Użytkownika. W przeciwnym razie wyrównanie poziome jest oparte na znaku (dodatnim lub ujemnym) DANEOdległość prosta.
  • WIDOKOdstępy między wierszami (Float): określa współczynnik stosowany do domyślnej wysokości linii tekstu.
  • WIDOKMaksymalna liczba znaków (Integer): określa maksymalną liczbę znaków w każdej linii tekstu.
  • WIDOKWyrównanie tekstu (Enumeration): określa pionowe wyrównanie tekstu: Do góry, Pośrodku lub W dół.
  • WIDOKTekst Color (Color): określa kolor tekstu.

Tworzenie skryptów

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

Aby utworzyć Etykietę środowiska pracy Rysunek Roboczy użyj metody make_label modułu Rysunek Roboczy (dostępne w wersji 0.19). Ta metoda zastępuje przestarzałą metodę makeLabel.

label = make_label(target_point=App.Vector(0, 0, 0),
                   placement=App.Vector(30, 30, 0),
                   target_object=None, subelements=None,
                   label_type="Custom", custom_text="Label",
                   direction="Horizontal", distance=-10,
                   points=None)

Przykład:

import FreeCAD as App
import Draft

doc = App.newDocument()

rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()

p1 = App.Vector(-200, 1000, 0)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())

label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.FontSize= 200

p2 = App.Vector(-200, 0, 0)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())

label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
                          custom_text="Beware of the sharp edges")
label2.ViewObject.FontSize= 200

p3 = App.Vector(1000, 1200, 0)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())

label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.FontSize= 200

doc.recompute()