DotPath()

Syntax

DotPath(Width.d, Distance.d [, Flags [, StartOffset.d]])
Description
Draw the current drawing path as a line of dots.

By default, the path is reset after calling this function. This can be prevented with the appropriate flags.

Parameters

Width.d Specifies the width for the dotted line.
Distance.d Specifies the distance between the center of each dot.
Flags (optional) Specifies optional characteristics for the drawn dots. This can be a combination of the following values:
  #PB_Path_Default     : No special behavior (default value)
  #PB_Path_Preserve    : Don't reset the path after this function
  #PB_Path_RoundEnd    : Draw the dots round
  #PB_Path_SquareEnd   : Draw the dots as squares
StartOffset.d (optional) Specifies the distance to skip within the dot pattern before starting to draw the path. The default value is 0.

Return value

None.

Example

  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))
      DotPath(5, 10, #PB_Path_RoundEnd)
    
      StopVectorDrawing()
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

See Also

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

Supported OS

All

<- DashPath() - VectorDrawing Index - DrawVectorImage() ->