Draft Text/de: Difference between revisions

From FreeCAD Documentation
(Created page with "==Beschreibung==")
No edit summary
 
(34 intermediate revisions by 2 users not shown)
Line 20: Line 20:
}}
}}


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


Der Befehl [[Image:Draft_Text.svg|24px]] '''Draft Text''' erstellt einen mehrzeiligen Text an einem vorgegebenen Punkt.
<div class="mw-translate-fuzzy">
==Beschreibung====
Das Textwerkzeug fügt an einer bestimmten Stelle eine mehrzeilige Textbox ein. Es wird das [[Draft Linestyle/de|Draft Linestyle]] verwendet, das auf dem [[Draft Tray/de|Draft Tray]] eingestellt ist.
</div>


Um stattdessen ein Textelement mit einem Hinweispfeil zu erstellen, verwendet man den Befehl [[Draft_Label/de|Draft Notiz]].
<div class="mw-translate-fuzzy">
Um ein Textfeld mit einem Führungszeichen und einem Pfeil zu erstellen, verwenden Sie [[Draft Label|Draft Label]]. Um Volltext oder 3D Buchstaben zu erstellen, verwende [[Draft ShapeString/de|Draft ShapeString]] mit [[Part Extrude/de|Part Extrude]].
</div>


<div class="mw-translate-fuzzy">
[[Image:Draft_Text_example.png|400px]]
[[Image:Draft_Text_example.png|400px]]
{{Caption|Einzelner Punkt erforderlich zum Positionieren der Text-Box}}
{{Caption|Ein einzelner Punkt, den das Positionieren des Textes erfordert}}
</div>


==Usage==
<span id="Usage"></span>
==Anwendung==


See also: [[Draft_Tray|Draft Tray]] and [[Draft_Snap|Draft Snap]].
Siehe auch: [[Draft_Tray/de|Draft Fach]] and [[Draft_Snap/de|Draft Fangen]].


# Es gibt mehrere Möglichkeiten den Befehl aufzurufen:
<div class="mw-translate-fuzzy">
#* Die Schaltfläche {{Button|[[Image:Draft_Text.svg|16px]] [[Draft_Text/de|Text]]}} drücken.
==Anwendung==
#* Den Menüeintrag {{MenuCommand|Anmerkung → [[Image:Draft_Text.svg|16px]] Text}} auswählen.
# Drücke die Schaltfläche {{Button|[[Image:Draft Text.png|16px]] [[Draft Text/de|Draft Text]]}} oder drücke {{KEY|T}}, dann {{KEY|E}} Tasten.
#* Das Tastaturkürzel {{KEY|T}} dann {{KEY|E}}.
# Klicke auf einen Punkt in der 3D Ansicht oder gib eine Koordinate ein und drücke die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt hinzufügen}}.
# Der Aufgabenbereich {{MenuCommand|Text}} wird geöffnet. Siehe [[#Optionen|Optionen]] für mehr Informationen.
# Gib den gewünschten Text ein, drücke {{KEY|Enter}} zwischen jeder Zeile.
# Einen Punkt in der [[3D_view/de|3D-Ansicht]] auswählen, oder die Koordinaten eingeben und die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}} drücken.
# Drücke {{KEY|Enter}} zweimal , um den Vorgang abzuschließen.
# Den gewünschten Text eingeben, {{KEY|Enter}} drücken, um eine neue Zeile zu beginnen.
</div>
# Zweimal {{KEY|Enter}} drücken oder die Schaltfläche {{Button|[[Image:Button_valid.svg|16px]] Text erstellen}} drücken, um den Befehl abzuschließen.


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


Die im Aufgaben-Bereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe [[Draft_Preferences/de|Draft Einstellungen]]. Die hier genannten Tastaturkürzel sind die voreingestellten Tastaturkürzel (für Version 0.22).
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.


* Zum manuellen Eingeben von Koordinaten, werden die X-, Y- und Z-Komponenten jeweils mit abschließendem {{KEY|Enter}} eingegeben. Oder man drückt die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}}, sobald alle gewünschten Werte eingegeben sind. Es ist ratsam, den Mauszeiger aus der [[3D_view/de|3D-Ansicht]] heraus zu bewegen, bevor Koordinaten eingegeben werden.
<div class="mw-translate-fuzzy">
* {{KEY|G}} drücken oder die Checkbox {{MenuCommand|Global}} aktivieren, um den Global-Modus umzuschalten. Ist der Global-Modus aktiviert, beziehen sich Koordinaten auf das globale Koordinatensystem, andernfalls beziehen sie sich auf das Koordinatensystem der [[Draft_SelectPlane/de|Arbeitsebene]]. {{Version/de|0.20}}
* Um Koordinaten manuell 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ügen}} Schaltfläche drücken, wenn Du die gewünschten Werte zum Einfügen des Punktes hast.
* {{KEY|N}} drücken oder die Checkbox {{MenuCommand|Fortsetzen}} aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus aktiviert, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Texten fortzufahren. Das Tastaturkürzel funktioniert nicht im zweiten Aufgaben-Bereich. Diese Option steht in FreeCAD Version 0.19 oder davor im ersten Aufgaben-Bereich nicht zur Verfügung.
* Halte {{KEY|Ctrl}} gedrückt, während du den Text platzierst, um [[Draft_Snap/de|Fang]] deinen Punkt unabhängig von der Entfernung an die nächste Fangposition zu zwingen.
* {{KEY|S}} drücken, um [[Draft_Snap/de|Draft Einrasten]] ein- bzw. auszuschalten.
* Drücke {{KEY|Enter}} oder {{KEY|↓ Pfeil nach unten}}, um eine neue Textzeile einzugeben.
* {{KEY|Esc}} oder die Schaltfläche {{Button|Schließen}} drücken, um den Befehl abzubrechen.
* Drücke {{KEY|↑ Pfeil nach oben}}, um die vorherige Textzeile zu bearbeiten.
* Drücke zweimal {{KEY|Enter}} oder {{KEY|↓ Pfeil nach unten}}, um die Bearbeitung des Textes abzuschließen.
* Drücke {{KEY|Esc}} oder die Taste {{Button|Close}}, um den aktuellen Befehl abzubrechen.
</div>


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


* Ein Draft-Text kann durch Doppelklick in der [[Tree_view/de|Baumansicht]] zum Bearbeiten geöffnet werden. {{Version/de|0.20}}
<div class="mw-translate-fuzzy">
*Mit [[Release_notes_0.21/de|FreeCAD Version 0.21]] erstellte oder gesicherte Draft-Texte sind nicht abwärtskompatibel.
'''Warnung:''' Die mit [[Release notes 0.18 |version 0.18]] erstellten Texte sind nicht abwärtskompatibel, sichern Sie also Ihre Arbeit, wenn Sie versuchen, mit 0.18 erstellte Dateien mit älteren Versionen zu öffnen.
</div>


<span id="Properties"></span>
==Eigenschaften==
==Eigenschaften==


See also: [[Property_editor|Property editor]].
Siehe auch: [[Property_editor/de|Eigenschafteneditor]].


A Draft Text object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. The following properties are additional unless otherwise stated.
Ein Draft Text-Objekt ist von einem [[App_FeaturePython/de|App FeaturePython]]-Objekt abgeleitet und erbt alle seine Eigenschaften. Die folgenden sind, wenn nicht anders angegeben, zusätzliche Eigenschaften:


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


{{TitleProperty|Base}}
{{TitleProperty|Basis}}


* {{PropertyData/de|Placement|Placement}}: Legt die Position des Textes in der [[3D view/de|3D-Ansicht]] fest. Siehe [[Placement/de|Positionierung]].
<div class="mw-translate-fuzzy">
* {{PropertyData/de|Text|StringList}}: Legt den Inhalt des Textes fest. Jeder Eintrag in der Liste entspricht einer neuen Textzeile.
=== Daten ===
* {{PropertyData/de|Text}}: gibt den Inhalt des Textblocks als Liste von Zeichenketten an; jedes Element auf der Liste, durch ein Komma getrennt, zeigt eine neue Zeile an.
* {{PropertyData/de|Position}}: gibt den Basispunkt der ersten Zeile des Textblocks an.
* {{PropertyData/de|Winkel}}: gibt die Rotation der Grundlinie der ersten Zeile des Textblocks an.
* {{PropertyData/de|Achse}}: gibt die Achse an, die für die Rotation verwendet werden soll.
</div>


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


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


* {{PropertyView|Annotation Style|Enumeration}}: specifies the annotation style applied to the text. See [[Draft_AnnotationStyleEditor|Draft AnnotationStyleEditor]].
* {{PropertyView/de|Annotation Style|Enumeration}}: Gibt den Beschriftungsstil an, der für den Text verwewendet wird. Siehe [[Draft_AnnotationStyleEditor/de|Draft BeschriftungsstilEditor]].
* {{PropertyView|Scale Multiplier|Float}}: specifies the general scaling factor applied to the text.
* {{PropertyView/de|Scale Multiplier|Float}}: Gibt den allgemeinen Skalierungsfaktor an, der für den Text verwewendet wird.


{{TitleProperty|Display Options}}
{{TitleProperty|Display Options}}


* {{PropertyView|Display Mode|Enumeration}}: specifies how the text is displayed. If it is {{value|3D text}} the text will be displayed in a plane defined by its {{PropertyData|Placement}}. If it is {{value|2D text}} the text will always face the camera. This is an inherited property.
* {{PropertyView/de|Display Mode|Enumeration}}: Gibt an, wie der Text angezeigt wird. Ist es {{value|World}}, wird der Text auf einer Ebene angezeigt, die durch seine {{PropertyData/de|Placement}} festgelegt wird. Ist es {{value|Screen}}, wird der Text immer in Richtung Bildschirm angezeigt. Dies ist eine übernommene Eigenschaft. Die genannten Optionen sind die umbenannten Optionen ({{Version/de|0.21}}).


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


* {{PropertyView|Line Color|Color}}: not used.
* {{PropertyView/de|Line Color|Color}}: nicht verwendet.
* {{PropertyView|Line Width|Float}}: not used.
* {{PropertyView/de|Line Width|Float}}: nicht verwendet.


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


* {{PropertyView/de|Font Name|Font}}: Gibt die Schriftart an, die zum Zeichnen des Textes verwendet werden soll. Es kann ein Schriftname wie {{value|Arial}} sein, ein Standardstil wie {{value|sans}}, {{value|serif}} oder {{value|mono}}, eine Familie wie {{value|Arial,Helvetica,sans}}, oder ein Name mit einem Stil wie {{value|Arial:Bold}}. Wenn die angegebene Schriftart nicht auf dem System gefunden wird, wird stattdessen eine Standardschriftart verwendet.
<div class="mw-translate-fuzzy">
* {{PropertyView/de|Font Size|Length}}: Gibt die Höhe der Schriftzeichen an. Der Text kann unsichtbar sein in der [[3D_view|3D-Ansicht]], wenn dieser Wert sehr klein ist.
=== Ansicht ===
* {{PropertyView/de|Justification|Enumeration}}: Legt die Ausrichtung des Textes fest: {{value|Left}} (links), {{value|Center}} (zentriert) oder {{value|Right}} (rechts).
* {{PropertyView/de|Ansichtsmodus}}: wenn es sich um "3D Text" handelt, wird der Text an den Szenenachsen ausgerichtet, wobei er zunächst auf der XY Ebene liegt; wenn es sich um "2D Text" handelt, wird der Text immer der Kamera zugewandt sein.
* {{PropertyView/de|Line Spacing|Float}}: Legt den Faktor fest, der auf die voreingestellte Zeilenhöhe des Textes angewendet wird.
* {{PropertyView/de|Schriftartname}}: gibt die Schriftart an, die zum Zeichnen des Textes verwendet werden soll. Es kann ein Schriftname wie "Arial", ein Standardstil wie "sans", "serif" oder "mono", eine Familie wie "Arial, Helvetica, sans" oder ein Name mit einem Stil wie "Arial:Bold" sein. Wenn die angegebene Schriftart nicht auf dem System gefunden wird, wird stattdessen eine generische Schriftart verwendet.
* {{PropertyView/de|Text Color|Color}}: Legt die Farbe des Textes fest.
* {{PropertyView/de|Schriftgröße}}: gibt die Größe der Buchstaben an. Wenn das Textobjekt in der Baumansicht erstellt wird, aber kein Text sichtbar ist, erhöhe die Größe des Textes, bis er sichtbar ist.
* {{PropertyView/de|Ausrichtung}}: gibt an, ob der Text links, rechts oder in der Mitte des Basispunktes ausgerichtet ist.
* {{PropertyView|Zeilenabstand}}: gibt den Abstand zwischen den Textzeilen an.
</div>


==Scripting==
<span id="Scripting"></span>

<div class="mw-translate-fuzzy">
==Skripten==
==Skripten==
{{Emphasis|Siehe auch:}} [[Draft API/de|Draft API]] und [[FreeCAD Scripting Basics/de|FreeCAD Skripten Grundlagen]].
</div>


Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].
<div class="mw-translate-fuzzy">

Das Textwerkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus mit folgender Funktion verwendet werden:
Zum Erstellen eines Draft-Textes wird die Methode {{incode|make_text}} des Draft-Moduls verwendet ({{Version/de|0.19}}). Diese Methode ersetzt die veraltete Methode {{incode|makeText}}.
</div>


{{Code|code=
{{Code|code=
Line 127: Line 112:
}}
}}


* Erstellt ein {{incode|text}}-Objekt, an einer Position {{incode|placement}}, die ein {{incode|FreeCAD.Placement}} sein kann, aber auch eine {{incode|FreeCAD.Rotation}} oder ein {{incode|FreeCAD.Vector}}.
<div class="mw-translate-fuzzy">
* {{incode|string}} ist eine Zeichenkette oder eine Liste von Zeichenketten. Wenn es eine Liste ist, wird jedes Element einer auf seiner eigenen Zeile angezeigt.
* Erstellt ein {{incode|Text}} Objekt, an einem {{incode|Punkt}}, der durch einen {{incode|FreeCAD.Vector}} definiert ist.
* Wenn {{incode|screen}} auf {{incode|True}} gesetzt ist, wird der Text immer zur Kamera ausgerichtet, andernfalls wird er auf einer Ebene dargestellt, die von der {{PropertyData/de|Placement}} festgelegt wird.
* {{incode|Liste Zeichenkette}} ist eine Zeichenkette oder eine Liste von Zeichenketten; wenn es eine Liste ist, wird jedes Element in einer eigenen Zeile angezeigt.
* Wenn {{incode|screen}} {{incode|True}} ist, ist der Text immer in Blickrichtung der Kamera ausgerichtet, andernfalls richtet er sich nach den Szenenachsen aus und liegt auf der XY Ebene.
</div>


Die Ansicht-Eigenschaften von {{incode|text}} können durch Überschreiben seiner Attribute geändert werden; z.B. {{incode|ViewObject.FontSize}} (Schrifthöhe) mit einem neuen Wert in Millimetern überschreiben.
<div class="mw-translate-fuzzy">
Die Ansichtseigenschaften von {{incode|Text}} können durch Überschreiben seiner Attribute geändert werden; z.B. überschreibe {{incode|ViewObject.FontSize}} mit der neuen Größe in Millimetern.
</div>


Beispiel:
Beispiel:

Latest revision as of 13:05, 9 January 2024

Draft Text

Menüeintrag
Anmerkung → Text
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
T E
Eingeführt in Version
0.7
Siehe auch
Draft Notiz, Draft Textform

Beschreibung

Der Befehl Draft Text erstellt einen mehrzeiligen Text an einem vorgegebenen Punkt.

Um stattdessen ein Textelement mit einem Hinweispfeil zu erstellen, verwendet man den Befehl Draft Notiz.

Ein einzelner Punkt, den das Positionieren des Textes erfordert

Anwendung

Siehe auch: Draft Fach and Draft Fangen.

  1. Es gibt mehrere Möglichkeiten den Befehl aufzurufen:
    • Die Schaltfläche Text drücken.
    • Den Menüeintrag Anmerkung → Text auswählen.
    • Das Tastaturkürzel T dann E.
  2. Der Aufgabenbereich Text wird geöffnet. Siehe Optionen für mehr Informationen.
  3. Einen Punkt in der 3D-Ansicht auswählen, oder die Koordinaten eingeben und die Schaltfläche Punkt eingeben drücken.
  4. Den gewünschten Text eingeben, Enter drücken, um eine neue Zeile zu beginnen.
  5. Zweimal Enter drücken oder die Schaltfläche Text erstellen drücken, um den Befehl abzuschließen.

Optionen

Die im Aufgaben-Bereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe Draft Einstellungen. Die hier genannten Tastaturkürzel sind die voreingestellten Tastaturkürzel (für Version 0.22).

  • Zum manuellen Eingeben von Koordinaten, werden die X-, Y- und Z-Komponenten jeweils mit abschließendem Enter eingegeben. Oder man drückt die Schaltfläche Punkt eingeben, sobald alle gewünschten Werte eingegeben sind. Es ist ratsam, den Mauszeiger aus der 3D-Ansicht heraus zu bewegen, bevor Koordinaten eingegeben werden.
  • G drücken oder die Checkbox Global aktivieren, um den Global-Modus umzuschalten. Ist der Global-Modus aktiviert, beziehen sich Koordinaten auf das globale Koordinatensystem, andernfalls beziehen sie sich auf das Koordinatensystem der Arbeitsebene. eingeführt mit Version 0.20
  • N drücken oder die Checkbox Fortsetzen aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus aktiviert, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Texten fortzufahren. Das Tastaturkürzel funktioniert nicht im zweiten Aufgaben-Bereich. Diese Option steht in FreeCAD Version 0.19 oder davor im ersten Aufgaben-Bereich nicht zur Verfügung.
  • S drücken, um Draft Einrasten ein- bzw. auszuschalten.
  • Esc oder die Schaltfläche Schließen drücken, um den Befehl abzubrechen.

Hinweise

Eigenschaften

Siehe auch: Eigenschafteneditor.

Ein Draft Text-Objekt ist von einem App FeaturePython-Objekt abgeleitet und erbt alle seine Eigenschaften. Die folgenden sind, wenn nicht anders angegeben, zusätzliche Eigenschaften:

Daten

Basis

  • Daten-EigenschaftPlacement (Placement): Legt die Position des Textes in der 3D-Ansicht fest. Siehe Positionierung.
  • Daten-EigenschaftText (StringList): Legt den Inhalt des Textes fest. Jeder Eintrag in der Liste entspricht einer neuen Textzeile.

Ansicht

Annotation

  • Ansicht-EigenschaftAnnotation Style (Enumeration): Gibt den Beschriftungsstil an, der für den Text verwewendet wird. Siehe Draft BeschriftungsstilEditor.
  • Ansicht-EigenschaftScale Multiplier (Float): Gibt den allgemeinen Skalierungsfaktor an, der für den Text verwewendet wird.

Display Options

  • Ansicht-EigenschaftDisplay Mode (Enumeration): Gibt an, wie der Text angezeigt wird. Ist es World, wird der Text auf einer Ebene angezeigt, die durch seine Daten-EigenschaftPlacement festgelegt wird. Ist es Screen, wird der Text immer in Richtung Bildschirm angezeigt. Dies ist eine übernommene Eigenschaft. Die genannten Optionen sind die umbenannten Optionen (eingeführt mit Version 0.21).

Graphics

  • Ansicht-EigenschaftLine Color (Color): nicht verwendet.
  • Ansicht-EigenschaftLine Width (Float): nicht verwendet.

Text

  • Ansicht-EigenschaftFont Name (Font): Gibt die Schriftart an, die zum Zeichnen des Textes verwendet werden soll. Es kann ein Schriftname wie Arial sein, ein Standardstil wie sans, serif oder mono, eine Familie wie Arial,Helvetica,sans, oder ein Name mit einem Stil wie Arial:Bold. Wenn die angegebene Schriftart nicht auf dem System gefunden wird, wird stattdessen eine Standardschriftart verwendet.
  • Ansicht-EigenschaftFont Size (Length): Gibt die Höhe der Schriftzeichen an. Der Text kann unsichtbar sein in der 3D-Ansicht, wenn dieser Wert sehr klein ist.
  • Ansicht-EigenschaftJustification (Enumeration): Legt die Ausrichtung des Textes fest: Left (links), Center (zentriert) oder Right (rechts).
  • Ansicht-EigenschaftLine Spacing (Float): Legt den Faktor fest, der auf die voreingestellte Zeilenhöhe des Textes angewendet wird.
  • Ansicht-EigenschaftText Color (Color): Legt die Farbe des Textes fest.

Skripten

Siehe auch: Autogenerated API documentation und FreeCAD Grundlagen Skripten.

Zum Erstellen eines Draft-Textes wird die Methode make_text des Draft-Moduls verwendet (eingeführt mit Version 0.19). Diese Methode ersetzt die veraltete Methode makeText.

text = make_text(string, placement=None, screen=False)
  • Erstellt ein text-Objekt, an einer Position placement, die ein FreeCAD.Placement sein kann, aber auch eine FreeCAD.Rotation oder ein FreeCAD.Vector.
  • string ist eine Zeichenkette oder eine Liste von Zeichenketten. Wenn es eine Liste ist, wird jedes Element einer auf seiner eigenen Zeile angezeigt.
  • Wenn screen auf True gesetzt ist, wird der Text immer zur Kamera ausgerichtet, andernfalls wird er auf einer Ebene dargestellt, die von der Daten-EigenschaftPlacement festgelegt wird.

Die Ansicht-Eigenschaften von text können durch Überschreiben seiner Attribute geändert werden; z.B. ViewObject.FontSize (Schrifthöhe) mit einem neuen Wert in Millimetern überschreiben.

Beispiel:

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