Draft Text

From FreeCAD Documentation
Revision as of 09:15, 4 November 2023 by FBXL5 (talk | contribs)

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 Draft 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 Aufgabenbereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe Draft Einstellungen. Die hier genannten Tastenkürzel sind die voreingestellten Tastenkürzel.

  • Zum manuellen Eingeben von Koordinaten werden die X-, Y- und Z-Komponenten eingegeben und jeweils anschließend Enter gedrückt oder es wird die Schaltfläche Punkt eingeben gedrückt, sobald die gewünschten Werte erreicht sind. Es ist ratsam, den Mauszeiger aus dem 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 eingeschaltet, werden Koordinaten relativ zum globalen Koordinatensystem angegeben, andernfalls zum Koordinatensystem der Arbeitsebene. eingeführt mit Version 0.20
  • T drücken oder die Checkbox Fortsetzen aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus eingeschaltet, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Texten weiterzumachen. 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 drücken 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

  • Daten-EigenschaftText: gibt den Inhalt des Textblocks als Liste von Zeichenketten an; jedes Element auf der Liste, durch ein Komma getrennt, zeigt eine neue Zeile an.
  • Daten-EigenschaftPosition: gibt den Basispunkt der ersten Zeile des Textblocks an.
  • Daten-EigenschaftWinkel: gibt die Rotation der Grundlinie der ersten Zeile des Textblocks an.
  • Daten-EigenschaftAchse: gibt die Achse an, die für die Rotation verwendet werden soll.

Ansicht

Annotation

  • AnsichtAnnotation Style (Enumeration): specifies the annotation style applied to the text. See Draft AnnotationStyleEditor.
  • AnsichtScale Multiplier (Float): specifies the general scaling factor applied to the text.

Display Options

  • AnsichtDisplay Mode (Enumeration): specifies how the text is displayed. If it is World the text will be displayed on a plane defined by its DatenPlacement. If it is Screen the text will always face the screen. This is an inherited property. The mentioned options are the renamed options (introduced in version 0.21).

Graphics

  • AnsichtLine Color (Color): not used.
  • AnsichtLine Width (Float): not used.

Text

Ansicht

  • Ansicht-EigenschaftAnsichtsmodus: 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.
  • Ansicht-EigenschaftSchriftartname: 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.
  • Ansicht-EigenschaftSchriftgröß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.
  • Ansicht-EigenschaftAusrichtung: gibt an, ob der Text links, rechts oder in der Mitte des Basispunktes ausgerichtet ist.
  • AnsichtZeilenabstand: gibt den Abstand zwischen den Textzeilen an.

Skripten

Siehe auch: Autogenerated API documentation und FreeCAD Grundlagen Skripten.

Das Textwerkzeug kann in Makros und von der Python Konsole aus mit folgender Funktion verwendet werden:

text = make_text(string, placement=None, screen=False)
  • Erstellt ein Text Objekt, an einem Punkt, der durch einen FreeCAD.Vector definiert ist.
  • Liste Zeichenkette ist eine Zeichenkette oder eine Liste von Zeichenketten; wenn es eine Liste ist, wird jedes Element in einer eigenen Zeile angezeigt.
  • Wenn screen 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.

Die Ansichtseigenschaften von Text können durch Überschreiben seiner Attribute geändert werden; z.B. überschreibe ViewObject.FontSize mit der neuen Größe in Millimetern.

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