DashPath()

Syntax

DashPath(Breite.d, Länge.d [, Flags [, StartOffset.d]])

Zeichnet den aktuellen Zeichenpfad als eine Reihe von Strichen (englisch "dashes") gleicher Länge und Abstands.

Standardmäßig wird der Pfad nach dem Aufruf dieser Funktion zurückgesetzt. Dies kann durch entsprechende Flags verhindert werden.

Parameter

Breite.d	Gibt die Breite der gestrichelten Linie an. Dieser Wert schließt keine runden/eckigen Linienenden ein.
Länge.d	Gibt die Länge jedes Strichs an (und des Abstands zwischen den Strichen).
Flags (optional)	Gibt optionale Eigenschaften für die gezeichneten Striche an. Dies kann eine Kombination der folgenden Werte sein: #PB_Path_Default : Kein spezielles Verhalten (Standardwert) #PB_Path_Preserve : Den Pfad nach dieser Funktion nicht zurücksetzen #PB_Path_RoundEnd : Zeichne die Striche mit abgerundeten Enden #PB_Path_SquareEnd : Zeichne die Striche mit eckigen Kästen an den Enden #PB_Path_RoundCorner : Zeichne die Striche mit abgerundeten Ecken #PB_Path_DiagonalCorner: Zeichne die Striche mit diagonal abgeschrägten Ecken
StartOffset.d (optional)	Gibt den innerhalb des Strichmusters zu überspringenden Abstand an, bevor der Pfad gezeichnet wird. Der Standardwert ist 0.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

  If OpenWindow(0, 0, 0, 400, 200, "VectorDrawing", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CanvasGadget(0, 0, 0, 400, 200)

    If StartVectorDrawing(CanvasVectorOutput(0))
    
      MovePathCursor(40, 20)
      For i = 1 To 4
        AddPathLine(80, 0, #PB_Path_Relative)
        AddPathLine(0, 40, #PB_Path_Relative)
      Next i
      
      VectorSourceColor(RGBA(255, 0, 0, 255))
      DashPath(5, 15)
    
      StopVectorDrawing()
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

FillPath(), StrokePath(), DotPath(), CustomDashPath(), IsInsideStroke(), ResetPath()

Unterstützte OS

Alle