.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the BackBufferCopy.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_BackBufferCopy:

BackBufferCopy
==============

**Inherits:** :ref:`Node2D<class_node2d>` **<** :ref:`CanvasItem<class_canvasitem>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`

**Category:** Core

Brief Description
-----------------

Copies a region of the screen (or the whole screen) to a buffer so it can be accessed with the texscreen() shader instruction.

Member Functions
----------------

+----------------------------+--------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`      | :ref:`get_copy_mode<class_BackBufferCopy_get_copy_mode>`  **(** **)** const                            |
+----------------------------+--------------------------------------------------------------------------------------------------------+
| :ref:`Rect2<class_rect2>`  | :ref:`get_rect<class_BackBufferCopy_get_rect>`  **(** **)** const                                      |
+----------------------------+--------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_copy_mode<class_BackBufferCopy_set_copy_mode>`  **(** :ref:`int<class_int>` copy_mode  **)** |
+----------------------------+--------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_rect<class_BackBufferCopy_set_rect>`  **(** :ref:`Rect2<class_rect2>` rect  **)**            |
+----------------------------+--------------------------------------------------------------------------------------------------------+

Member Variables
----------------

- :ref:`int<class_int>` **copy_mode** - Buffer mode. See [code]COPY_MODE_*[/code] constants.
- :ref:`Rect2<class_rect2>` **rect** - The area covered by the BackBufferCopy. Only used if [code]copy_mode[/code] is [code]COPY_MODE_RECT[/code].

Numeric Constants
-----------------

- **COPY_MODE_DISABLED** = **0** --- Disables the buffering mode. This means the BackBufferCopy node will directly use the portion of screen it covers.
- **COPY_MODE_RECT** = **1** --- BackBufferCopy buffers a rectangular region.
- **COPY_MODE_VIEWPORT** = **2** --- BackBufferCopy buffers the entire screen.

Description
-----------

Node for back-buffering the currently displayed screen. The region defined in the BackBufferCopy node is bufferized with the content of the screen it covers, or the entire screen according to the copy mode set. Accessing this buffer is done with the texscreen() shader instruction.

Member Function Description
---------------------------

.. _class_BackBufferCopy_get_copy_mode:

- :ref:`int<class_int>`  **get_copy_mode**  **(** **)** const

Return the copy mode currently applied to the BackBufferCopy. See ``COPY_MODE\_\*`` constants.

.. _class_BackBufferCopy_get_rect:

- :ref:`Rect2<class_rect2>`  **get_rect**  **(** **)** const

Return the area covered by the BackBufferCopy.

.. _class_BackBufferCopy_set_copy_mode:

- void  **set_copy_mode**  **(** :ref:`int<class_int>` copy_mode  **)**

Set the copy mode of the BackBufferCopy. See ``COPY_MODE\_\*`` constants.

.. _class_BackBufferCopy_set_rect:

- void  **set_rect**  **(** :ref:`Rect2<class_rect2>` rect  **)**

Defines the area covered by the BackBufferCopy.


