diff --git a/tutorials/shaders/shader_reference/canvas_item_shader.rst b/tutorials/shaders/shader_reference/canvas_item_shader.rst index f1a703c19..caf47081c 100644 --- a/tutorials/shaders/shader_reference/canvas_item_shader.rst +++ b/tutorials/shaders/shader_reference/canvas_item_shader.rst @@ -50,26 +50,27 @@ Global built-ins Global built-ins are available everywhere, including custom functions. -+-------------------+-----------------------------------------------------------------------------------------+ -| Built-in | Description | -+===================+=========================================================================================+ -| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | -| | seconds (which can be changed with the | -| | :ref:`rollover`| -| | setting). It's not affected by :ref:`time_scale` or | -| | pausing. If you need a ``TIME`` variable that can be scaled or paused, add your own | -| | :ref:`global shader uniform` and update it each | -| | frame. | -+-------------------+-----------------------------------------------------------------------------------------+ -| in float **PI** | A ``PI`` constant (``3.141592``). | -| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | -+-------------------+-----------------------------------------------------------------------------------------+ -| in float **TAU** | A ``TAU`` constant (``6.283185``). | -| | An equivalent of ``PI * 2`` and amount of radians in full turn. | -+-------------------+-----------------------------------------------------------------------------------------+ -| in float **E** | An ``E`` constant (``2.718281``). | -| | Euler's number and a base of the natural logarithm. | -+-------------------+-----------------------------------------------------------------------------------------+ ++-------------------+------------------------------------------------------------------------------------------+ +| Built-in | Description | ++===================+==========================================================================================+ +| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | +| | seconds (which can be changed with the | +| | :ref:`rollover` | +| | setting). It's affected by | +| | :ref:`time_scale` but not by pausing. If you need a | +| | ``TIME`` variable that is not affected by time scale, add your own | +| | :ref:`global shader uniform` and update it each | +| | frame. | ++-------------------+------------------------------------------------------------------------------------------+ +| in float **PI** | A ``PI`` constant (``3.141592``). | +| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | ++-------------------+------------------------------------------------------------------------------------------+ +| in float **TAU** | A ``TAU`` constant (``6.283185``). | +| | An equivalent of ``PI * 2`` and amount of radians in full turn. | ++-------------------+------------------------------------------------------------------------------------------+ +| in float **E** | An ``E`` constant (``2.718281``). | +| | Euler's number and a base of the natural logarithm. | ++-------------------+------------------------------------------------------------------------------------------+ Vertex built-ins ^^^^^^^^^^^^^^^^ diff --git a/tutorials/shaders/shader_reference/fog_shader.rst b/tutorials/shaders/shader_reference/fog_shader.rst index 8960f7849..c64767ccf 100644 --- a/tutorials/shaders/shader_reference/fog_shader.rst +++ b/tutorials/shaders/shader_reference/fog_shader.rst @@ -31,26 +31,27 @@ Global built-ins Global built-ins are available everywhere, including in custom functions. -+---------------------------------+-----------------------------------------------------------------------------------------+ -| Built-in | Description | -+=================================+=========================================================================================+ -| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | -| | seconds (which can be changed with the | -| | :ref:`rollover`| -| | setting). It's not affected by :ref:`time_scale` or | -| | pausing. If you need a ``TIME`` variable that can be scaled or paused, add your own | -| | :ref:`global shader uniform` and update it each | -| | frame. | -+---------------------------------+-----------------------------------------------------------------------------------------+ -| in float **PI** | A ``PI`` constant (``3.141592``). | -| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | -+---------------------------------+-----------------------------------------------------------------------------------------+ -| in float **TAU** | A ``TAU`` constant (``6.283185``). | -| | An equivalent of ``PI * 2`` and amount of radians in full turn. | -+---------------------------------+-----------------------------------------------------------------------------------------+ -| in float **E** | An ``E`` constant (``2.718281``). | -| | Euler's number and a base of the natural logarithm. | -+---------------------------------+-----------------------------------------------------------------------------------------+ ++-----------------------------------+------------------------------------------------------------------------------------------+ +| Built-in | Description | ++===================================+==========================================================================================+ +| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | +| | seconds (which can be changed with the | +| | :ref:`rollover` | +| | setting). It's affected by | +| | :ref:`time_scale` but not by pausing. If you need a | +| | ``TIME`` variable that is not affected by time scale, add your own | +| | :ref:`global shader uniform` and update it each | +| | frame. | ++-----------------------------------+------------------------------------------------------------------------------------------+ +| in float **PI** | A ``PI`` constant (``3.141592``). | +| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | ++-----------------------------------+------------------------------------------------------------------------------------------+ +| in float **TAU** | A ``TAU`` constant (``6.283185``). | +| | An equivalent of ``PI * 2`` and amount of radians in full turn. | ++-----------------------------------+------------------------------------------------------------------------------------------+ +| in float **E** | An ``E`` constant (``2.718281``). | +| | Euler's number and a base of the natural logarithm. | ++-----------------------------------+------------------------------------------------------------------------------------------+ Fog built-ins ^^^^^^^^^^^^^ diff --git a/tutorials/shaders/shader_reference/particle_shader.rst b/tutorials/shaders/shader_reference/particle_shader.rst index 727abe792..330fd50c4 100644 --- a/tutorials/shaders/shader_reference/particle_shader.rst +++ b/tutorials/shaders/shader_reference/particle_shader.rst @@ -54,25 +54,26 @@ Global built-ins Global built-ins are available everywhere, including custom functions. -+-------------------+-----------------------------------------------------------------------------------------+ -| Built-in | Description | -+===================+=========================================================================================+ -| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | -| | seconds (which can be changed with the | -| | :ref:`rollover`| -| | setting). It's not affected by :ref:`time_scale` or | -| | pausing. If you need a ``TIME`` variable that can be scaled or paused, add your own | -| | :ref:`global shader uniform` and update it each | -| | frame. | -+-------------------+-----------------------------------------------------------------------------------------+ -| in float **PI** | A ``PI`` constant (``3.141592``). | -| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | -+-------------------+-----------------------------------------------------------------------------------------+ -| in float **TAU** | A ``TAU`` constant (``6.283185``). | -| | An equivalent of ``PI * 2`` and amount of radians in full turn. | -+-------------------+-----------------------------------------------------------------------------------------+ -| in float **E** | An ``E`` constant (``2.718281``). Euler's number and a base of the natural logarithm. | -+-------------------+-----------------------------------------------------------------------------------------+ ++-------------------+------------------------------------------------------------------------------------------+ +| Built-in | Description | ++===================+==========================================================================================+ +| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | +| | seconds (which can be changed with the | +| | :ref:`rollover` | +| | setting). It's affected by | +| | :ref:`time_scale` but not by pausing. If you need a | +| | ``TIME`` variable that is not affected by time scale, add your own | +| | :ref:`global shader uniform` and update it each | +| | frame. | ++-------------------+------------------------------------------------------------------------------------------+ +| in float **PI** | A ``PI`` constant (``3.141592``). | +| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | ++-------------------+------------------------------------------------------------------------------------------+ +| in float **TAU** | A ``TAU`` constant (``6.283185``). | +| | An equivalent of ``PI * 2`` and amount of radians in full turn. | ++-------------------+------------------------------------------------------------------------------------------+ +| in float **E** | An ``E`` constant (``2.718281``). Euler's number and a base of the natural logarithm. | ++-------------------+------------------------------------------------------------------------------------------+ Start and Process built-ins ^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/tutorials/shaders/shader_reference/sky_shader.rst b/tutorials/shaders/shader_reference/sky_shader.rst index ab29429c3..b964f6ffa 100644 --- a/tutorials/shaders/shader_reference/sky_shader.rst +++ b/tutorials/shaders/shader_reference/sky_shader.rst @@ -157,10 +157,10 @@ There are 4 ``LIGHTX`` lights, accessed as ``LIGHT0``, ``LIGHT1``, ``LIGHT2``, a | in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | | | seconds (which can be changed with the | | | :ref:`rollover` | -| | setting). It's not affected by :ref:`time_scale` or | -| | pausing. If you need a ``TIME`` variable that can be scaled or paused, add your own | +| | setting). It's affected by :ref:`time_scale` but not by pausing. If you need a | +| | ``TIME`` variable that is not affected by time scale, add your own | | | :ref:`global shader uniform` and update it each | -| | frame. | +| | frame. | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------+ | in vec3 **POSITION** | Camera position, in world space. | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------+ diff --git a/tutorials/shaders/shader_reference/spatial_shader.rst b/tutorials/shaders/shader_reference/spatial_shader.rst index bed79ca7a..1d8ce5748 100644 --- a/tutorials/shaders/shader_reference/spatial_shader.rst +++ b/tutorials/shaders/shader_reference/spatial_shader.rst @@ -98,32 +98,32 @@ Global built-ins Global built-ins are available everywhere, including custom functions. -+-----------------------------+------------------------------------------------------------------------------------------+ -| Built-in | Description | -+=============================+==========================================================================================+ -| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | -| | seconds (which can be changed with the | -| | :ref:`rollover` | -| | setting). It's not affected by :ref:`time_scale` or | -| | pausing. If you need a ``TIME`` variable that can be scaled or paused, add your own | -| | :ref:`global shader uniform` and update it each | -| | frame. | -+-----------------------------+------------------------------------------------------------------------------------------+ -| in float **PI** | A ``PI`` constant (``3.141592``). | -| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | -+-----------------------------+------------------------------------------------------------------------------------------+ -| in float **TAU** | A ``TAU`` constant (``6.283185``). | -| | An equivalent of ``PI * 2`` and amount of radians in full turn. | -+-----------------------------+------------------------------------------------------------------------------------------+ -| in float **E** | An ``E`` constant (``2.718281``). Euler's number and a base of the natural logarithm. | -+-----------------------------+------------------------------------------------------------------------------------------+ -| in bool **OUTPUT_IS_SRGB** | ``true`` when output is in sRGB color space (this is ``true`` in the Compatibility | -| | renderer, ``false`` in Forward+ and Mobile). | -+-----------------------------+------------------------------------------------------------------------------------------+ -| in float **CLIP_SPACE_FAR** | Clip space far ``z`` value. | -| | In the Forward+ or Mobile renderers, it's ``0.0``. | -| | In the Compatibility renderer, it's ``-1.0``. | -+-----------------------------+------------------------------------------------------------------------------------------+ ++-----------------------------+-----------------------------------------------------------------------------------------------------+ +| Built-in | Description | ++=============================+=====================================================================================================+ +| in float **TIME** | Global time since the engine has started, in seconds. It repeats after every ``3,600`` | +| | seconds (which can be changed with the | +| | :ref:`rollover` | +| | setting). It's affected by :ref:`time_scale` but not by pausing. | +| | If you need a ``TIME`` variable that is not affected by time scale, add your own | +| | :ref:`global shader uniform` and update it each | +| | frame. | ++-----------------------------+-----------------------------------------------------------------------------------------------------+ +| in float **PI** | A ``PI`` constant (``3.141592``). | +| | A ratio of a circle's circumference to its diameter and amount of radians in half turn. | ++-----------------------------+-----------------------------------------------------------------------------------------------------+ +| in float **TAU** | A ``TAU`` constant (``6.283185``). | +| | An equivalent of ``PI * 2`` and amount of radians in full turn. | ++-----------------------------+-----------------------------------------------------------------------------------------------------+ +| in float **E** | An ``E`` constant (``2.718281``). Euler's number and a base of the natural logarithm. | ++-----------------------------+-----------------------------------------------------------------------------------------------------+ +| in bool **OUTPUT_IS_SRGB** | ``true`` when output is in sRGB color space (this is ``true`` in the Compatibility | +| | renderer, ``false`` in Forward+ and Mobile). | ++-----------------------------+-----------------------------------------------------------------------------------------------------+ +| in float **CLIP_SPACE_FAR** | Clip space far ``z`` value. | +| | In the Forward+ or Mobile renderers, it's ``0.0``. | +| | In the Compatibility renderer, it's ``-1.0``. | ++-----------------------------+-----------------------------------------------------------------------------------------------------+ Vertex built-ins ^^^^^^^^^^^^^^^^