API Docs: gpu api introduction + examples

1 files changed, 35 insertions, 0 deletions

diff --git a/doc/python_api/examples/gpu.shader.py b/doc/python_api/examples/gpu.shader.py
new file mode 100644
index 00000000000..7ffd3fe85c8
--- /dev/null
+++ b/doc/python_api/examples/gpu.shader.py
@@ -0,0 +1,35 @@
+"""
+Built-in shaders
+++++++++++++++++
+
+All built-in shaders have the ``mat4 ModelViewProjectionMatrix`` uniform.
+The value of it can only be modified using the :class:`gpu.matrix` module.
+"""
+
+2D_UNIFORM_COLOR:
+  attributes: vec3 pos
+  uniforms: vec4 color
+
+2D_FLAT_COLOR:
+  attributes: vec3 pos, vec4 color
+  uniforms: -
+
+2D_SMOOTH_COLOR:
+  attributes: vec3 pos, vec4 color
+  uniforms: -
+
+2D_IMAGE:
+  attributes: vec3 pos, vec2 texCoord
+  uniforms: sampler2D image
+
+3D_UNIFORM_COLOR:
+  attributes: vec3 pos
+  uniforms: vec4 color
+
+3D_FLAT_COLOR:
+  attributes: vec3 pos, vec4 color
+  uniforms: -
+
+3D_SMOOTH_COLOR:
+  attributes: vec3 pos, vec4 color
+  uniforms: -