AddTextToPath(id, t$[, table])
t$
als Vektorgrafik dem aktuellen
Pfad hinzu. Aus diesem Grund wird dieser Befehl nur dann funktionieren,
wenn ein Vektorfont (zum Beispiel eine TrueType-Schriftart)
gerade aktiv ist. Mit Bitmap-Schriften kann dieser Befehl nicht
arbeiten. AddTextToPath()
wird die aktive Schriftart verwenden,
die von dem letzten Aufruf von SetFont() oder UseFont() gesetzt
wurde.
Bitte beachten Sie, dass AddTextToPath()
den Text über den
aktuellen y-Punkt hinzufügt. Wenn also der aktuelle y-Pfadpunkt
240 ist und Sie den Text, der 36 Pixel hoch ist hinzufügen,
wird der Text an einer y-Position von 204 (240-36 = 204)
anstelle von 240 (wie der aktuelle y-Pfadpunkt) plaziert
werden.
Bitte beachten Sie, dass derzeit einige Einschränkungen gelten:
AddTextToPath()
verwendet, muss
mit #FONTENGINE_INBUILT
geöffnet worden sein. Schriften, die
hingegen mit #FONTENGINE_NATIVE
geöffnet wurden, funktionieren
zur Zeit nicht. Die eingebauten Standardschriftarten #SANS
,
#SERIF
und #MONOSPACE
arbeiten gut mit AddTextToPath()
.
AddTextToPath()
ignoriert. Wenn Sie kursiven oder fetten
Text möchten, müssen Sie eine separate Schrift öffnen, die
fett und/oder kursiv gedruckten Vektorgrafiken bereits in ihren
Daten hat. Der einfache Aufruf von SetFontStyle()
funktioniert nicht mit Vektortext.
AddTextToPath()
ignoriert. Es ist derzeit
nicht möglich, Formatierungs-Tags mit diesem Befehl zu verwenden.
Mit dem optionalen Argument table
können Sie weitere Optionen festlegen:
Encoding:
t$
anzugeben. Voreingestellt ist die Standardcodierung
für die Textbibliothek, welche mit dem Befehl SetDefaultEncoding()
festgelegt ist. Siehe SetDefaultEncoding für Details.
EnableLayers SetFillStyle(#FILLCOLOR) SetFormStyle(#ANTIALIAS) SetFont("Arial", 100, {Engine = #FONTENGINE_INBUILT}) StartPath(1) MoveTo(1, 0, 0) AddTextToPath(1, "Hello World") DrawPath(1, #CENTER, #CENTER + 100, #BLUE, {AnchorX = 0.5, AnchorY = 0.5, Rotate = 45})Der obige Code erzeugt einen Vektorpfad, der den Text "Hello World" enthält. Der Pfad wird dann um 45 Grad gedreht.