AddPathText()

Syntax

AddPathText(Text$)

Fügt die Umrisse der Zeichen im angegebenen Text an der aktuellen Cursorposition in den Vektorzeichnen-Pfad ein. Die aktuelle Position kann mit MovePathCursor() eingestellt werden. Nach dem Aufruf dieser Funktion wird der Cursor an das Ende des hinzugefügten Textes verschoben.

Sofern möglich, sollte die DrawVectorText() Funktion bevorzugt werden. Siehe die folgenden Anmerkungen für weitere Details.

Parameter

Text$

Gibt den zum Zeichenpfad hinzuzufügenden Text (einzeilig) an.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Das Konvertieren von Text in einen Pfad ist ein aufwändiger Vorgang und kann zu einem Verlust an Textqualität und sogar zu einer etwas anderen Textform (je nach Schriftart) führen - im Vergleich zum direkten Zeichnen des Textes auf die Ausgabe mittels DrawVectorText(). Die DrawVectorText() Funktion ist effizienter und kann Methoden wie "Subpixel-Rendering" verwenden, um die Textqualität zu verbessern. Daher sollte die AddPathText() Funktion nur dann verwendet werden, wenn der Text ausdrücklich als ein Pfad benötigt wird und nicht nur für eine einfache Textzeichnung.

Beispiel

  If OpenWindow(0, 0, 0, 400, 200, "VectorDrawing", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CanvasGadget(0, 0, 0, 400, 200)
    LoadFont(0, "Times New Roman", 20, #PB_Font_Bold)

    If StartVectorDrawing(CanvasVectorOutput(0))
      VectorFont(FontID(0), 150)
      
      MovePathCursor(50, 25)
      AddPathText("Text")
      
      VectorSourceColor(RGBA(255, 0, 0, 255))
      DashPath(3, 6)
    
      StopVectorDrawing()
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

DrawVectorText(), DrawVectorParagraph(), VectorTextWidth(), VectorTextHeight()

Unterstützte OS

Alle