Update shading_language.rst

Made further corrections and fixes. Also made format adjustments to provide more uniform formatting between tables.

learning/features/shading/shading_language.rst

@@ -9,7 +9,7 @@ Introduction
 Godot uses a shading language very similar to GLSL ES 3.0. Most datatypes and functions are supported,
 and the remaining will likely be added over time.
 
-Unlike the shader language in Godot 2.x, this implementaiton is much closer to the original.
+Unlike the shader language in Godot 2.x, this implementation is much closer to the original.
 
 Shader Types
 ------------
@@ -60,9 +60,9 @@ Most GLSL ES 3.0 datatypes are supported. Following is the list:
 +-----------------+---------------------------------------------------------------------------+
 | **bvec4**       | Four component vector of booleans.                                        |
 +-----------------+---------------------------------------------------------------------------+
-| **int**         | Signed scalar integer                                                     |
+| **int**         | Signed scalar integer.                                                    |
 +-----------------+---------------------------------------------------------------------------+
-| **ivec2**       | Two component vector of signed integers                                   |
+| **ivec2**       | Two component vector of signed integers.                                  |
 +-----------------+---------------------------------------------------------------------------+
 | **ivec3**       | Three component vector of signed integers.                                |
 +-----------------+---------------------------------------------------------------------------+
@@ -126,7 +126,7 @@ Members
 ~~~~~~~
 
 Individual scalar members of vector types are accessed via the "x", "y", "z" and "w" members. Alternatively, using "r", "g", "b" and "a" also works and is equivalent. 
-Use whathever fits best for your use case.
+Use whatever fits best for your use case.
 
 For matrices, use [idx] indexing syntax to access each vector.
 
@@ -152,6 +152,7 @@ It is possible to obtain any combination of them in any order, as long as the re
 This is easier shown than explained:
 
 .. code-block:: glsl
+
 	vec4 a = vec4(0.0, 1.0, 2.0, 3.0);
 	vec3 b = a.rgb; // Creates a vec3 with vec4 components 
 	vec3 b = a.aaa; // Also valid, creates a vec3 and fills it with "a".
@@ -286,7 +287,7 @@ Processor Functions
 
 Depending on shader type, processor functions may be available to optionally override.
 For "spatial" and "canvas_item", it is possible to override "vertex", "fragment" and "light".
-For "particles", only "vertex" can be overriden.
+For "particles", only "vertex" can be overridden.
 
 Vertex Processor
 ~~~~~~~~~~~~~~~~~
@@ -379,7 +380,7 @@ to make the compiler understand what the uniform is used for.
 	shader_type spatial;
 
 	uniform vec4 color : hint_color;
-	uniform float amonut : hint_range(0,1);
+	uniform float amount : hint_range(0,1);
 
 
 Full list of hints below:
@@ -425,7 +426,7 @@ Built-in Functions
 ------------------
 
 A large number of built-in functions are supported, conforming mostly to GLSL ES 3.0.
-When vec_type (float), vec_int_type, vec_uint_type, vec_bool_type, nomenclature is used, it can be scalar or vector.
+When vec_type (float), vec_int_type, vec_uint_type, vec_bool_type nomenclature is used, it can be scalar or vector.
 
 
 
@@ -485,7 +486,7 @@ When vec_type (float), vec_int_type, vec_uint_type, vec_bool_type, nomenclature
 +-----------------------------------------------------------------------+---------------------------------------------+
 | vec\_type **min** ( vec\_type,vec\_type )                             | Minimum                                     |
 +-----------------------------------------------------------------------+---------------------------------------------+
-| vec\_type **min** ( vec\_type,vec\_type )                             | Maximum                                     |
+| vec\_type **max** ( vec\_type,vec\_type )                             | Maximum                                     |
 +-----------------------------------------------------------------------+---------------------------------------------+
 | vec\_type **clamp** ( vec\_type value,vec\_type min, vec\_type max )  | Clamp to Min-Max                            |
 +-----------------------------------------------------------------------+---------------------------------------------+
@@ -539,13 +540,13 @@ When vec_type (float), vec_int_type, vec_uint_type, vec_bool_type, nomenclature
 +-----------------------------------------------------------------------+---------------------------------------------+
 | vec\_bool_type **greaterThan** ( vec_scalar_type )                    | Bool vector cmp on > int/uint/float vectors |
 +-----------------------------------------------------------------------+---------------------------------------------+
-| vec\_bool_type **lessThanEqual** ( vec_scalar_type )                  | Bool vector cmp on <=int/uint/float vectors |
+| vec\_bool_type **lessThanEqual** ( vec_scalar_type )                  | Bool vector cmp on <= int/uint/float vectors|
 +-----------------------------------------------------------------------+---------------------------------------------+
-| vec\_bool_type **greaterThanEqual** ( vec_scalar_type )               | Bool vector cmp on >=int/uint/float vectors |
+| vec\_bool_type **greaterThanEqual** ( vec_scalar_type )               | Bool vector cmp on >= int/uint/float vectors|
 +-----------------------------------------------------------------------+---------------------------------------------+
-| vec\_bool_type **equal** ( vec_scalar_type )                          | Bool vector cmp on ==int/uint/float vectors |
+| vec\_bool_type **equal** ( vec_scalar_type )                          | Bool vector cmp on == int/uint/float vectors|
 +-----------------------------------------------------------------------+---------------------------------------------+
-| vec\_bool_type **notEqual** ( vec_scalar_type )                       | Bool vector cmp on !=int/uint/float vectors |
+| vec\_bool_type **notEqual** ( vec_scalar_type )                       | Bool vector cmp on != int/uint/float vectors|
 +-----------------------------------------------------------------------+---------------------------------------------+
 | bool **any** ( vec_bool_type )                                        | Any component is true                       |
 +-----------------------------------------------------------------------+---------------------------------------------+
@@ -559,7 +560,7 @@ When vec_type (float), vec_int_type, vec_uint_type, vec_bool_type, nomenclature
 +-----------------------------------------------------------------------+---------------------------------------------+
 | vec4_type **texture** ( sampler2D_type s, vec2 uv [, float bias])     | Perform a 2D texture read                   |
 +-----------------------------------------------------------------------+---------------------------------------------+
-| vec4 **texture** ( samplerCube s, vec3 uv [, float bias])             | Perform a Cube texture read                 |
+| vec4_type **texture** ( samplerCube s, vec3 uv [, float bias])        | Perform a Cube texture read                 |
 +-----------------------------------------------------------------------+---------------------------------------------+
 | vec4_type **textureProj** ( sampler2d_type s, vec3 uv [, float bias]) | Perform a texture read with projection      |
 +-----------------------------------------------------------------------+---------------------------------------------+
@@ -604,7 +605,7 @@ Render Modes
 +---------------------------------+----------------------------------------------------------------------+
 | **blend_mul**                   | Multiplicative blend mode.                                           |
 +---------------------------------+----------------------------------------------------------------------+
-| **depth_draw_opaque**           | Only draw depth for opaque geometry (not trasparent).                |
+| **depth_draw_opaque**           | Only draw depth for opaque geometry (not transparent).                |
 +---------------------------------+----------------------------------------------------------------------+
 | **depth_draw_always**           | Always draw depth (opaque and transparent).                          |
 +---------------------------------+----------------------------------------------------------------------+
@@ -618,11 +619,11 @@ Render Modes
 +---------------------------------+----------------------------------------------------------------------+
 | **cull_back**                   | Cull back-faces (default).                                           |
 +---------------------------------+----------------------------------------------------------------------+
-| **cull_disabled**               | Culling disabled (double sided)                                      |
+| **cull_disabled**               | Culling disabled (double sided).                                     |
 +---------------------------------+----------------------------------------------------------------------+
 | **unshaded**                    | Result is just albedo. No lighting/shading happens in material.      |
 +---------------------------------+----------------------------------------------------------------------+
-| **diffuse_lambert**             | Lambert shading for diffuse (default)                                |
+| **diffuse_lambert**             | Lambert shading for diffuse (default).                               |
 +---------------------------------+----------------------------------------------------------------------+
 | **diffuse_lambert_wrap**        | Lambert wrapping (roughness dependent) for diffuse.                  |
 +---------------------------------+----------------------------------------------------------------------+
@@ -632,17 +633,17 @@ Render Modes
 +---------------------------------+----------------------------------------------------------------------+
 | **diffuse toon**                | Toon shading for diffuse.                                            |
 +---------------------------------+----------------------------------------------------------------------+
-| **specular_schlick_ggx**        | Schlick-GGX for specular (default)                                    |
+| **specular_schlick_ggx**        | Schlick-GGX for specular (default).                                  |
 +---------------------------------+----------------------------------------------------------------------+
-| **specular_blinn**              | Blinn for specular (compatibility)                                   |
+| **specular_blinn**              | Blinn for specular (compatibility).                                  |
 +---------------------------------+----------------------------------------------------------------------+
-| **specular_phong**              | Phong for specular (compatibility)                                   |
+| **specular_phong**              | Phong for specular (compatibility).                                  |
 +---------------------------------+----------------------------------------------------------------------+
 | **specular_toon**               | Toon for specular.                                                   |
 +---------------------------------+----------------------------------------------------------------------+
 | **skip_vertex_transform**       | VERTEX/NORMAL/etc need to be transformed manually in VS.             |
 +---------------------------------+----------------------------------------------------------------------+
-| **world_vertex_coords**         | VERTEX/NORMAL/etc are modified in world coordinates instead of local |
+| **world_vertex_coords**         | VERTEX/NORMAL/etc are modified in world coordinates instead of local.|
 +---------------------------------+----------------------------------------------------------------------+
 | **vertex_lighting**             | Use vertex-based lighting.                                           |
 +---------------------------------+----------------------------------------------------------------------+
@@ -662,7 +663,7 @@ Vertex Built-Ins
 +----------------------------------+-------------------------------------------------------+
 | mat4 **CAMERA_MATRIX**           | View space to world space transform.                  |
 +----------------------------------+-------------------------------------------------------+
-| mat4 **MODELVIEW_MATRIX**        | Model space to view space transform (use if possible) |
+| mat4 **MODELVIEW_MATRIX**        | Model space to view space transform (use if possible).|
 +----------------------------------+-------------------------------------------------------+
 | mat4 **INV_PROJECTION_MATRIX**   | Clip space to view space transform.                   |
 +----------------------------------+-------------------------------------------------------+
@@ -670,7 +671,7 @@ Vertex Built-Ins
 +----------------------------------+-------------------------------------------------------+
 | vec2 **VIEWPORT_SIZE**           | Size of viewport (in pixels).                         |
 +----------------------------------+-------------------------------------------------------+
-| vec3 **VERTEX**                  | Vertex in local coords (see doc below)                |
+| vec3 **VERTEX**                  | Vertex in local coords (see doc below).               |
 +----------------------------------+-------------------------------------------------------+
 | vec3 **NORMAL**                  | Normal in local coords.                               |
 +----------------------------------+-------------------------------------------------------+
@@ -688,7 +689,7 @@ Vertex Built-Ins
 +----------------------------------+-------------------------------------------------------+
 | int **INSTANCE_ID**              | Instance ID for instancing.                           |
 +----------------------------------+-------------------------------------------------------+
-| vec4 **INSTANCE_CUSTOM**         | Instance custom data (for particles, mostly)          |
+| vec4 **INSTANCE_CUSTOM**         | Instance custom data (for particles, mostly).         |
 +----------------------------------+-------------------------------------------------------+
 | float **ROUGHNESS**              | Roughness for vertex lighting.                        |
 +----------------------------------+-------------------------------------------------------+
@@ -749,7 +750,7 @@ Fragment Built-Ins
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | vec2 **VIEWPORT_SIZE**           | Size of viewport (in pixels).                                                                    |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| vec3 **VERTEX**                  | Vertex that comes from  vertex function, in view space.                                          |
+| vec3 **VERTEX**                  | Vertex that comes from vertex function, in view space.                                           |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | in vec4 **FRAGCOORD**            | Fragment cordinate, pixel adjusted.                                                              |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
@@ -771,19 +772,19 @@ Fragment Built-Ins
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | in vec4 **COLOR**                | COLOR that comes from vertex function.                                                           |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out vec3 **ALBEDO**              | Albedo (default white)                                                                           |
+| out vec3 **ALBEDO**              | Albedo (default white).                                                                          |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | out float **ALPHA**              | Alpha (0..1), if written to the material will go to transparent pipeline.                        |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out float **METALLIC**           | Metallic (0..1)                                                                                  |
+| out float **METALLIC**           | Metallic (0..1).                                                                                 |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | out float **SPECULAR**           | Specular. Defaults to 0.5, best to not modify unless you want to change IOR.                     |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out float **ROUGHNESS**          | Roughness (0..1)                                                                                 |
+| out float **ROUGHNESS**          | Roughness (0..1).                                                                                |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out float **RIM**                | Rim (0..1)                                                                                       |
+| out float **RIM**                | Rim (0..1).                                                                                      |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out float **RIM_TINT**           | Rim Tint, goes from 0 (white) to 1 (albedo)                                                      |
+| out float **RIM_TINT**           | Rim Tint, goes from 0 (white) to 1 (albedo).                                                     |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | out float **CLEARCOAT**          | Small added specular blob.                                                                       |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
@@ -793,15 +794,15 @@ Fragment Built-Ins
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | out float **ANISOTROPY_FLOW**    | Distortion direction, use with flowmaps.                                                         |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out float **SSS_STRENGTH**       | Strength of Subsurface Scattering (default 0)                                                    |
+| out float **SSS_STRENGTH**       | Strength of Subsurface Scattering (default 0).                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | out vec3 **TRANSMISSION**        | Transmission mask (default 0,0,0).                                                               |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | out foat **AO**                  | Ambient Occlusion (pre-baked).                                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out float **AO_LIGHT_AFFECT**    | How much AO affects lights (0..1. default 0, none)                                               |
+| out float **AO_LIGHT_AFFECT**    | How much AO affects lights (0..1. default 0, none).                                              |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
-| out vec3 **EMISSION**            | Emission color (can go over 1,1,1 for HDR)                                                       |
+| out vec3 **EMISSION**            | Emission color (can go over 1,1,1 for HDR).                                                      |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
 | in sampler2D **SCREEN_TEXTURE**  | Built-in Texture for reading from the screen. Mipmaps contain increasingly blurred copies.       |
 +----------------------------------+--------------------------------------------------------------------------------------------------+
@@ -822,43 +823,43 @@ Values marked as "in" are read-only. Values marked as "out" are for optional wri
 Light Built-Ins
 ^^^^^^^^^^^^^^^
 
-+----------------------------------+------------------------------------------+
-| Built-in                         | Description                              |
-+==================================+==========================================+
-| in mat4 **WORLD_MATRIX**         | Model space to world space transform.    |
-+----------------------------------+------------------------------------------+
-| in mat4 **INV_CAMERA_MATRIX**    | World space to view space transform.     |
-+----------------------------------+------------------------------------------+
-| in mat4 **PROJECTION_MATRIX**    | View space to clip space transform.      |
-+----------------------------------+------------------------------------------+
-| in mat4 **CAMERA_MATRIX**        | View space to world space transform.     |
-+----------------------------------+------------------------------------------+
-| in mat4 **INV_PROJECTION_MATRIX**| Clip space to view space transform.      |
-+----------------------------------+------------------------------------------+
-| in float **TIME**                | Elapsed total time in seconds.           |
-+----------------------------------+------------------------------------------+
-| in vec2 **VIEWPORT_SIZE**        | Size of viewport (in pixels).            |
-+----------------------------------+------------------------------------------+
-| in vec3 **NORMAL**               | Normal vector.                           |
-+----------------------------------+------------------------------------------+
-| in vec3 **VIEW**                 | View vector.                             |
-+----------------------------------+------------------------------------------+
-| in vec3  **LIGHT**               | Light Vector.                            |
-+----------------------------------+------------------------------------------+
-| in vec3 **LIGHT_COLOR**          | Color of light multiplied by energy.     |
-+----------------------------------+------------------------------------------+
-| in vec3 **ATTENUATION**          | Attenuation based on distance or shadow. |
-+----------------------------------+------------------------------------------+
-| in vec3 **ALBEDO**               | Base albedo.                             |
-+----------------------------------+------------------------------------------+
-| in vec3 **TRANSMISSION**         | Transmission mask.                       |
-+----------------------------------+------------------------------------------+
-| in float **ROUGHNESS**           | Roughness.                               |
-+----------------------------------+------------------------------------------+
-| out vec3 **DIFFUSE_LIGHT**       | Diffuse light result.                    |
-+----------------------------------+------------------------------------------+
-| out vec3 **SPECULAR_LIGHT**      | Specular light result.                   |
-+----------------------------------+------------------------------------------+
++-----------------------------------+------------------------------------------+
+| Built-in                          | Description                              |
++===================================+==========================================+
+| in mat4 **WORLD_MATRIX**          | Model space to world space transform.    |
++-----------------------------------+------------------------------------------+
+| in mat4 **INV_CAMERA_MATRIX**     | World space to view space transform.     |
++-----------------------------------+------------------------------------------+
+| in mat4 **PROJECTION_MATRIX**     | View space to clip space transform.      |
++-----------------------------------+------------------------------------------+
+| in mat4 **CAMERA_MATRIX**         | View space to world space transform.     |
++-----------------------------------+------------------------------------------+
+| in mat4 **INV_PROJECTION_MATRIX** | Clip space to view space transform.      |
++-----------------------------------+------------------------------------------+
+| in float **TIME**                 | Elapsed total time in seconds.           |
++-----------------------------------+------------------------------------------+
+| in vec2 **VIEWPORT_SIZE**         | Size of viewport (in pixels).            |
++-----------------------------------+------------------------------------------+
+| in vec3 **NORMAL**                | Normal vector.                           |
++-----------------------------------+------------------------------------------+
+| in vec3 **VIEW**                  | View vector.                             |
++-----------------------------------+------------------------------------------+
+| in vec3  **LIGHT**                | Light Vector.                            |
++-----------------------------------+------------------------------------------+
+| in vec3 **LIGHT_COLOR**           | Color of light multiplied by energy.     |
++-----------------------------------+------------------------------------------+
+| in vec3 **ATTENUATION**           | Attenuation based on distance or shadow. |
++-----------------------------------+------------------------------------------+
+| in vec3 **ALBEDO**                | Base albedo.                             |
++-----------------------------------+------------------------------------------+
+| in vec3 **TRANSMISSION**          | Transmission mask.                       |
++-----------------------------------+------------------------------------------+
+| in float **ROUGHNESS**            | Roughness.                               |
++-----------------------------------+------------------------------------------+
+| out vec3 **DIFFUSE_LIGHT**        | Diffuse light result.                    |
++-----------------------------------+------------------------------------------+
+| out vec3 **SPECULAR_LIGHT**       | Specular light result.                   |
++-----------------------------------+------------------------------------------+
 
 Writing light shaders is completely optional. Unlike other game engines, they don't affect
 performance or force a specific pipeline. 
@@ -882,7 +883,7 @@ Render Modes
 +---------------------------------+----------------------------------------------------------------------+
 | **blend_add**                   | Additive blend mode.                                                 |
 +---------------------------------+----------------------------------------------------------------------+
-| **blend_sub**                   | Substractive blend mode.                                             |
+| **blend_sub**                   | Subtractive blend mode.                                              |
 +---------------------------------+----------------------------------------------------------------------+
 | **blend_mul**                   | Multiplicative blend mode.                                           |
 +---------------------------------+----------------------------------------------------------------------+
@@ -890,7 +891,7 @@ Render Modes
 +---------------------------------+----------------------------------------------------------------------+
 | **unshaded**                    | Result is just albedo. No lighting/shading happens in material.      |
 +---------------------------------+----------------------------------------------------------------------+
-| **light_only**                  | Only draw for light pass (when multipass is used)                    |
+| **light_only**                  | Only draw for light pass (when multipass is used).                   |
 +---------------------------------+----------------------------------------------------------------------+
 | **skip_vertex_transform**       | VERTEX/NORMAL/etc need to be transformed manually in VS.             |
 +---------------------------------+----------------------------------------------------------------------+
@@ -903,7 +904,7 @@ Vertex Built-Ins
 +================================+================================================================+
 | in mat4 **WORLD_MATRIX**       | Image to World transform.                                      |
 +--------------------------------+----------------------------------------------------------------+
-| in mat4 **EXTRA_MATRIX**       | Extra transform                                                |
+| in mat4 **EXTRA_MATRIX**       | Extra transform.                                               |
 +--------------------------------+----------------------------------------------------------------+
 | in mat4 **PROJECTION_MATRIX**  | World to view transform.                                       |
 +--------------------------------+----------------------------------------------------------------+
@@ -915,7 +916,7 @@ Vertex Built-Ins
 +--------------------------------+----------------------------------------------------------------+
 | inout vec2 **VERTEX**          | Vertex in image space.                                         |
 +--------------------------------+----------------------------------------------------------------+
-| inout vec2 **UV**              | UV                                                             |
+| inout vec2 **UV**              | UV.                                                            |
 +--------------------------------+----------------------------------------------------------------+
 | inout vec4 **COLOR**           | Color from vertex primitive.                                   |
 +--------------------------------+----------------------------------------------------------------+
@@ -953,7 +954,7 @@ This allows to easily adjust the shader to a particle system using default parti
 shader, this value can be used as desired.
 
 Fragment Built-Ins
-^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^
 
 +----------------------------------+------------------------------------------------------------+
 | Built-In                         | Description                                                |
@@ -993,37 +994,37 @@ Light Built-Ins
 +-------------------------------------+-------------------------------------------------------------------------------+
 | Built-In                            | Description                                                                   |
 +=====================================+===============================================================================+
-| in vec4 **POSITION**                | Screen Position                                                               |
+| in vec4 **POSITION**                | Screen Position.                                                              |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec3 **NORMAL**                  | Input Normal                                                                  |
+| in vec3 **NORMAL**                  | Input Normal.                                                                 |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec2 **UV**                      | UV                                                                            |
+| in vec2 **UV**                      | UV.                                                                           |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec4 **COLOR**                   | Input Color                                                                   |
+| in vec4 **COLOR**                   | Input Color.                                                                  |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in sampler2D **TEXTURE**            | Current texture in use for CanvasItem                                         |
+| in sampler2D **TEXTURE**            | Current texture in use for CanvasItem.                                        |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec2 **TEXTURE_PIXEL_SIZE**      | Pixel size for current 2D texture                                             |
+| in vec2 **TEXTURE_PIXEL_SIZE**      | Pixel size for current 2D texture.                                            |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec2 **SCREEN_UV**               | Screen Texture Coordinate (for using with texscreen)                          |
+| in vec2 **SCREEN_UV**               | Screen Texture Coordinate (for using with texscreen).                         |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec2 **POINT_COORD**             | Current UV for Point Sprite                                                   |
+| in vec2 **POINT_COORD**             | Current UV for Point Sprite.                                                  |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in float **TIME**                   | Time (in seconds)                                                             |
+| in float **TIME**                   | Time (in seconds).                                                            |
 +-------------------------------------+-------------------------------------------------------------------------------+
 | vec2 **LIGHT\_VEC**                 | Vector from light to fragment, can be modified to alter shadow computation.   |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in float **LIGHT\_HEIGHT**          | Height of Light                                                               |
+| in float **LIGHT\_HEIGHT**          | Height of Light.                                                              |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in color **LIGHT\_COLOR**           | Color of Light                                                                |
+| in color **LIGHT\_COLOR**           | Color of Light.                                                               |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in color **LIGHT\_SHADOW\_COLOR**   | Color of Light shadow                                                         |
+| in color **LIGHT\_SHADOW\_COLOR**   | Color of Light shadow.                                                        |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec2 **LIGHT\_UV**               | UV for light image                                                            |
+| in vec2 **LIGHT\_UV**               | UV for light image.                                                           |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| in vec4 **SHADOW**                  | Light shadow color override                                                   |
+| in vec4 **SHADOW**                  | Light shadow color override.                                                  |
 +-------------------------------------+-------------------------------------------------------------------------------+
-| out vec4 **LIGHT**                  | Light Output (shader is ignored if this is not used)                          |
+| out vec4 **LIGHT**                  | Light Output (shader is ignored if this is not used).                         |
 +-------------------------------------+-------------------------------------------------------------------------------+
 
 
@@ -1053,7 +1054,7 @@ Vertex Built-Ins
 +---------------------------------+-----------------------------------------------------------+
 | inout vec3 **VELOCITY**         | Particle velocity, can be modified.                       |
 +---------------------------------+-----------------------------------------------------------+
-| out float **MASS**              | Particle mass, use for attractors (default 1)             |
+| out float **MASS**              | Particle mass, use for attractors (default 1).            |
 +---------------------------------+-----------------------------------------------------------+
 | inout bool **ACTIVE**           | Particle is active, can be set to false.                  |
 +---------------------------------+-----------------------------------------------------------+
@@ -1071,7 +1072,7 @@ Vertex Built-Ins
 +---------------------------------+-----------------------------------------------------------+
 | in int **INDEX**                | Particle index (from total particles).                    |
 +---------------------------------+-----------------------------------------------------------+
-| in mat4 **EMISSION_TRANSFORM**  | Emitter transform (used for non-local systems)            |
+| in mat4 **EMISSION_TRANSFORM**  | Emitter transform (used for non-local systems).           |
 +---------------------------------+-----------------------------------------------------------+
 | in uint **RANDOM_SEED**         | Random seed used as base for random.                      |
 +---------------------------------+-----------------------------------------------------------+