Draft Text/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(125 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav|[[Draft_Rectangle|Rectangle]]|[[Draft_Dimension|Dimension]]|[[Draft_Module|Draft]]|IconL=Draft_Rectangle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Dimension.svg }}


{{Docnav/pl
<div class="mw-translate-fuzzy">
|[[Draft_Hatch/pl|Kreskowanie]]
{{GuiCommand/pl|Name=Draft Text|Name/pl=Draft Text|Workbenches=[[Draft Module/pl|Draft]], [[Arch Module/pl|Arch]]|MenuLocation=Draft → Text|Shortcut=T E}}
|[[Draft_Dimension/pl|Wymiar]]
</div>
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|IconL=Draft_Hatch.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}


{{GuiCommand/pl
==Description==
|Name=Draft Text
The Text tool inserts a multi-line textbox at a given point. It uses the [[Draft Linestyle|Draft Linestyle]] set on the [[Draft Tray|Draft Tray]].
|Name/pl=Rysunek roboczy: Tekst
|MenuLocation=Adnotacja → Tekst
|Workbenches=[[Draft_Workbench/pl|Rysunek roboczy]], [[Arch_Workbench/pl|Architektura]]
|Shortcut={{KEY|T}} {{KEY|E}}
|Version=0.7
|SeeAlso=[[Draft_Label/pl|Etykieta]], [[Draft_ShapeString/pl|Kształt z tekstu]]
}}


<span id="Description"></span>
To create a text label with a leader and an arrow use [[Draft Label|Draft Label]]. To create solid text or 3D letters use [[Draft ShapeString|Draft ShapeString]] with [[Part Extrude|Part Extrude]].
==Opis==


Narzędzie [[Image:Draft_Text.svg|24px]] '''Adnotacja wieloliniowa''' wstawia wielowierszowe pole tekstowe w wybranym miejscu.
<div class="mw-translate-fuzzy">
[[Image:Draft_Text_example.jpg|400px]]
</div>


Aby wstawić element tekstowy ze strzałką, użyj przycisku [[Draft_Label/pl|Rysunek roboczy: Etykieta]] zamiast tego polecenia.
'''Warning:''' The texts created with [[Release notes 0.18 |version 0.18]] are not backward compatible, so backup your work if you try to open files created with 0.18 with older versions.


[[Image:Draft_Text_example.png|400px]]
==How to use==
{{Caption|Pojedynczy punkt wymagany przy ustawianiu tekstu}}
# Press the {{Button|[[Image:Draft Text.png|16px]] [[Draft Text|Draft Text]]}} button, or press {{KEY|T}} then {{KEY|E}} keys.
# Click a point on the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button.
# Enter the desired text, pressing {{KEY|Enter}} between each line.
# Press {{KEY|Enter}} twice to finish the operation.


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


Zobacz również: [[Draft_Tray/pl|Rysunek roboczy: Tacka narzędziowa]] oraz [[Draft_Snap/pl|Rysunek roboczy: Przyciąganie]].
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. You can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button when you have the desired values to insert the point.
* Hold {{KEY|Ctrl}} while placing the text to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Press {{KEY|Enter}} or {{KEY|↓ Down arrow}} to enter a new line of text.
* Press {{KEY|↑ Up arrow}} to edit the previous line of text.
* Press {{KEY|Enter}} or {{KEY|↓ Down arrow}} twice to finish editing the text.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command.


# Istnieje kilka sposobów na wywołanie polecenia:
==Properties==
#* Naciśnij przycisk {{Button|[[Image:Draft_Text.svg|16px]] '''Adnotacja wieloliniowa'''}},
#* Wybierz opcję z menu {{MenuCommand|Adnotacje → [[Image:Draft_Text.svg|16px]] Tekst}},
#* Użyj skrótu klawiaturowego: {{KEY|T}} a następnie {{KEY|E}}.
# Otwiera się panel zadań {{MenuCommand|Tekst}}. Zobacz sekcję [[#Opcje|Opcje]], aby uzyskać więcej informacji.
# Kliknij punkt w oknie [[3D_view/pl|widoku 3D]], lub wpisz współrzędne i naciśnij przycisk {{Button|[[Image:Draft_AddPoint.svg|16px]] Dodaj punkt}}.
# Wprowadź żądany tekst, naciskając {{KEY|Enter}} między każdą linijką.
# Naciśnij {{KEY|Enter}} dwukrotnie, lub naciśnij przycisk {{Button|[[Image:Button_valid.svg|16px]]. Utwórz tekst}} aby zakończyć operację.


<span id="Options"></span>
=== Data ===
==Opcje==
* {{PropertyData|Text}}: specifies the contents of the text block as a list of strings; each element on the list, separated by a comma, indicates a new line.
* {{PropertyData|Position}}: specifies the base point of the first line of the text block.
* {{PropertyData|Angle}}: specifies the rotation of the baseline of the first line of the text block.
* {{PropertyData|Axis}}: specifies the axis to use for the rotation.


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 ''(w wersji 0.22)''.
=== View ===
* {{PropertyView|Display Mode}}: if it is "3D text" the text will be aligned to the scene axes, initially lying on the XY plane; if it is "2D text" the text will always face the camera.
* {{PropertyView|Font Name}}: specifies the font to use to draw the text. It can be a font name, such as "Arial", a default style such as "sans", "serif" or "mono", a family such as "Arial,Helvetica,sans" or a name with a style such as "Arial:Bold". If the given font is not found on the system, a generic one is used instead.
* {{PropertyView|Font Size}}: specifies the size of the letters. If the text object is created in the tree view but no text is visible, increase the size of the text until it is visible.
* {{PropertyView|Justification}}: specifies if the text aligns to the left, right or at the center of the base point.
* {{PropertyView|Line Spacing}}: specifies the space between lines of text.


* Aby ręcznie wprowadzić współrzędne, po prostu wprowadź liczby, a następnie naciśnij klawisz {{KEY|Enter}} pomiędzy każdą składową X, Y i Z. Możesz wcisnąć przycisk {{Button|[[Image:Draft_AddPoint.svg|16px]] dodaj punkt}}, gdy już wprowadzisz żądane wartości. Zaleca się wysunięcie kursora poza okno [[3D_view/pl|widoku 3D]] przed wprowadzeniem współrzędnych.
==Scripting==
* 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 są względne w stosunku do globalnego układu współrzędnych, w przeciwnym razie są względne w stosunku do układu współrzędnych [[Draft_SelectPlane/pl|płaszczyznay roboczej]]. {{Version/pl|0.20}}
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
* Naciśnij klawisz {{KEY|N}} lub zaznacz pole wyboru {{MenuCommand|Kontynuuj}} aby przełączyć tryb kontynuacji. Jeśli tryb kontynuacji jest włączony, polecenie zostanie uruchomione ponownie po zakończeniu pracy, umożliwiając kontynuowanie tworzenia tekstów. Skrót ten nie działa w drugim panelu zadań. Opcja ta nie jest dostępna w pierwszym panelu zadań w programie FreeCAD w wersji 0.19 i wcześniejszych.
* Naciśnij {{KEY|S}}, aby włączyć lub wyłączyć [[Draft_Snap/pl|przyciąganie]].
* Naciśnij klawisz {{KEY|Esc}} lub przycisk {{Button|Zamknij}}, aby przerwać bieżące polecenie.

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

* Tekst może być edytowany poprzez dwukrotne kliknięcie na nim w [[Tree_view/pl|Widoku drzewa]]. {{Version|0.20}}
* Teksty utworzone lub zapisane za pomocą funkcji [[Release_notes_0.21/pl|z wydania 0.21]] nie są wstecznie kompatybilne.

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

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

Obiekt Adnotacja wieloliniowa wywodzi się z obiektu [[App_FeaturePython/pl|App: FeaturePython]] i dziedziczy wszystkie jego właściwości. Poniższe właściwości są dodatkowe, chyba że zaznaczono inaczej.

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

{{TitleProperty|Podstawa}}

* {{PropertyData|Umieszczenie|Placement}}: określa położenie tekstu w oknie [[3D_view/pl|widoku 3D]]. Zobacz [[Placement/pl|Umiejscowienie]].
* {{PropertyData|Tekst|StringList}}: określa zawartość tekstu. Każda pozycja na liście reprezentuje nowy wiersz tekstu.

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

{{TitleProperty|Adnotacja}}

* {{PropertyView|Styl adnotacji|Enumeration}}: określa styl adnotacji zastosowany do tekstu. Zobacz stronę [[Draft_AnnotationStyleEditor/pl|Edytor stylów adnotacji]].
* {{PropertyView|Mnożnik skali|Float}}: określa ogólny współczynnik skalowania zastosowany do tekstu.

{{TitleProperty|Opcje wyświetlania}}

* {{PropertyView|Tryb wyświetlania|Enumeration}}: określa sposób wyświetlania tekstu. Jeśli wartością jest {{value|World}}, tekst będzie wyświetlany na płaszczyźnie zdefiniowanej przez jego {{PropertyData|Uniejscowienie}}. Jeśli jest to {{value|Screen}}, tekst będzie zawsze skierowany w stronę ekranu. To jest dziedziczona własność. Wspomniane opcje to opcje o zmienionych nazwach ''({{Version/pl|0.21}})''.

{{TitleProperty|Grafika}}

* {{PropertyView|Kolor linii|Color}}: nie wykorzystano.
* {{PropertyView|Szerokość linii|Float}}: nie wykorzystano.

{{TitleProperty|Tekst}}

* {{PropertyView|Nazwa czcionki}}: określa czcionkę, której należy używać do rysowania tekstu. Może to być nazwa czcionki, np. {{value|Arial}}, styl domyślny, np. {{value|sans}}, {{value|serif}} lub {{value|mono}}, rodzina {{value|Arial, Helvetica, sans}} lub nazwa w stylu {{value|Arial:Bold}}. Jeśli dana czcionka nie znajduje się w systemie, stosuje się zamiast niej czcionkę standardową.
* {{PropertyView|Wielkość czcionki}}: określa rozmiar liter. Jeżeli obiekt tekstowy jest tworzony w widoku drzewa, lecz nie jest widoczny żaden tekst, to należy zwiększyć rozmiar tekstu, aż będzie on widoczny.
* {{PropertyView|Wyrównanie}}: określa, czy tekst wyrównuje się do lewej, prawej czy do środka punktu bazowego.
* {{PropertyView|Rozstaw linii}}: określa odstęp między liniami tekstu.
* {{PropertyView|Kolor tekstu|Color}}: definiuje barwę tekstu.

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

Narzędzie '''Adnotacja wieloliniowa''' używa metody {{incode|make_text}} ''({{Version|0.19}})'' środowiska Rysunek roboczy. Ta metoda zastępuje przestarzałą metodę {{incode|makeText}}.


The Text tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
{{Code|code=
{{Code|code=
Text = makeText(stringlist, point=Vector(0,0,0), screen=False)
text = make_text(string, placement=None, screen=False)
}}
}}
* Creates a {{incode|Text}} object, at a {{incode|point}} defined by a {{incode|FreeCAD.Vector}}.
* {{incode|stringlist}} is a string, or a list of strings; if it's a list, each element is displayed in its own line.
* If {{incode|screen}} is {{incode|True}}, the text always faces the camera view direction, otherwise it aligns with the scene axes, and lies on the XY plane.


The placement of the {{incode|Text}} can be changed by overwriting its {{incode|Placement}} attribute, or by individually overwriting its {{incode|Placement.Base}} and {{incode|Placement.Rotation}} attributes.
* Tworzy obiekt {{incode|text}}, w miejscu {{incode|placement}}, który może być {{incode|FreeCAD.Placement}}, ale także zdefiniowanym przez {{incode|FreeCAD.Rotation}} lub {{incode|FreeCAD.Vector}}.
* {{incode|string}} to łańcuch, lub lista łańcuchów. Jeżeli jest to lista, to każdy element jest wyświetlany w swoim wierszu.
* Jeżeli wartość {{incode|screen}} ma wartość {{incode|True}}, to tekst jest zawsze zwrócony w kierunku obserwacji z kamery, w przeciwnym razie jest wyświetlana w płaszczyźnie zdefiniowanej przez jej {{PropertyData/pl|Umiejscowienie}}.


The view properties of {{incode|Text}} can be changed by overwriting its attributes; for example, overwrite {{incode|ViewObject.FontSize}} with the new size in millimeters.
Właściwości widoku {{incode|text}} można zmienić poprzez nadpisanie jego właściwości, np. nadpisać {{incode|ViewObject.FontSize}} wartością nowego rozmiaru w milimetrach.

Przykład:


Example:
{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft

doc = App.newDocument()


p1 = FreeCAD.Vector(0, 0, 0)
t1 = "This is a sample text"
t1 = "This is a sample text"
p1 = App.Vector(0, 0, 0)


p2 = FreeCAD.Vector(1000, 1000, 0)
t2 = ["First line", "second line"]
t2 = ["First line", "second line"]
p2 = App.Vector(1000, 1000, 0)


Text1 = Draft.makeText(t1, point=p1)
text1 = Draft.make_text(t1, p1)
Text2 = Draft.makeText(t2, point=p2)
text2 = Draft.make_text(t2, p2)
Text1.ViewObject.FontSize = 200
text1.ViewObject.FontSize = 200
Text2.ViewObject.FontSize = 200
text2.ViewObject.FontSize = 200

zaxis = App.Vector(0, 0, 1)


p3 = FreeCAD.Vector(-1000, -500, 0)
t3 = ["Upside", "down"]
t3 = ["Upside", "down"]
p3 = App.Vector(-1000, -500, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 180))
text3 = Draft.make_text(t3, place3)
text3.ViewObject.FontSize = 200


doc.recompute()
Text3 = Draft.makeText(t3, point=p3)
Text3.ViewObject.FontSize = 200

ZAxis = FreeCAD.Vector(0, 0, 1)
place3 = FreeCAD.Placement(p3, FreeCAD.Rotation(ZAxis, 175))
Text3.Placement = place3

Text4 = Draft.makeText(t3, point=p3)
Text4.ViewObject.FontSize = 200
Text4.Placement.Rotation = FreeCAD.Rotation(ZAxis, -30)
}}
}}


{{Docnav|[[Draft_Rectangle|Rectangle]]|[[Draft_Dimension|Dimension]]|[[Draft_Module|Draft]]|IconL=Draft_Rectangle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Dimension.svg }}


{{Docnav/pl
{{Draft Tools navi}}
|[[Draft_Hatch/pl|Kreskowanie]]

|[[Draft_Dimension/pl|Wymiar]]
{{Userdocnavi}}
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]
|IconL=Draft_Hatch.svg
|IconR=Draft_Dimension.svg
|IconC=Workbench_Draft.svg
}}


{{Draft Tools navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 07:45, 9 January 2024

Rysunek roboczy: Tekst

Lokalizacja w menu
Adnotacja → Tekst
Środowisko pracy
Rysunek roboczy, Architektura
Domyślny skrót
T E
Wprowadzono w wersji
0.7
Zobacz także
Etykieta, Kształt z tekstu

Opis

Narzędzie Adnotacja wieloliniowa wstawia wielowierszowe pole tekstowe w wybranym miejscu.

Aby wstawić element tekstowy ze strzałką, użyj przycisku Rysunek roboczy: Etykieta zamiast tego polecenia.

Pojedynczy punkt wymagany przy ustawianiu tekstu

Użycie

Zobacz również: Rysunek roboczy: Tacka narzędziowa oraz Rysunek roboczy: Przyciąganie.

  1. Istnieje kilka sposobów na wywołanie polecenia:
    • Naciśnij przycisk Adnotacja wieloliniowa,
    • Wybierz opcję z menu Adnotacje → Tekst,
    • Użyj skrótu klawiaturowego: T a następnie E.
  2. Otwiera się panel zadań Tekst. Zobacz sekcję Opcje, aby uzyskać więcej informacji.
  3. Kliknij punkt w oknie widoku 3D, lub wpisz współrzędne i naciśnij przycisk Dodaj punkt.
  4. Wprowadź żądany tekst, naciskając Enter między każdą linijką.
  5. Naciśnij Enter dwukrotnie, lub naciśnij przycisk . Utwórz tekst aby zakończyć operację.

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 (w wersji 0.22).

  • Aby ręcznie wprowadzić współrzędne, po prostu wprowadź liczby, a następnie naciśnij klawisz Enter pomiędzy każdą składową X, Y i Z. Możesz wcisnąć przycisk dodaj punkt, gdy już wprowadzisz żądane wartości. Zaleca się wysunięcie kursora poza okno widoku 3D przed wprowadzeniem 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 są względne w stosunku do globalnego układu współrzędnych, w przeciwnym razie są względne w stosunku do układu współrzędnych płaszczyznay roboczej. dostępne w wersji 0.20
  • Naciśnij klawisz N lub zaznacz pole wyboru Kontynuuj aby przełączyć tryb kontynuacji. Jeśli tryb kontynuacji jest włączony, polecenie zostanie uruchomione ponownie po zakończeniu pracy, umożliwiając kontynuowanie tworzenia tekstów. Skrót ten nie działa w drugim panelu zadań. Opcja ta nie jest dostępna w pierwszym panelu zadań w programie FreeCAD w wersji 0.19 i wcześniejszych.
  • Naciśnij S, aby włączyć lub wyłączyć przyciąganie.
  • Naciśnij klawisz Esc lub przycisk Zamknij, aby przerwać bieżące polecenie.

Uwagi

Właściwości

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

Obiekt Adnotacja wieloliniowa 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

Podstawa

  • DANEUmieszczenie (Placement): określa położenie tekstu w oknie widoku 3D. Zobacz Umiejscowienie.
  • DANETekst (StringList): określa zawartość tekstu. Każda pozycja na liście reprezentuje nowy wiersz tekstu.

Widok

Adnotacja

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

Opcje wyświetlania

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

Grafika

  • WIDOKKolor linii (Color): nie wykorzystano.
  • WIDOKSzerokość linii (Float): nie wykorzystano.

Tekst

  • WIDOKNazwa czcionki: określa czcionkę, której należy używać do rysowania tekstu. Może to być nazwa czcionki, np. Arial, styl domyślny, np. sans, serif lub mono, rodzina Arial, Helvetica, sans lub nazwa w stylu Arial:Bold. Jeśli dana czcionka nie znajduje się w systemie, stosuje się zamiast niej czcionkę standardową.
  • WIDOKWielkość czcionki: określa rozmiar liter. Jeżeli obiekt tekstowy jest tworzony w widoku drzewa, lecz nie jest widoczny żaden tekst, to należy zwiększyć rozmiar tekstu, aż będzie on widoczny.
  • WIDOKWyrównanie: określa, czy tekst wyrównuje się do lewej, prawej czy do środka punktu bazowego.
  • WIDOKRozstaw linii: określa odstęp między liniami tekstu.
  • WIDOKKolor tekstu (Color): definiuje barwę tekstu.

Tworzenie skryptów

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

Narzędzie Adnotacja wieloliniowa używa metody make_text (introduced in version 0.19) środowiska Rysunek roboczy. Ta metoda zastępuje przestarzałą metodę makeText.

text = make_text(string, placement=None, screen=False)
  • Tworzy obiekt text, w miejscu placement, który może być FreeCAD.Placement, ale także zdefiniowanym przez FreeCAD.Rotation lub FreeCAD.Vector.
  • string to łańcuch, lub lista łańcuchów. Jeżeli jest to lista, to każdy element jest wyświetlany w swoim wierszu.
  • Jeżeli wartość screen ma wartość True, to tekst jest zawsze zwrócony w kierunku obserwacji z kamery, w przeciwnym razie jest wyświetlana w płaszczyźnie zdefiniowanej przez jej DANEUmiejscowienie.

Właściwości widoku text można zmienić poprzez nadpisanie jego właściwości, np. nadpisać ViewObject.FontSize wartością nowego rozmiaru w milimetrach.

Przykład:

import FreeCAD as App
import Draft

doc = App.newDocument()

t1 = "This is a sample text"
p1 = App.Vector(0, 0, 0)

t2 = ["First line", "second line"]
p2 = App.Vector(1000, 1000, 0)

text1 = Draft.make_text(t1, p1)
text2 = Draft.make_text(t2, p2)
text1.ViewObject.FontSize = 200
text2.ViewObject.FontSize = 200

zaxis = App.Vector(0, 0, 1)

t3 = ["Upside", "down"]
p3 = App.Vector(-1000, -500, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 180))
text3 = Draft.make_text(t3, place3)
text3.ViewObject.FontSize = 200

doc.recompute()