GPU Shader Utilities (gpu.shader)

This module provides access to GPUShader internal functions.

Built-in shaders

All built-in shaders have the mat4 ModelViewProjectionMatrix uniform.

Its value must be modified using the gpu.matrix module.

FLAT_COLOR

Attributes

vec3 pos, vec4 color

Uniforms

none

IMAGE

Attributes

vec3 pos, vec2 texCoord

Uniforms

sampler2D image

IMAGE_COLOR

Attributes

vec3 pos, vec2 texCoord

Uniforms

sampler2D image, vec4 color

SMOOTH_COLOR

Attributes

vec3 pos, vec4 color

Uniforms

none

UNIFORM_COLOR

Attributes

vec3 pos

Uniforms

vec4 color

POLYLINE_FLAT_COLOR

Attributes

vec3 pos, vec4 color

Uniforms

vec2 viewportSize, float lineWidth

POLYLINE_SMOOTH_COLOR

Attributes

vec3 pos, vec4 color

Uniforms

vec2 viewportSize, float lineWidth

POLYLINE_UNIFORM_COLOR

Attributes

vec3 pos

Uniforms

vec2 viewportSize, float lineWidth

gpu.shader.create_from_info(shader_info)

Create shader from a GPUShaderCreateInfo.

Parameters

shader_info (bpy.types.GPUShaderCreateInfo) – GPUShaderCreateInfo

Returns

Shader object corresponding to the given name.

Return type

bpy.types.GPUShader

gpu.shader.from_builtin(shader_name, config='DEFAULT')

Shaders that are embedded in the blender internal code (see Built-in shaders). They all read the uniform mat4 ModelViewProjectionMatrix, which can be edited by the gpu.matrix module.

You can also choose a shader configuration that uses clip_planes by setting the CLIPPED value to the config parameter. Note that in this case you also need to manually set the value of mat4 ModelMatrix.

Parameters

• shader_name (str) – One of the builtin shader names.

• config (str) –

  One of these types of shader configuration:

  • DEFAULT

  • CLIPPED

Returns

Shader object corresponding to the given name.

Return type

bpy.types.GPUShader

gpu.shader.unbind()

Unbind the bound shader object.