ClipOutput()

Синтаксис

ClipOutput(x , y , Width , Height)

Описание

Ограничивает область вывода графики на текущей поверхности заданным прямоугольником. Любые пиксели за пределами этого прямоугольника будут отсекаться.

Параметры

x, y, Width, Height

Местоположение и размер отсекающего прямоугольника. (x, y) координаты всегда абсолютные и не изменяются с вызовами функции SetOrigin().

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

Ничего.

Комментарии

Эта команда имеет эффект только при выводе графики на ImageOutput() или CanvasOutput().

Вызов этой функции не изменяет исходный рисунок. Чтобы вывести весь рисунок относительно левого верхнего угла отсекающего прямоугольника, должен быть выполнен вызов функции SetOrigin(), если это необходимо.

Команды Plot() и Point() не выполняют проверки границ по причинам снижения производительности и поэтому также игнорируются этой командой.

Пример

If OpenWindow(0, 0, 0, 200, 200, "2DDrawing Example", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateImage(0, 200, 200, 24, $FFFFFF) And StartDrawing(ImageOutput(0))

        ClipOutput(50, 50, 100, 100) ; Ограничить команды рисования этим регионом.
        Circle(50, 50, 50, $0000FF)
        Circle(50, 150, 50, $00FF00)
        Circle(150, 50, 50, $FF0000)
        Circle(150, 150, 50, $00FFFF)

        DrawingMode(#PB_2DDrawing_Outlined)
        Box(50, 50, 100, 100, $000000)

        StopDrawing()
        ImageGadget(0, 0, 0, 200, 200, ImageID(0))
    EndIf

    Repeat
        Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
EndIf

См. также

UnclipOutput(), SetOrigin(), OutputWidth(), OutputHeight()

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

Все