PureBasic

CanvasOutput()

Синтаксис

OutputID = CanvasOutput(#Gadget)

Описание


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

Параметры

#Gadget Номер, идентифицирующий указанный CanvasGadget().

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

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

Пример

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

Комментарии

CanvasGadget() не имеет альфа-канала, поэтому режимы #PB_2DDrawing_AlphaChannel функции DrawingMode() не будут действовать, а режим #PB_2DDrawing_AllChannels будет эквивалентен #PB_2DDrawing_Default.

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

См. также

StartDrawing(), CanvasGadget(), CanvasVectorOutput()

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

Все

<- CanvasGadget() - Оглавление Gadget - CanvasVectorOutput()->