godot-docs/classes/class_canvaslayer.rst

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.

.. _class_CanvasLayer:

CanvasLayer
===========

**Inherits:** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`

**Inherited By:** :ref:`ParallaxBackground<class_parallaxbackground>`

**Category:** Core

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

Canvas Item layer.

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

+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`Viewport<class_viewport>`  | :ref:`get_custom_viewport<class_CanvasLayer_get_custom_viewport>`  **(** **)** const                                     |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`            | :ref:`get_layer<class_CanvasLayer_get_layer>`  **(** **)** const                                                         |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_vector2>`    | :ref:`get_offset<class_CanvasLayer_get_offset>`  **(** **)** const                                                       |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`        | :ref:`get_rotation<class_CanvasLayer_get_rotation>`  **(** **)** const                                                   |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`        | :ref:`get_rotationd<class_CanvasLayer_get_rotationd>`  **(** **)** const                                                 |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_vector2>`    | :ref:`get_scale<class_CanvasLayer_get_scale>`  **(** **)** const                                                         |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`Matrix32<class_matrix32>`  | :ref:`get_transform<class_CanvasLayer_get_transform>`  **(** **)** const                                                 |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| :ref:`World2D<class_world2d>`    | :ref:`get_world_2d<class_CanvasLayer_get_world_2d>`  **(** **)** const                                                   |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_custom_viewport<class_CanvasLayer_set_custom_viewport>`  **(** :ref:`Viewport<class_viewport>` viewport  **)** |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_layer<class_CanvasLayer_set_layer>`  **(** :ref:`int<class_int>` layer  **)**                                  |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_offset<class_CanvasLayer_set_offset>`  **(** :ref:`Vector2<class_vector2>` offset  **)**                       |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_rotation<class_CanvasLayer_set_rotation>`  **(** :ref:`float<class_float>` radians  **)**                      |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_rotationd<class_CanvasLayer_set_rotationd>`  **(** :ref:`float<class_float>` degrees  **)**                    |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_scale<class_CanvasLayer_set_scale>`  **(** :ref:`Vector2<class_vector2>` scale  **)**                          |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| void                             | :ref:`set_transform<class_CanvasLayer_set_transform>`  **(** :ref:`Matrix32<class_matrix32>` transform  **)**            |
+----------------------------------+--------------------------------------------------------------------------------------------------------------------------+

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

Canvas Item layer. :ref:`CanvasItem<class_canvasitem>` nodes that are direct or indirect children of a :ref:`CanvasLayer<class_canvaslayer>` will be drawn in that layer. The layer is a numeric index that defines the draw order. The default 2D scene renders with index 0, so a :ref:`CanvasLayer<class_canvaslayer>` with index -1 will be drawn below, and one with index 1 will be drawn above. This is very useful for HUDs (in layer 1+ or above), or backgrounds (in layer -1 or below).

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

.. _class_CanvasLayer_get_custom_viewport:

- :ref:`Viewport<class_viewport>`  **get_custom_viewport**  **(** **)** const

Return the viewport RID for this layer.

.. _class_CanvasLayer_get_layer:

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

Return the layer index, determines the draw order, a lower value will be below a higher one.

.. _class_CanvasLayer_get_offset:

- :ref:`Vector2<class_vector2>`  **get_offset**  **(** **)** const

Return the base offset for this layer (helper).

.. _class_CanvasLayer_get_rotation:

- :ref:`float<class_float>`  **get_rotation**  **(** **)** const

Return the base rotation for this layer (helper).

.. _class_CanvasLayer_get_rotationd:

- :ref:`float<class_float>`  **get_rotationd**  **(** **)** const

Get rotation of the layer in degree.

.. _class_CanvasLayer_get_scale:

- :ref:`Vector2<class_vector2>`  **get_scale**  **(** **)** const

Return the base scale for this layer (helper).

.. _class_CanvasLayer_get_transform:

- :ref:`Matrix32<class_matrix32>`  **get_transform**  **(** **)** const

Return the base transform for this layer.

.. _class_CanvasLayer_get_world_2d:

- :ref:`World2D<class_world2d>`  **get_world_2d**  **(** **)** const

Return the :ref:`World2D<class_world2d>` used by this layer.

.. _class_CanvasLayer_set_custom_viewport:

- void  **set_custom_viewport**  **(** :ref:`Viewport<class_viewport>` viewport  **)**

.. _class_CanvasLayer_set_layer:

- void  **set_layer**  **(** :ref:`int<class_int>` layer  **)**

Set the layer index, determines the draw order, a lower value will be below a higher one.

.. _class_CanvasLayer_set_offset:

- void  **set_offset**  **(** :ref:`Vector2<class_vector2>` offset  **)**

Set the base offset for this layer (helper).

.. _class_CanvasLayer_set_rotation:

- void  **set_rotation**  **(** :ref:`float<class_float>` radians  **)**

Set the base rotation for this layer (helper).

.. _class_CanvasLayer_set_rotationd:

- void  **set_rotationd**  **(** :ref:`float<class_float>` degrees  **)**

Set rotation of the layer in degree.

.. _class_CanvasLayer_set_scale:

- void  **set_scale**  **(** :ref:`Vector2<class_vector2>` scale  **)**

Set the base scale for this layer (helper).

.. _class_CanvasLayer_set_transform:

- void  **set_transform**  **(** :ref:`Matrix32<class_matrix32>` transform  **)**

Set the base transform for this layer.