Draft ShapeString/de: Difference between revisions

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

<div class="mw-translate-fuzzy">
{{Docnav/de
{{Docnav/de
|[[Draft_Point/de|Punkt]]
|[[Draft_Point/de|Punkt]]
|[[Draft_Facebinder/de|Flächenbinder]]
|[[Draft_Facebinder/de|Flächenbinder]]
|[[Draft_Module/de|Entwurf]]
|[[Draft_Workbench/de|Entwurf]]
|IconL=Draft_Point.svg
|IconL=Draft_Point.svg
|IconR=Draft_Facebinder.svg
|IconR=Draft_Facebinder.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
</div>


<div class="mw-translate-fuzzy">
{{GuiCommand/de
{{GuiCommand/de
|Name=Draft ShapeString
|Name=Draft ShapeString
|Name/de=Entwurf FormZeichenfolge
|Name/de=Entwurf FormZeichenfolge
|MenuLocation=Entwurf → Form aus Text ...
|MenuLocation=Entwurf → Form aus Text ...
|Workbenches=[[Draft_Module/de|Entwurf]], [[Arch_Module/de|Architektur]]
|Workbenches=[[Draft_Workbench/de|Entwurf]], [[Arch_Workbench/de|Architektur]]
|Shortcut={{KEY|S}} {{KEY|S}}
|Shortcut={{KEY|S}} {{KEY|S}}
|Version=0.14
|Version=0.14
Line 19: Line 23:
[[Macro_Fonts_Win10_PYMP/de|Makro Schriftarten Win10 PYMP]]
[[Macro_Fonts_Win10_PYMP/de|Makro Schriftarten Win10 PYMP]]
}}
}}
</div>


==Beschreibung==
==Beschreibung==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Das Werkzeug FormZeichenkette fügt eine Verbundform ein, die eine Zeichenkette darstellt. Die Texthöhe, die Laufweite und die Schriftart können angegeben werden.
Das Werkzeug {{Button|[[Image:Draft_ShapeString.svg|16px]] [[Draft_ShapeString/de|Entwurf FormZeichenfolge]]}} fügt eine Verbundform ein, die eine TextZeichenfolge darstellt. Texthöhe, Laufweite und Schriftart können angegeben werden.
Die resultierende Form kann mit dem Werkzeug [[Part Extrude/de|Teil Extrusion]] verwendet werden, um 3D Buchstaben zu erzeugen.
Die resultierende Form kann mit dem Werkzeug [[Image:Part_Extrude.svg|24px]] [[Part_Extrude/de|Teil Extrusion]] verwendet werden, um 3D Buchstaben zu erzeugen.
</div>
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
'''Alternativ''':
Um ein einfacheres Textelement ohne geschlossene Form einzufügen, verwende [[Draft Text/de|Entwurf Text]]. Um eine Textbeschriftung mit einem Anfang und einem Pfeil zu erstellen, verwende [[Draft Label/de|Entwurf Beschriftung]]
Um ein einfacheres Textelement ohne geschlossene Form einzufügen, verwende [[Image:Draft_Text.svg|24px]] [[Draft_Text/de|Entwurf Text]]. Um eine Textbeschriftung mit einem Anfang und einem Pfeil zu erstellen, verwende [[Image:Draft_Label.svg|24px]][[Draft_Label/de|Entwurf Beschriftung]]
</div>
</div>


[[Image:Draft_ShapeString_Example400.png]]
[[Image:Draft_ShapeString_Example400.png]]
<div class="mw-translate-fuzzy">
{{Caption|Einfacher Punkt zur Positionierung des Formzeichenfolge erforderlich}}
{{Caption|Einfacher Punkt zur Positionierung des Formzeichenfolge erforderlich}}
</div>


==Anwendung==
==Anwendung==


For Windows users: please read the [[#Font_file_selection_on_Windows|Font file selection on Windows]] paragraph first.
<div class="mw-translate-fuzzy">
Wenn der Entwurf Benutzeroberflächenmodus auf Werkzeugleiste eingestellt ist:
# Drücke den {{Button|[[Image:Draft_ShapeString16.png]] [[Draft_ShapeString|Entwurf Formfolge]]}} oder drücke die Tasten {{KEY|S}} und dann {{KEY|S}}.
# Klicke auf einen Punkt in der 3D Ansicht, oder gib [[Draft_Coordinates/de|Koordinate]] ein und drücke die Taste {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügen]]}}.
# Gib den gewünschten Text ein und drücke {{KEY|Enter}}.
# Gib die gewünschte Größe ein und drücke {{KEY|Enter}}.
# Gib die gewünschte Laufweite ein und drücke {{KEY|Enter}}.
# Drücke {{KEY|Enter}}, um die angezeigte Schriftartdatei zu übernehmen, oder drücke {{Button|...}}, um eine Schriftartdatei auszuwählen.
</div>
[[Image:SSFontSelect.png]]


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 52: Line 51:
# Ein Dialogfeld erscheint, in dem Du deine Parameter angeben kannst.
# Ein Dialogfeld erscheint, in dem Du deine Parameter angeben kannst.
# Drücke die Taste {{KEY|OK}}, um die Formfolge zu erstellen.
# Drücke die Taste {{KEY|OK}}, um die Formfolge zu erstellen.
</div>
</div>


==Optionen==


<div class="mw-translate-fuzzy">
*Der Text, die Größe, die Laufweite und die Schriftart können nach der Erstellung geändert werden, indem die Werte im Eigenschaften Editor modifiziert werden.
* Um Koordinaten von Hand einzugeben, gib einfach die Zahlen ein und drücke dann {{KEY|Enter}} zwischen jeder X-, Y- und Z-Komponente. Du kannst den {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt hinzufügent}} drücken, wenn Du die gewünschten Werte zum Einfügen des Punktes hast.
*Du wirst die Standardschriftartdatei in [[Draft Preferences|/de|Entwurf Einstellungen]], im Register {{Button/de|Texte und Abmessungen}} einstellen wollen. Dadurch wird das Schriftartendateifeld im Dialogfeld ausgefüllt.
* Drücke die Taste {{KEY|Esc}} oder die Taste {{Button|Close}}, um den aktuellen Befehl abzubrechen.
*Zu den unterstützten Schriftarten gehören TrueType (.ttf), OpenType (.otf) und Type 1 (.pfb).
</div>

==Notes==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 63: Line 66:
* Sehr kleine Texthöhen können durch Detailverlust bei der Skalierung zu verzerrten Zeichenformen führen.
* Sehr kleine Texthöhen können durch Detailverlust bei der Skalierung zu verzerrten Zeichenformen führen.
* Die aktuelle Version ist auf die von Links nach Rechts Schreiben begrenzt.
* Die aktuelle Version ist auf die von Links nach Rechts Schreiben begrenzt.
* Um kreisförmig angeordneten Text zu erstellen, verwende den {{Button|[[File:FCCircularTextButtom.png|24px]] [[Macro_Circular Text|Rundtext]]}}.
* Um kreisförmig angeordneten Text zu erstellen, verwende [[File:FCCircularTextButtom.png|24px]] [[Macro_FCCircularText/de|Macro FCCircularText]].
</div>
</div>


==Font file selection on Windows==
==Optionen==


On Windows access to the default font folder is restricted. This affects the font file selection for ShapeStrings. There are three cases in FreeCAD where a font file for ShapeStrings can be specified: in the ShapeString task panel, when changing the {{PropertyData|Font File}} property of a ShapeString, and when specifying the default font file in the [[Draft_Preferences#Texts_and_dimensions|Draft Preferences]].
* Um Koordinaten von Hand einzugeben, gib einfach die Zahlen ein und drücke dann {{KEY|Enter}} zwischen jeder X-, Y- und Z-Komponente. Du kannst den {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/de|Punkt hinzufügent]]}} drücken, wenn Du die gewünschten Werte zum Einfügen des Punktes hast.

* Drücke die Taste {{KEY|Esc}} oder die Taste {{Button|Close}}, um den aktuellen Befehl abzubrechen.
Pressing the {{Button|...}} button and then selecting a file from the default Windows font folder is not possible when using the native file dialog. There are a number of workarounds:
* Make sure {{MenuCommand|DontUseNativeFontDialog}} is set to {{True}}, which is the default value for this preference. This will only call a different, non-native, file dialog when pressing the {{Button|...}} button in the ShapeString task panel. With this file dialog the default Windows font folder can be accessed.
* Change {{MenuCommand|DontUseNativeDialog}} to {{True}}. This instructs FreeCAD to always use the non-native file dialog.
* Specify the font file in the input box. You can of course type the full path or copy-paste the path from the Windows File Explorer. But there is also another way to enter the path. If you enter {{Value|C:\}} a dropdown list will appear. Select {{Value|Windows}} from that list and add {{Value|\F}}. Select {{Value|Fonts}} from the new dropdown list. Finally add {{Value|\}} and the first letter(s) of the font file, and then select it from the dropdown list.
* Create a custom folder for your font files.

See the [[#Preferences|Preferences]] paragraph below for the location of the mentioned preferences.

==Tutorien==

* [[Draft_ShapeString_tutorial/de|Entwurf FormFolge Tutorium]]: einen ShapeString extrudieren, im 3D Raum positionieren und eine Gravur in einem anderen Körper erzeugen.
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623 Anwenden von Formfolgen in PartDesign]

==Preferences==

See also: [[Preferences_Editor|Preferences Editor]], [[Draft_Preferences|Draft Preferences]] and [[Std_DlgParameter|Std DlgParameter]].

* The default font file can be changed in the preferences: {{MenuCommand|Edit → Preferences... → Draft → Texts and dimensions → Default ShapeString font file}}.
* For Windows users:
** Set {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog}} to {{True}} to use the non-native file dialog when selecting a font file from the ShapeString task panel.
** Alternatively, set {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Dialog → DontUseNativeDialog}} to {{True}} to always use the non-native file dialog.


==Eigenschaften==
==Eigenschaften==

See also: [[Property_editor|Property editor]].

A Draft ShapeString object is derived from a [[Part_Part2DObject|Part Part2DObject]] and inherits all its properties. It also has the following additional properties:

===Data===

{{TitleProperty|Draft}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 82: Line 114:
* {{PropertyData/de|Schriftartdatei}}: gibt den vollständigen Pfad der Schriftdatei an, die zum Zeichnen der Zeichenkette verwendet wird.
* {{PropertyData/de|Schriftartdatei}}: gibt den vollständigen Pfad der Schriftdatei an, die zum Zeichnen der Zeichenkette verwendet wird.
</div>
</div>

===View===

{{TitleProperty|Draft}}

* {{PropertyView|Pattern|Enumeration}}: specifies the [[Draft_Pattern|Draft Pattern]] with which to fill the faces of the text. This property only works if {{PropertyView|Display Mode}} is {{value|Flat Lines}}.
* {{PropertyView|Pattern Size|Float}}: specifies the size of the [[Draft_Pattern|Draft Pattern]].

==Scripting==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 88: Line 129:
</div>
</div>


<div class="mw-translate-fuzzy">
Das FormFolge Werkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus mit der folgenden Funktion benutzt werden:
Das FormFolge Werkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus mit der folgenden Funktion benutzt werden:
</div>

{{Code|code=
{{Code|code=
ShapeString = makeShapeString(String, FontFile, Size=100, Tracking=0)
shapestring = make_shapestring(String, FontFile, Size=100, Tracking=0)
}}
}}


<div class="mw-translate-fuzzy">
* Erzeugt eine {{incode/de|Formfolge}} verbundene Form unter Verwendung der angegebenen {{incode/de|Folge}} und des vollständigen Pfades einer unterstützten {{incode/de|Schriftartdatei}}.
* Erzeugt eine {{incode|Formfolge}} verbundene Form unter Verwendung der angegebenen {{incode|Folge}} und des vollständigen Pfades einer unterstützten {{incode|Schriftartdatei}}.
* {{incode/de|Größe}} ist die Höhe des resultierenden Textes in Millimetern.
* {{incode/de|Laufweite}} ist der zusätzliche Zeichenabstand in Millimetern.
* {{incode|Größe}} ist die Höhe des resultierenden Textes in Millimetern.
* {{incode|Laufweite}} ist der zusätzliche Zeichenabstand in Millimetern.
</div>


Die Platzierung der FormFolge kann durch Überschreiben seines {{incode|Placement}} Attributs oder durch individuelles Überschreiben seiner {{incode|Placement.Base}} und {{incode|Placement.Rotation}} Attribute geändert werden.
Die Platzierung der FormFolge kann durch Überschreiben seines {{incode|Placement}} Attributs oder durch individuelles Überschreiben seiner {{incode|Placement.Base}} und {{incode|Placement.Rotation}} Attribute geändert werden.


Beispiel:
Beispiel:

{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
Line 110: Line 157:
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"


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


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


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


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


doc.recompute()
doc.recompute()
}}
}}


==Tutorien==

* [[Draft_ShapeString_tutorial/de|Entwurf FormFolge Tutorium]]: einen ShapeString extrudieren, im 3D Raum positionieren und eine Gravur in einem anderen Körper erzeugen.
* [https://forum.freecadweb.org/viewtopic.php?f=3&t=36623 Anwenden von Formfolgen in PartDesign]

==Anmerkungen==

* Viele Schriften werden problematische Geometrie erzeugen. Das liegt daran, dass sich die Konturen der Schriften überlappen dürfen, kleine Lücken haben und innerhalb eines Glyphen unterschiedliche Richtungen haben. Diese Bedingungen gelten als Fehler in den Drähten, die zur Definition von Faces verwendet werden. Optionen sind die Korrektur der Schriftdefinition mit einem Werkzeug wie FontForge oder die Verwendung einer anderen Schriftart.


<div class="mw-translate-fuzzy">
{{Docnav/de
{{Docnav/de
|[[Draft_Point/de|Punkt]]
|[[Draft_Point/de|Punkt]]
|[[Draft_Facebinder/de|Flächenbinder]]
|[[Draft_Facebinder/de|Flächenbinder]]
|[[Draft_Module/de|Entwurf]]
|[[Draft_Workbench/de|Entwurf]]
|IconL=Draft_Point.svg
|IconL=Draft_Point.svg
|IconR=Draft_Facebinder.svg
|IconR=Draft_Facebinder.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
}}
}}
</div>


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

Revision as of 19:10, 24 April 2022

Entwurf FormZeichenfolge

Menüeintrag
Entwurf → Form aus Text ...
Arbeitsbereich
Entwurf, Architektur
Standardtastenkürzel
S S
Eingeführt in Version
0.14
Siehe auch
Entwurf Text, Part Extrudieren,

Makro Schriftarten Win10 PYMP


Beschreibung

Das Werkzeug Entwurf FormZeichenfolge fügt eine Verbundform ein, die eine TextZeichenfolge darstellt. Texthöhe, Laufweite und Schriftart können angegeben werden. Die resultierende Form kann mit dem Werkzeug Teil Extrusion verwendet werden, um 3D Buchstaben zu erzeugen.

Alternativ: Um ein einfacheres Textelement ohne geschlossene Form einzufügen, verwende Entwurf Text. Um eine Textbeschriftung mit einem Anfang und einem Pfeil zu erstellen, verwende Entwurf Beschriftung

Einfacher Punkt zur Positionierung des Formzeichenfolge erforderlich

Anwendung

For Windows users: please read the Font file selection on Windows paragraph first.

Wenn der Entwurf Benutzeroberflächenmodus auf Aufgabenansicht eingestellt ist:

  1. Drücke den Entwurf Formfolge oder drücke die Tasten S und dann S.
  2. Ein Dialogfeld erscheint, in dem Du deine Parameter angeben kannst.
  3. Drücke die Taste OK, um die Formfolge zu erstellen.

Optionen

  • Um Koordinaten von Hand einzugeben, gib einfach die Zahlen ein und drücke dann Enter zwischen jeder X-, Y- und Z-Komponente. Du kannst den Punkt hinzufügent drücken, wenn Du die gewünschten Werte zum Einfügen des Punktes hast.
  • Drücke die Taste Esc oder die Taste Close, um den aktuellen Befehl abzubrechen.

Notes

Begrenzungen

  • Sehr kleine Texthöhen können durch Detailverlust bei der Skalierung zu verzerrten Zeichenformen führen.
  • Die aktuelle Version ist auf die von Links nach Rechts Schreiben begrenzt.
  • Um kreisförmig angeordneten Text zu erstellen, verwende Macro FCCircularText.

Font file selection on Windows

On Windows access to the default font folder is restricted. This affects the font file selection for ShapeStrings. There are three cases in FreeCAD where a font file for ShapeStrings can be specified: in the ShapeString task panel, when changing the DatenFont File property of a ShapeString, and when specifying the default font file in the Draft Preferences.

Pressing the ... button and then selecting a file from the default Windows font folder is not possible when using the native file dialog. There are a number of workarounds:

  • Make sure DontUseNativeFontDialog is set to true, which is the default value for this preference. This will only call a different, non-native, file dialog when pressing the ... button in the ShapeString task panel. With this file dialog the default Windows font folder can be accessed.
  • Change DontUseNativeDialog to true. This instructs FreeCAD to always use the non-native file dialog.
  • Specify the font file in the input box. You can of course type the full path or copy-paste the path from the Windows File Explorer. But there is also another way to enter the path. If you enter C:\ a dropdown list will appear. Select Windows from that list and add \F. Select Fonts from the new dropdown list. Finally add \ and the first letter(s) of the font file, and then select it from the dropdown list.
  • Create a custom folder for your font files.

See the Preferences paragraph below for the location of the mentioned preferences.

Tutorien

Preferences

See also: Preferences Editor, Draft Preferences and Std DlgParameter.

  • The default font file can be changed in the preferences: Edit → Preferences... → Draft → Texts and dimensions → Default ShapeString font file.
  • For Windows users:
    • Set Tools → Edit parameters... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog to true to use the non-native file dialog when selecting a font file from the ShapeString task panel.
    • Alternatively, set Tools → Edit parameters... → BaseApp → Preferences → Dialog → DontUseNativeDialog to true to always use the non-native file dialog.

Eigenschaften

See also: Property editor.

A Draft ShapeString object is derived from a Part Part2DObject and inherits all its properties. It also has the following additional properties:

Data

Draft

  • Daten-EigenschaftPosition: gibt die Position des Basispunktes der verbundenen Form an.
  • Daten-EigenschaftWinkel: gibt die Rotation der Grundlinie der Form an.
  • Daten-EigenschaftAchse: gibt die Achse an, die für die Rotation verwendet werden soll.
  • Daten-EigenschaftFolge: gibt die anzuzeigende Textzeichenfolge an; im Gegensatz zum Werkzeug Entwurf Text kann das Werkzeug Entwurf FormFolge nur eine einzelne Zeile anzeigen.
  • Daten-EigenschaftGröße: gibt die allgemeine Höhe der Buchstaben an.
  • Daten-EigenschaftLaufweite: gibt den zusätzlichen Abstand zwischen den Zeichen in der Zeichenkette an.
  • Daten-EigenschaftSchriftartdatei: gibt den vollständigen Pfad der Schriftdatei an, die zum Zeichnen der Zeichenkette verwendet wird.

View

Draft

  • AnsichtPattern (Enumeration): specifies the Draft Pattern with which to fill the faces of the text. This property only works if AnsichtDisplay Mode is Flat Lines.
  • AnsichtPattern Size (Float): specifies the size of the Draft Pattern.

Scripting

Skripten

Siehe auch: Draft API und FreeCAD Skripten Grundlagen.

Das FormFolge Werkzeug kann in Makros und von der Python Konsole aus mit der folgenden Funktion benutzt werden:

shapestring = make_shapestring(String, FontFile, Size=100, Tracking=0)
  • Erzeugt eine Formfolge verbundene Form unter Verwendung der angegebenen Folge und des vollständigen Pfades einer unterstützten Schriftartdatei.
  • Größe ist die Höhe des resultierenden Textes in Millimetern.
  • Laufweite ist der zusätzliche Zeichenabstand in Millimetern.

Die Platzierung der FormFolge kann durch Überschreiben seines Placement Attributs oder durch individuelles Überschreiben seiner Placement.Base und Placement.Rotation Attribute geändert werden.

Beispiel:

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()