|
Menüeintrag |
---|
Anmerkung → Text |
Arbeitsbereich |
Draft, BIM |
Standardtastenkürzel |
T E |
Eingeführt in Version |
0.7 |
Siehe auch |
Draft Notiz, Draft Textform |
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
Siehe auch: Draft Fach and Draft Fangen.
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 1.0).
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:
Basis
Placement
): Legt die Position des Textes in der 3D-Ansicht fest. Siehe Positionierung.StringList
): Legt den Inhalt des Textes fest. Jeder Eintrag in der Liste entspricht einer neuen Textzeile.
Annotation
Enumeration
): Gibt den Beschriftungsstil an, der für den Text verwewendet wird. Siehe Draft BeschriftungsstilEditor.Float
): Gibt den allgemeinen Skalierungsfaktor an, der für den Text verwewendet wird.Display Options
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
Color
): nicht verwendet.Float
): nicht verwendet.Text
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.Length
): Gibt die Höhe der Schriftzeichen an. Der Text kann unsichtbar sein in der 3D-Ansicht, wenn dieser Wert sehr klein ist.Enumeration
): Legt die Ausrichtung des Textes fest: Left
(links), Center
(zentriert) oder Right
(rechts).Float
): Legt den Faktor fest, der auf die voreingestellte Zeilenhöhe des Textes angewendet wird.Color
): Legt die Farbe des Textes fest.
Siehe auch: Autogenerierte API-Dokumentation und Grundlagen der Skripterstellung in FreeCAD.
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)
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.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()