#include "MEM_guardedalloc.h"
#include "BLI_dynstr.h"
#include "BLI_math_base.h"
#include "BLI_math_vector.h"
#include "BLI_path_util.h"
#include "BLI_string.h"
#include "BLI_string_utils.h"
#include "BLI_utildefines.h"
#include "BLI_vector.hh"
#include "BKE_appdir.h"
#include "BKE_global.h"
#include "DNA_space_types.h"
#include "GPU_capabilities.h"
#include "GPU_matrix.h"
#include "GPU_platform.h"
#include "GPU_shader.h"
#include "GPU_texture.h"
#include "GPU_uniform_buffer.h"
#include "gpu_backend.hh"
#include "gpu_context_private.hh"
#include "gpu_shader_private.hh"
#include "CLG_log.h"

Functions
Creation / Destruction
static void	standard_defines (Vector< const char * > &sources)

GPUShader *	GPU_shader_create_ex (const char vertcode, const char fragcode, const char geomcode, const char libcode, const char defines, const eGPUShaderTFBType tf_type, const char tf_names, const int tf_count, const char shname)

void	GPU_shader_free (GPUShader *shader)

Creation utils
GPUShader *	GPU_shader_create (const char vertcode, const char fragcode, const char geomcode, const char libcode, const char defines, const char shname)

GPUShader *	GPU_shader_create_from_python (const char vertcode, const char fragcode, const char geomcode, const char libcode, const char *defines)

static const char *	string_join_array_maybe_alloc (const char *str_arr, bool r_is_alloc)

struct GPUShader *	GPU_shader_create_from_arrays_impl (const struct GPU_ShaderCreateFromArray_Params params, const char func, int line)

Binding
void	GPU_shader_bind (GPUShader *gpu_shader)

void	GPU_shader_unbind (void)

Transform feedback
TODO(fclem): Should be replaced by compute shaders.
bool	GPU_shader_transform_feedback_enable (GPUShader shader, GPUVertBuf vertbuf)

void	GPU_shader_transform_feedback_disable (GPUShader *shader)

Uniforms / Resource location
int	GPU_shader_get_uniform (GPUShader shader, const char name)

int	GPU_shader_get_builtin_uniform (GPUShader *shader, int builtin)

int	GPU_shader_get_builtin_block (GPUShader *shader, int builtin)

int	GPU_shader_get_uniform_block (GPUShader shader, const char name)

int	GPU_shader_get_uniform_block_binding (GPUShader shader, const char name)

int	GPU_shader_get_texture_binding (GPUShader shader, const char name)

int	GPU_shader_get_attribute (GPUShader shader, const char name)

Getters
int	GPU_shader_get_program (GPUShader *shader)

Uniforms setters
void	GPU_shader_uniform_vector (GPUShader shader, int loc, int len, int arraysize, const float value)

void	GPU_shader_uniform_vector_int (GPUShader shader, int loc, int len, int arraysize, const int value)

void	GPU_shader_uniform_int (GPUShader *shader, int location, int value)

void	GPU_shader_uniform_float (GPUShader *shader, int location, float value)

void	GPU_shader_uniform_1i (GPUShader sh, const char name, int value)

void	GPU_shader_uniform_1b (GPUShader sh, const char name, bool value)

void	GPU_shader_uniform_2f (GPUShader sh, const char name, float x, float y)

void	GPU_shader_uniform_3f (GPUShader sh, const char name, float x, float y, float z)

void	GPU_shader_uniform_4f (GPUShader sh, const char name, float x, float y, float z, float w)

void	GPU_shader_uniform_1f (GPUShader sh, const char name, float value)

void	GPU_shader_uniform_2fv (GPUShader sh, const char name, const float data[2])

void	GPU_shader_uniform_3fv (GPUShader sh, const char name, const float data[3])

void	GPU_shader_uniform_4fv (GPUShader sh, const char name, const float data[4])

void	GPU_shader_uniform_mat4 (GPUShader sh, const char name, const float data[4][4])

void	GPU_shader_uniform_2fv_array (GPUShader sh, const char name, int len, const float(*val)[2])

void	GPU_shader_uniform_4fv_array (GPUShader sh, const char name, int len, const float(*val)[4])

Variables
char	datatoc_gpu_shader_colorspace_lib_glsl []

static CLG_LogRef	LOG = {"gpu.shader"}

sRGB Rendering Workaround
The viewport overlay frame-buffer is sRGB and will expect shaders to output display referred Linear colors. But other frame-buffers (i.e: the area frame-buffers) are not sRGB and require the shader output color to be in sRGB space (assumed display encoded color-space as the time of writing). For this reason we have a uniform to switch the transform on and off depending on the current frame-buffer color-space.
static int	g_shader_builtin_srgb_transform = 0

static bool	g_shader_builtin_srgb_is_dirty = false

static bool	gpu_shader_srgb_uniform_dirty_get ()

void	GPU_shader_set_srgb_uniform (GPUShader *shader)

void	GPU_shader_set_framebuffer_srgb_target (int use_srgb_to_linear)

Function Documentation

◆ GPU_shader_bind()

void GPU_shader_bind ( GPUShader * gpu_shader )

◆ GPU_shader_create()

GPUShader* GPU_shader_create	(	const char *	vertcode,
		const char *	fragcode,
		const char *	geomcode,
		const char *	libcode,
		const char *	defines,
		const char *	shname
	)

Definition at line 376 of file gpu_shader.cc.

References GPU_shader_create_ex(), and GPU_SHADER_TFB_NONE.

Referenced by createGPUShader(), DRW_shader_create_ex(), DRW_shader_create_fullscreen_ex(), DRW_shader_create_fullscreen_with_shaderlib_ex(), DRW_shader_create_with_lib_ex(), DRW_shader_create_with_shaderlib_ex(), GPU_pass_compile(), and GPU_shader_create_from_arrays_impl().

◆ GPU_shader_create_ex()

GPUShader* GPU_shader_create_ex	(	const char *	vertcode,
		const char *	fragcode,
		const char *	geomcode,
		const char *	libcode,
		const char *	defines,
		const eGPUShaderTFBType	tf_type,
		const char **	tf_names,
		const int	tf_count,
		const char *	shname
	)

Definition at line 290 of file gpu_shader.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::append(), BLI_assert, blender::gpu::GPUBackend::get(), GPU_SHADER_TFB_NONE, shader(), blender::gpu::GPUBackend::shader_alloc(), standard_defines(), and blender::gpu::wrap().

Referenced by DRW_shader_create_with_transform_feedback(), GPU_shader_create(), and GPU_shader_create_from_python().

◆ GPU_shader_create_from_arrays_impl()

struct GPUShader* GPU_shader_create_from_arrays_impl	(	const struct GPU_ShaderCreateFromArray_Params *	params,
		const char *	func,
		int	line
	)

Use via GPU_shader_create_from_arrays macro (avoids passing in param).

Similar to DRW_shader_create_with_lib with the ability to include libs for each type of shader.

It has the advantage that each item can be conditionally included without having to build the string inline, then free it.

Parameters

params NULL terminated arrays of strings.

Example:

sh = GPU_shader_create_from_arrays({
    .vert = (const char *[]){shader_lib_glsl, shader_vert_glsl, NULL},
    .geom = (const char *[]){shader_geom_glsl, NULL},
    .frag = (const char *[]){shader_frag_glsl, NULL},
    .defs = (const char *[]){"#define DEFINE\n", test ? "#define OTHER_DEFINE\n" : "", NULL},
});

Definition at line 461 of file gpu_shader.cc.

References ARRAY_SIZE, BLI_snprintf(), GPU_shader_create(), MEM_freeN, params, str, and string_join_array_maybe_alloc().

◆ GPU_shader_create_from_python()

GPUShader* GPU_shader_create_from_python	(	const char *	vertcode,
		const char *	fragcode,
		const char *	geomcode,
		const char *	libcode,
		const char *	defines
	)