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

Hereda: Node2D < CanvasItem < Node < Object

Un nodo que copia una región de la pantalla a un búfer para acceder a ella desde código de shader.

Descripción

Nodo para realizar un "back-buffering" de la pantalla que se muestra actualmente. La región definida en el nodo BackBufferCopy se almacena en un búfer con el contenido de la zona de la pantalla que cubre, o de toda la pantalla según el copy_mode. Se puede acceder a este contenido en scripts de sombreado (shaders) utilizando la textura de pantalla (es decir, un uniform sampler con hint_screen_texture).

Nota: Dado que este nodo hereda de Node2D (y no de Control), las anclas (anchors) y márgenes no se aplicarán a los nodos hijos derivados de Control. Esto puede ser problemático al cambiar el tamaño de la ventana. Para evitarlo, añade los nodos derivados de Control como hermanos del nodo BackBufferCopy en lugar de añadirlos como hijos.

Tutoriales

Shaders de lectura de pantalla

Propiedades

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

Enumeraciones

enum CopyMode: 🔗

CopyMode COPY_MODE_DISABLED = 0

Disables the buffering mode. This means the BackBufferCopy node will directly use the portion of screen it covers.

CopyMode COPY_MODE_RECT = 1

BackBufferCopy almacena una región rectangular.

CopyMode COPY_MODE_VIEWPORT = 2

BackBufferCopy almacena toda la pantalla.

Descripciones de Propiedades

CopyMode copy_mode = 1 🔗

void set_copy_mode(value: CopyMode)
CopyMode get_copy_mode()

Modo de búfer.

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

void set_rect(value: Rect2)
Rect2 get_rect()

The area covered by the BackBufferCopy. Only used if copy_mode is COPY_MODE_RECT.