Inheritance #

BackBufferCopy
Table of contents

BackBufferCopy #

is_instantiable, Node2D, Node, core, not_builtin_classes

A node that copies a region of the screen to a buffer for access in shader code.

Node for back-buffering the currently-displayed screen. The region defined in the BackBufferCopy node is buffered with the content of the screen it covers, or the entire screen according to the copy_mode. It can be accessed in shader scripts using the screen texture (i.e. a uniform sampler with hint_screen_texture).

Note: Since this node inherits from Node2D (and not Control), anchors and margins won't apply to child Control-derived nodes. This can be problematic when resizing the window. To avoid this, add Control-derived nodes as siblings to the BackBufferCopy node instead of adding them as children.

Members #

var copy_mode = COPY_MODE_RECT#

Buffer mode. See CopyMode constants.

var rect: Rect2 = Rect2(-100, -100, 200, 200)#

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

Methods #

Annotations #

Constants #

const COPY_MODE_DISABLED = 0 enum CopyMode#

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

const COPY_MODE_RECT = 1 enum CopyMode#

BackBufferCopy buffers a rectangular region.

const COPY_MODE_VIEWPORT = 2 enum CopyMode#

BackBufferCopy buffers the entire screen.

Constructors #

Enums #

CopyMode#

enum CopyMode { COPY_MODE_DISABLED = 0, COPY_MODE_RECT = 1, COPY_MODE_VIEWPORT = 2, }

Operators #

Signals #

Theme Items #

Tutorials #