PureBasic

DashPath()

Синтаксис

DashPath(Width.d , Length.d [, Flags [, StartOffset.d]])

Описание


Обводит текущий Векторный контур Штриховым пунктиром, в виде множества тире равной длины и равными промежутками между ними.

По умолчанию, после вызова этой функции, текущий Векторный контур будет сброшен. Это поведение можно изменить с помощью соответствующих флагов.

Параметры

Width.d Определяет ширину Штрихового пунктира. Это значение не включает круглые / квадратные наконечники штрихов.
Length.d Определяет длину каждого штриха (тире), и расстояния между ними.
Flags (дополн.) Определяет дополнительные характеристики для отрисовки штрихов (тире). Это может быть комбинацией следующих значений: 
  #PB_Path_Default       : Без специальных опций (по умолчанию).
  #PB_Path_Preserve      : Не сбрасывать текущий Векторный контур после вызова этой функции.
  #PB_Path_RoundEnd      : Рисует штрихи (тире) с закруглёнными наконечниками.
  #PB_Path_SquareEnd     : Рисует штрихи (тире) с квадратными наконечниками.
  #PB_Path_RoundCorner   : Рисует штрихи (тире) с закругленными углами.
  #PB_Path_DiagonalCorner: Рисует штрихи (тире) с углами срезанными под 45 гр.
StartOffset.d (дополн.) Задаёт Номер пикселя пунктирного узора, с которого начнётся его использование. Отсчёт идёт от 0. Значение по умолчанию 0.

Возвращаемое значение

Ничего.

Пример

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

См. также

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

Поддерживаемые OS

Все

<- CustomDashPath() - Оглавление VectorDrawing - DotPath()->