Draft ShapeString/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "Zobacz również stronę: [https://freecad.github.io/SourceDoc/ Dokumentacja API generowana automatycznie] oraz Podstawy pisania skryptów dla FreeCAD.")
No edit summary
 
(12 intermediate revisions by 2 users not shown)
Line 59: Line 59:
* Szkic obiektu Kształt z tekstu może być edytowany poprzez dwukrotne kliknięcie go w [[Tree_view/pl|Widoku drzewa]]. {{Version/pl|0.20}}
* Szkic obiektu Kształt z tekstu może być edytowany poprzez dwukrotne kliknięcie go w [[Tree_view/pl|Widoku drzewa]]. {{Version/pl|0.20}}
* Obsługiwane czcionki to TrueType ({{FileName|.ttf}}), OpenType ({{FileName|.otf}}) i Type 1 ({{FileName|.pfb}}).
* Obsługiwane czcionki to TrueType ({{FileName|.ttf}}), OpenType ({{FileName|.otf}}) i Type 1 ({{FileName|.pfb}}).
* Polecenie jest ograniczone do tekstu '''LTR''' ''(od lewej do prawej)''. Dlatego w tej chwili tekst '''RTL''' ''(od prawej do lewej + od góry do dołu)'' nie jest obsługiwany.
* Polecenie jest ograniczone do tekstu od lewej do prawej. Teksty od prawej do lewej i od góry do dołu nie obsługiwane.
* Bardzo małe wysokości tekstu mogą skutkować zdeformowanymi kształtami znaków z powodu utraty szczegółów podczas skalowania.
* Bardzo małe wysokości tekstu mogą skutkować zdeformowanymi kształtami znaków z powodu utraty szczegółów podczas skalowania.
* Wiele czcionek wygeneruje problematyczną geometrię. Wynika to z faktu, że kontury czcionek mogą się nakładać, mieć małe odstępy i mieć różne kierunki w obrębie glifu. Warunki te są uważane za błędy w poliliniach używanych do definiowania ścian.
* Wiele czcionek wygeneruje problematyczną geometrię. Wynika to z faktu, że kontury czcionek mogą się nakładać, mieć małe odstępy i mieć różne kierunki w obrębie glifu. Warunki te są uważane za błędy w poliliniach używanych do definiowania ścian.
Line 89: Line 89:
Zobacz także: [[Preferences_Editor/pl|Edytor ustawień]], [[Draft_Preferences/pl|Rysunek Roboczy: Ustawienia]] i [[Std_DlgParameter/pl|Edytor parametrów]].
Zobacz także: [[Preferences_Editor/pl|Edytor ustawień]], [[Draft_Preferences/pl|Rysunek Roboczy: Ustawienia]] i [[Std_DlgParameter/pl|Edytor parametrów]].


* The default font file can be changed in the preferences: {{MenuCommand|EditPreferences... → DraftTexts and dimensionsDefault ShapeString font file}}.
* Domyślny plik czcionki można zmienić w preferencjach: {{MenuCommand|EdycjaPreferencje ... → Rysunek RoboczyTeksty i wymiaryDomyślny plik czcionki kształtu z tekstu}}.
* Dla użytkowników systemu Windows:
* For Windows users:
** Set {{MenuCommand|ToolsEdit parameters... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog}} to {{True}} to use the non-native file dialog when selecting a font file from the ShapeString task panel.
** Ustaw wartość parametru {{MenuCommand|PrzyboryEdytor parametrów ... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog}} na {{True/pl}}, aby użyć niesystemowego okna dialogowego wyboru pliku podczas wybierania pliku czcionki z panelu zadań Kształt z tekstu.
** Alternatively, set {{MenuCommand|ToolsEdit parameters... → BaseApp → Preferences → Dialog → DontUseNativeDialog}} to {{True}} to always use the non-native file dialog.
** Alternatywnie można ustawić parametr {{MenuCommand|PrzyboryEdytor parametrów ... → BaseApp → Preferences → Dialog → DontUseNativeDialog}} na {{True/pl}}, aby zawsze używać niesystemowego okna dialogowego wyboru pliku.


<span id="Properties"></span>
<span id="Properties"></span>
==Właściwości==
==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 ShapeString object is derived from a [[Part_Part2DObject|Part Part2DObject]] and inherits all its properties. It also has the following additional properties:
Obiekt ''Kształt z tekstu'' wywodzi się z obiektu [[Part_Part2DObject/pl|Część: Part2DObject]] i dziedziczy wszystkie jego właściwości. Posiada on również następujące dodatkowe właściwości:


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


{{TitleProperty|Draft}}
{{TitleProperty|Rysunek Roboczy}}


* {{PropertyData|Font File|File}}: Font file name.
* {{PropertyData|Plik czcionki|File}}: Nazwa pliku czcionki.
* {{PropertyData|Fuse|Bool}}: Fuse faces if faces overlap, usually not required (can be very slow). Ignored if {{PropertyData|Make Face}} is {{FALSE}}. {{Version|0.22}}
* {{PropertyData|Sczl|Bool}}: Łączenie ścian, jeśli zachodzą na siebie, zwykle nie jest wymagane ''(może być bardzo powolne)''. Ignorowane, jeśli parametr {{PropertyData|Utwórz ścianę}} ma wartość {{FALSE/pl}}. {{Version/pl|1.0}}
* {{PropertyData|Justification|Enumeration}}: Horizontal and vertical alignment. Options: {{value|Top-Left}}, {{value|Top-Center}}, {{value|Top-Right}}, {{value|Middle-Left}}, {{value|Middle-Center}}, {{value|Middle-Right}}, {{value|Bottom-Left}}, {{value|Bottom-Center}}, {{value|Bottom-Right}}. {{Version|0.22}}
* {{PropertyData|Wyrównanie|Enumeration}}: Wyrównanie poziome i pionowe. Opcje: {{value|Góra-lewo}}, {{value|Góra-środek}}, {{value|Góra-prawo}}, {{value|Środek-lewo}}, {{value|Środek}}, {{value|Środek-prawo}}, {{value|Dół-lewo}}, {{value|Dół-środek}}, {{value|Dół-prawo}}. {{Version/pl|1.0}}
* {{PropertyData|Justification Reference|Enumeration}}: Height reference used for justification. Options: {{value|Cap Height}}, {{value|Shape Height}}. The shape height depends on the characters in {{PropertyData|String}}. {{Version|0.22}}
* {{PropertyData|Odniesienie wyrównania|Enumeration}}: Odniesienie do wysokości używane do wyrównania. Opcje: {{value|Wysokość nasadki}}, {{value|Wysokość kształtu}}. Wysokość kształtu zależy od znaków w {{PropertyData|Ciągu znaków}}. {{Version/pl|1.0}}
* {{PropertyData|Keep Left Margin|Bool}}: Keep left margin and leading white space when justification is left. {{Version|0.22}}
* {{PropertyData|Zachowaj lewy margines|Bool}}: Zachowuje lewy margines i wiodącą spację, gdy justowanie jest w lewo. {{Version/pl|1.0}}.
* {{PropertyData|Make Face|Bool}}: Fill letters with faces.
* {{PropertyData|Utwórz ścianę|Bool}}: Wypełnia litery licami.
* {{PropertyData|Oblique Angle|Angle}}: Oblique (slant) angle. Must be in the -80° to +80° range. {{Version|0.22}}
* {{PropertyData|Kąt skośny|Angle}}: Kąt ukośny. Musi mieścić się w zakresie od -80° do +80°. {{Version|1.0}}.
* {{PropertyData|Scale To Size|Bool}}: Scale to ensure cap height is equal to size. If set to {{FALSE}}, depending on the font, cap height will not match {{PropertyData|Size}} exactly. {{Version|0.22}}
* {{PropertyData|Skaluj do rozmiaru|Bool}}: Skalowanie w celu zapewnienia, że wysokość nakładki jest równa rozmiarowi. Jeśli ustawiono na {{FALSE/pl}}, w zależności od czcionki, wysokość nakładki nie będzie dokładnie odpowiadać wartości {{PropertyData|Rozmiar}}. {{Version/pl|1.0}}
* {{PropertyData|Size|Length}}: Height of text.
* {{PropertyData|Rozmiar|Length}}: Wysokość tekstu.
* {{PropertyData|String|String}}: Text string. A ShapeString can only display a single text line.
* {{PropertyData|Ciąg znaków|String}}: Ciąg tekstowy. Obiekt Kształt z tekstu może wyświetlać tylko jedną linię tekstu.
* {{PropertyData|Tracking|Distance}}: Inter-character spacing. The property type has been updated ({{Version|0.22}}).
* {{PropertyData|Kontrola|Distance}}: Odstęp między znakami. Typ właściwości został zaktualizowany ({{Version/pl|1.0}}).


[[Image:Draft_ShapeString_Justification.png|200px]]
[[Image:Draft_ShapeString_Justification.png|200px]]
{{Caption|The height of the red rectangle (solid line) is equal to the cap height.<br>
{{Caption|Wysokość czerwonego prostokąta ''(linia ciągła)'' jest równa wysokości nakładki.<br>
Wysokość zielonego prostokąta ''(linia przerywana)'' jest równa wysokości kształtu.<br>
The height of the green rectangle (dashed line) is equal to the shape height.<br>
Narożniki, środki krawędzi i środki prostokątów<br>
The corners, the midpoints of the edges, and the center of the rectangles<br>
dopasuj 9 opcji wyrównania: od lewego górnego do prawego dolnego rogu.}}
match the 9 justification options: Top-Left to Bottom-Right.}}


<span id="Scripting"></span>
<span id="Scripting"></span>
Line 129: Line 129:
Zobacz również stronę: [https://freecad.github.io/SourceDoc/ Dokumentacja API generowana automatycznie] oraz [[FreeCAD_Scripting_Basics/pl|Podstawy pisania skryptów dla FreeCAD]].
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 ShapeString use the {{incode|make_shapestring}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makeShapeString}} method.
Aby utworzyć Kształt z tekstu użyj metody {{incode|make_shapestring}} modułu Rysunek Roboczy ''({{Version/pl|0.19}})''. Ta metoda zastępuje przestarzałą metodę {{incode|makeShapeString}}.


{{Code|code=
{{Code|code=

Latest revision as of 10:20, 21 April 2024

Rysunek Roboczy: Kształt z tekstu

Lokalizacja w menu
Kreślenie → Kształt z tekstu ...
Środowisko pracy
Rysunek Roboczy, Architektura
Domyślny skrót
brak
Wprowadzono w wersji
0.14
Zobacz także
Tekst, Etykieta, Wyciągnij

Opis

Polecenie Kształt z tekstu tworzy złożony kształt reprezentujący ciąg tekstowy. Kształt ten może być użyty do tworzenia liter 3D za pomocą polecenia Wyciągnij środowiska pracy Część.

Polecenie Kształt z tekstu nie jest przeznaczone do wykonywania standardowych adnotacji tekstowych. W tym celu należy użyć polecenia Tekst lub Etykieta.

Pojedynczy punkt wymagany do pozycjonowania obiektu Kształt z tekstu

Użycie

Dla użytkowników Windows OS: przeczytaj najpierw akapit Wybór pliku czcionki w systemie Windows.

  1. Polecenie można wywołać na kilka sposobów:
    • Naciśnij przycisk Kształt z tekstu.
    • Wybierz opcję z menu Kreślenie → Kształt z tekstu.
  2. Otworzy się panel zadań Kształt z tekstu.
  3. Kliknij punkt w oknie widoku 3D lub wpisz współrzędne.
  4. Opcjonalnie naciśnij przycisk Zresetuj współrzędne punktu, aby zresetować punkt do położenia punktu początkowego.
  5. Wprowadź Ciąg znaków.
  6. Określ Wysokość.
  7. Aby wybrać czcionkę, wykonaj jedną z poniższych czynności:
    • Wprowadź ścieżkę do pliku w polu wprowadzania Plik czcionki.
    • Naciśnij przycisk ... i wybierz plik.
  8. Naciśnij przycisk OK, aby zakończyć polecenie.
  9. Opcjonalnie można zmienić włąściwość DANEWyrównanie dla tekstu. Zobacz Właściwości.

Opcje

  • Naciśnij przycisk Esc lub przycisk Anuluj aby przerwać wykonywanie polecenia.

Uwagi

  • Szkic obiektu Kształt z tekstu może być edytowany poprzez dwukrotne kliknięcie go w Widoku drzewa. dostępne w wersji 0.20
  • Obsługiwane czcionki to TrueType (.ttf), OpenType (.otf) i Type 1 (.pfb).
  • Polecenie jest ograniczone do tekstu od lewej do prawej. Teksty od prawej do lewej i od góry do dołu nie są obsługiwane.
  • Bardzo małe wysokości tekstu mogą skutkować zdeformowanymi kształtami znaków z powodu utraty szczegółów podczas skalowania.
  • Wiele czcionek wygeneruje problematyczną geometrię. Wynika to z faktu, że kontury czcionek mogą się nakładać, mieć małe odstępy i mieć różne kierunki w obrębie glifu. Warunki te są uważane za błędy w poliliniach używanych do definiowania ścian.
  • Kształt z tekstu można również utworzyć za pomocą makrodefinicji Fonts Win10 PYMP.
  • Aby utworzyć Kształt tekstu ułożony w okrąg, należy użyć makrodefinicji FCCircularText.

Wybór pliku czcionki w systemie Windows

W systemie Windows dostęp do domyślnego folderu czcionek jest chroniony. Ma to wpływ na wybór pliku czcionki dla obiektu Kształt z tekstu. W FreeCAD istnieją trzy przypadki, w których można określić plik czcionki dla tekstu: w panelu zadań Kształt z tekstu, podczas zmiany właściwości DANEPlik czcionki tekstu oraz podczas określania domyślnego pliku czcionki w Ustawieniach środowiska pracy Rysunek Roboczy.

Naciśnięcie przycisku ..., a następnie wybranie pliku z domyślnego folderu czcionek systemu Windows nie jest możliwe podczas korzystania z natywnego okna dialogowego plików. Istnieje kilka rozwiązań:

  • Upewnij się, że wartość opcji DontUseNativeFontDialog jest ustawiona na Prawda, co jest wartością domyślną dla tej preferencji. Spowoduje to wywołanie innego, nienatywnego okna dialogowego pliku tylko po naciśnięciu przycisku ... na panelu zadań Kształt z tekstu. Za pomocą tego okna dialogowego plików można uzyskać dostęp do domyślnego folderu czcionek systemu Windows.
  • Zmień wartość opcji DontUseNativeDialog na Prawda. To instruuje FreeCAD, aby zawsze używał okna dialogowego innego niż systemowe.
  • Określ plik czcionki w polu wprowadzania. Możesz oczywiście wpisać pełną ścieżkę lub skopiować-wkleić ścieżkę z Eksploratora plików Windows. Istnieje jednak również inny sposób wprowadzenia ścieżki. Jeśli wpiszesz C:\, pojawi się lista rozwijana. Wybierz Windows z tej listy i dodaj \F. Z nowej listy rozwijanej wybierz Fonts. Na koniec dodaj \ i pierwszą literę (lub kilka) pliku czcionki, a następnie wybierz ją z rozwijanej listy.
  • Utwórz niestandardowy folder dla plików czcionek.

Zobacz akapit Ustawienia poniżej, aby sprawdzić lokalizację wspomnianych preferencji.

Poradniki

Ustawienia

Zobacz także: Edytor ustawień, Rysunek Roboczy: Ustawienia i Edytor parametrów.

  • Domyślny plik czcionki można zmienić w preferencjach: Edycja → Preferencje ... → Rysunek Roboczy → Teksty i wymiary → Domyślny plik czcionki kształtu z tekstu.
  • Dla użytkowników systemu Windows:
    • Ustaw wartość parametru Przybory → Edytor parametrów ... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog na Prawda, aby użyć niesystemowego okna dialogowego wyboru pliku podczas wybierania pliku czcionki z panelu zadań Kształt z tekstu.
    • Alternatywnie można ustawić parametr Przybory → Edytor parametrów ... → BaseApp → Preferences → Dialog → DontUseNativeDialog na Prawda, aby zawsze używać niesystemowego okna dialogowego wyboru pliku.

Właściwości

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

Obiekt Kształt z tekstu wywodzi się z obiektu Część: Part2DObject i dziedziczy wszystkie jego właściwości. Posiada on również następujące dodatkowe właściwości:

Dane

Rysunek Roboczy

  • DANEPlik czcionki (File): Nazwa pliku czcionki.
  • DANESczl (Bool): Łączenie ścian, jeśli zachodzą na siebie, zwykle nie jest wymagane (może być bardzo powolne). Ignorowane, jeśli parametr DANEUtwórz ścianę ma wartość FAŁSZ. dostępne w wersji 1.0
  • DANEWyrównanie (Enumeration): Wyrównanie poziome i pionowe. Opcje: Góra-lewo, Góra-środek, Góra-prawo, Środek-lewo, Środek, Środek-prawo, Dół-lewo, Dół-środek, Dół-prawo. dostępne w wersji 1.0
  • DANEOdniesienie wyrównania (Enumeration): Odniesienie do wysokości używane do wyrównania. Opcje: Wysokość nasadki, Wysokość kształtu. Wysokość kształtu zależy od znaków w DANECiągu znaków. dostępne w wersji 1.0
  • DANEZachowaj lewy margines (Bool): Zachowuje lewy margines i wiodącą spację, gdy justowanie jest w lewo. dostępne w wersji 1.0.
  • DANEUtwórz ścianę (Bool): Wypełnia litery licami.
  • DANEKąt skośny (Angle): Kąt ukośny. Musi mieścić się w zakresie od -80° do +80°. introduced in version 1.0.
  • DANESkaluj do rozmiaru (Bool): Skalowanie w celu zapewnienia, że wysokość nakładki jest równa rozmiarowi. Jeśli ustawiono na FAŁSZ, w zależności od czcionki, wysokość nakładki nie będzie dokładnie odpowiadać wartości DANERozmiar. dostępne w wersji 1.0
  • DANERozmiar (Length): Wysokość tekstu.
  • DANECiąg znaków (String): Ciąg tekstowy. Obiekt Kształt z tekstu może wyświetlać tylko jedną linię tekstu.
  • DANEKontrola (Distance): Odstęp między znakami. Typ właściwości został zaktualizowany (dostępne w wersji 1.0).

Wysokość czerwonego prostokąta (linia ciągła) jest równa wysokości nakładki.
Wysokość zielonego prostokąta (linia przerywana) jest równa wysokości kształtu.
Narożniki, środki krawędzi i środki prostokątów
dopasuj 9 opcji wyrównania: od lewego górnego do prawego dolnego rogu.

Tworzenie skryptów

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

Aby utworzyć Kształt z tekstu użyj metody make_shapestring modułu Rysunek Roboczy (dostępne w wersji 0.19). Ta metoda zastępuje przestarzałą metodę makeShapeString.

shapestring = make_shapestring(String, FontFile, Size=100, Tracking=0)
  • Tworzy złożony kształt shapestring przy użyciu określonego String i pełnej ścieżki obsługiwanego FontFile.
  • Size to wysokość wynikowego tekstu w milimetrach.
  • Tracking to odstęp między znakami w milimetrach.

Umiejscowienie obiektu Kształt z tekstu można zmienić nadpisując jego atrybut Placement lub indywidualnie nadpisując jego atrybuty Placement.Base i Placement.Rotation.

Przykład:

import FreeCAD as App
import Draft

doc = App.newDocument()

font1 = "/usr/share/fonts/truetype/msttcorefonts/Arial.ttf"
font2 = "/usr/share/fonts/truetype/dejavu/DejaVuSerif.ttf"
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"

S1 = Draft.make_shapestring("This is a sample text", font1, 200)

S2 = Draft.make_shapestring("Inclined text", font2, 200, 10)

zaxis = App.Vector(0, 0, 1)
p2 = App.Vector(-1000, 500, 0)
place2 = App.Placement(p2, App.Rotation(zaxis, 45))
S2.Placement = place2

S3 = Draft.make_shapestring("Upside-down text", font3, 200, 10)
S3.Placement.Base = App.Vector(0, -1000, 0)
S3.Placement.Rotation = App.Rotation(zaxis, 180)

doc.recompute()