PureBasic

CanvasVectorOutput()

Синтаксис

VectorOutputID = CanvasVectorOutput(#Gadget [, Unit])

Описание


Возвращает идентификатор вывода 'OutputID' указанного CanvasGadget. Полученный OutputID используется для вывода Векторной графики на данный CanvasGadget.

Параметры

#Gadget Номер (внутренний для Purebasic), идентифицирующий указанный CanvasGadget().
Unit (дополн.) Определяет единицу измерения, используемую для измерения расстояний на рисунке. Единицей измерения по умолчанию для CanvasGadget является - #PB_Unit_Pixel (пиксель).
  #PB_Unit_Pixel     : Значения измеряются в пикселях (или точках в случае принтера)
  #PB_Unit_Point     : Значения измеряются в точках (1/72 дюйма)
  #PB_Unit_Inch      : Значения измеряются в дюймах (25,4 миллиметров)
  #PB_Unit_Millimeter: Значения измеряются в миллиметрах (0,039 370 дюйма)

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

Возвращает идентификатор 'OutputID' или ноль, если вывод Векторной графики не возможен. Это значение должно быть передано непосредственно в функцию StartVectorDrawing(), чтобы начать операцию рисования. После вызова функции StopVectorDrawing(), текущий OutputID становится недействительным, поэтому каждый последующий запуск функции StartVectorDrawing() требует нового вызова CanvasVectorOutput().

Пример

...
StartVectorDrawing(CanvasVectorOutput(#Gadget))
; Здесь должны быть операции рисования...
StopVectorDrawing()

Комментарии

Рисование на CanvasGadget() выполняется с двойной буферизацией. Это означает, что результат операций рисования становится видимым только при выполнении команды StopVectorDrawing(), чтобы избежать видимого мерцания во время рисования.

См. также

StartVectorDrawing(), CanvasGadget(), CanvasOutput()

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

Все

<- CanvasOutput() - Оглавление Gadget - ChangeListIconGadgetDisplay()->