CustomDashPath()

Syntax

CustomDashPath(Breite.d, Array.d() [, Flags [, StartOffset.d]])

Zeichnet den aktuellen Zeichenpfad mit einem benutzerdefinierten Strichmuster (englisch "dashing pattern").

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.
Array.d()	Spezifiert die Länge jedes Striches und jedes Abstands zum nächsten Strich. Das Array muss eine gerade Anzahl an Einträgen haben. Wenn die Zeichenoperation das Ende des Arrays erreicht, wird das Muster wiederholt. Eine Strichlänge von 0 wird einen einfachen Punkt zeichnen.
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))
      
      Dim dashes.d(7)
      dashes(0) = 20
      dashes(1) = 10
      dashes(2) = 0 ; draw a dot
      dashes(3) = 10
      dashes(4) = 0
      dashes(5) = 10
      dashes(6) = 20
      dashes(7) = 10
      CustomDashPath(5, dashes())
    
      StopVectorDrawing()
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

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

Unterstützte OS

Alle