Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

BackBufferCopy

Наследует: Node2D < CanvasItem < Node < Object

Узел, который копирует область экрана в буфер для доступа в коде шейдера.

Описание

Узел для буферизации текущего отображаемого экрана. Регион, определенный в узле BackBufferCopy, буферизуется содержимым экрана, который он покрывает, или всем экраном в соответствии с copy_mode. К нему можно получить доступ в скриптах шейдера с помощью текстуры экрана (т. е. однородного сэмплера с hint_screen_texture).

Примечание: Поскольку этот узел наследуется от Node2D (а не от Control), якоря и поля не будут применяться к дочерним узлам, производным от Control. Это может быть проблематично при изменении размера окна. Чтобы избежать этого, добавьте узлы, производные от Control, как родственные узлы в узел BackBufferCopy вместо того, чтобы добавлять их как дочерние.

Обучающие материалы

Шейдеры чтения экрана

Свойства

CopyMode	copy_mode	`1`
Rect2	rect	`Rect2(-100, -100, 200, 200)`

Перечисления

enum CopyMode: 🔗

CopyMode COPY_MODE_DISABLED = 0

Отключает режим буферизации. Это означает, что узел BackBufferCopy будет напрямую использовать часть экрана, которую он покрывает.

CopyMode COPY_MODE_RECT = 1

BackBufferCopy буферизует прямоугольную область.

CopyMode COPY_MODE_VIEWPORT = 2

BackBufferCopy буферизует весь экран.

Описания свойств

CopyMode copy_mode = 1 🔗

void set_copy_mode(value: CopyMode)
CopyMode get_copy_mode()

Режим буфера.

Rect2 rect = Rect2(-100, -100, 200, 200) 🔗

void set_rect(value: Rect2)
Rect2 get_rect()

Область, охватываемая BackBufferCopy. Используется только если copy_mode равен COPY_MODE_RECT.