#include <gpu_shader_private.hh>

Inherited by blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

Classes
struct	Constants

Public Member Functions
virtual void	init (const shader::ShaderCreateInfo &info, bool is_batch_compilation)=0

virtual void	vertex_shader_from_glsl (MutableSpan< const char * > sources)=0

virtual void	geometry_shader_from_glsl (MutableSpan< const char * > sources)=0

virtual void	fragment_shader_from_glsl (MutableSpan< const char * > sources)=0

virtual void	compute_shader_from_glsl (MutableSpan< const char * > sources)=0

virtual bool	finalize (const shader::ShaderCreateInfo *info=nullptr)=0

virtual void	warm_cache (int limit)=0

virtual void	transform_feedback_names_set (Span< const char * > name_list, eGPUShaderTFBType geom_type)=0

virtual bool	transform_feedback_enable (VertBuf *)=0

virtual void	transform_feedback_disable ()=0

virtual void	bind ()=0

virtual void	unbind ()=0

virtual void	uniform_float (int location, int comp_len, int array_size, const float *data)=0

virtual void	uniform_int (int location, int comp_len, int array_size, const int *data)=0

std::string	defines_declare (const shader::ShaderCreateInfo &info) const

virtual std::string	resources_declare (const shader::ShaderCreateInfo &info) const =0

virtual std::string	vertex_interface_declare (const shader::ShaderCreateInfo &info) const =0

virtual std::string	fragment_interface_declare (const shader::ShaderCreateInfo &info) const =0

virtual std::string	geometry_interface_declare (const shader::ShaderCreateInfo &info) const =0

virtual std::string	geometry_layout_declare (const shader::ShaderCreateInfo &info) const =0

virtual std::string	compute_layout_declare (const shader::ShaderCreateInfo &info) const =0

virtual int	program_handle_get () const =0

virtual bool	get_uses_ssbo_vertex_fetch () const =0

virtual int	get_ssbo_vertex_fetch_output_num_verts () const =0

const char *const	name_get () const

void	parent_set (Shader *parent)

Shader *	parent_get () const

Creation / Destruction
	Shader (const char *name)

virtual	~Shader ()

Assign specialization constants.
void	specialization_constants_init (const shader::ShaderCreateInfo &info)

Static Public Member Functions
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 bool	srgb_uniform_dirty_get ()

static void	set_srgb_uniform (GPUShader *shader)

static void	set_framebuffer_srgb_target (int use_srgb_to_linear)

Public Attributes
ShaderInterface *	interface = nullptr

struct blender::gpu::Shader::Constants	constants

Protected Member Functions
Debug functions
void	print_log (Span< const char * > sources, const char log, const char stage, bool error, GPULogParser *parser)

Protected Attributes
char	name [64]

Shader *	parent_shader_ = nullptr

Detailed Description

Implementation of shader compilation and uniforms handling. Base class which is then specialized for each implementation (GL, VK, ...).

Definition at line 44 of file gpu_shader_private.hh.

Constructor & Destructor Documentation

◆ Shader()

Shader::Shader ( const char * name )

Definition at line 55 of file gpu_shader.cc.

References STRNCPY.

◆ ~Shader()

Shader::~Shader ( )

virtual

Definition at line 60 of file gpu_shader.cc.

Member Function Documentation

◆ bind()

virtual void blender::gpu::Shader::bind ( )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

Referenced by GPU_shader_bind().

◆ compute_layout_declare()

virtual std::string blender::gpu::Shader::compute_layout_declare ( const shader::ShaderCreateInfo & info ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ compute_shader_from_glsl()

virtual void blender::gpu::Shader::compute_shader_from_glsl ( MutableSpan< const char * > sources )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ defines_declare()

std::string Shader::defines_declare ( const shader::ShaderCreateInfo & info ) const

Definition at line 33 of file gpu_shader.cc.

References blender::gpu::shader::ShaderCreateInfo::defines_.

◆ finalize()

virtual bool blender::gpu::Shader::finalize ( const shader::ShaderCreateInfo * info = nullptr )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ fragment_interface_declare()

virtual std::string blender::gpu::Shader::fragment_interface_declare ( const shader::ShaderCreateInfo & info ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ fragment_shader_from_glsl()

virtual void blender::gpu::Shader::fragment_shader_from_glsl ( MutableSpan< const char * > sources )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ geometry_interface_declare()

virtual std::string blender::gpu::Shader::geometry_interface_declare ( const shader::ShaderCreateInfo & info ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ geometry_layout_declare()

virtual std::string blender::gpu::Shader::geometry_layout_declare ( const shader::ShaderCreateInfo & info ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ geometry_shader_from_glsl()

virtual void blender::gpu::Shader::geometry_shader_from_glsl ( MutableSpan< const char * > sources )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ get_ssbo_vertex_fetch_output_num_verts()

virtual int blender::gpu::Shader::get_ssbo_vertex_fetch_output_num_verts ( ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ get_uses_ssbo_vertex_fetch()

virtual bool blender::gpu::Shader::get_uses_ssbo_vertex_fetch ( ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ init()

virtual void blender::gpu::Shader::init	(	const shader::ShaderCreateInfo &	info,
		bool	is_batch_compilation )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

Referenced by blender::gpu::ShaderCompiler::compile().

◆ name_get()

const char *const blender::gpu::Shader::name_get ( ) const

inline

Definition at line 126 of file gpu_shader_private.hh.

References name.

Referenced by blender::gpu::MTLShader::bind(), blender::gpu::debug::check_gl_resources(), blender::gpu::MTLImmediate::end(), blender::gpu::MTLShader::finalize(), blender::gpu::MSLGeneratorInterface::generate_msl_compute_entry_stub(), blender::gpu::MSLGeneratorInterface::generate_msl_fragment_entry_stub(), blender::gpu::MSLGeneratorInterface::generate_msl_vertex_entry_stub(), blender::gpu::MTLShader::ssbo_vertex_fetch_bind_attributes_end(), blender::gpu::MTLShader::uniform_float(), blender::gpu::MTLShader::uniform_int(), and blender::gpu::MSLGeneratorInterface::use_argument_buffer_for_samplers().

◆ parent_get()

Shader * blender::gpu::Shader::parent_get ( ) const

inline

Definition at line 136 of file gpu_shader_private.hh.

References parent_shader_.

◆ parent_set()

void blender::gpu::Shader::parent_set ( Shader * parent )

inline

Definition at line 131 of file gpu_shader_private.hh.

References parent_shader_.

Referenced by GPU_shader_set_parent().

◆ print_log()

void Shader::print_log	(	Span< const char * >	sources,
		const char *	log,
		const char *	stage,
		bool	error,
		GPULogParser *	parser )

protected

Definition at line 40 of file gpu_shader_log.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::append(), BLI_dynstr_append(), BLI_dynstr_appendf(), BLI_dynstr_free(), BLI_dynstr_get_cstring(), BLI_dynstr_nappend(), BLI_dynstr_new(), BLI_string_join_arrayN(), blender::StringRefNull::c_str(), CLG_color_support_get(), CLG_FLAG_USE, CLG_log_str(), CLG_SEVERITY_ERROR, CLG_SEVERITY_WARN, blender::gpu::LogCursor::column, copy(), blender::gpu::GPULogItem::cursor, blender::Span< T >::data(), DEBUG_CONTEXT_LINES, DEBUG_LOG_SHADER_SRC_ON_ERROR, ELEM, blender::StringRefBase::endswith(), blender::gpu::Error, error(), blender::gpu::LogCursor::file_name_and_error_line, CLG_LogType::flag, blender::gpu::shader::gpu_shader_dependency_get_filename_from_source_string(), blender::Vector< T, InlineBufferCapacity, Allocator >::index_range(), blender::StringRefBase::is_empty(), blender::Vector< T, InlineBufferCapacity, Allocator >::is_empty(), blender::Vector< T, InlineBufferCapacity, Allocator >::last(), CLG_LogType::level, blender::gpu::LOG, log(), MEM_freeN(), blender::gpu::Note, blender::gpu::GPULogParser::parse_line(), blender::gpu::LogCursor::row, blender::gpu::GPULogItem::severity, blender::Span< T >::size(), blender::gpu::LogCursor::source, blender::gpu::GPULogItem::source_base_row, stage, blender::StringRefBase::substr(), CLG_LogRef::type, and blender::gpu::Warning.

Referenced by blender::gpu::MTLShader::bake_pipeline_state(), and blender::gpu::MTLShader::finalize().

◆ program_handle_get()

virtual int blender::gpu::Shader::program_handle_get ( ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ resources_declare()

virtual std::string blender::gpu::Shader::resources_declare ( const shader::ShaderCreateInfo & info ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ set_framebuffer_srgb_target()

void Shader::set_framebuffer_srgb_target ( int use_srgb_to_linear )

static

Definition at line 796 of file gpu_shader.cc.

References blender::gpu::g_shader_builtin_srgb_is_dirty, and blender::gpu::g_shader_builtin_srgb_transform.

Referenced by blender::gpu::GLFrameBuffer::bind(), blender::gpu::MTLFrameBuffer::bind(), and blender::gpu::VKFrameBuffer::bind().

◆ set_srgb_uniform()

void Shader::set_srgb_uniform ( GPUShader * shader )

static

Definition at line 787 of file gpu_shader.cc.

References blender::gpu::g_shader_builtin_srgb_is_dirty, blender::gpu::g_shader_builtin_srgb_transform, GPU_shader_get_builtin_uniform(), GPU_shader_uniform_int_ex(), and GPU_UNIFORM_SRGB_TRANSFORM.

◆ specialization_constants_init()

void Shader::specialization_constants_init ( const shader::ShaderCreateInfo & info )

Definition at line 481 of file gpu_shader.cc.

References blender::gpu::shader::ShaderCreateInfo::specialization_constants_.

◆ srgb_uniform_dirty_get()

bool Shader::srgb_uniform_dirty_get ( )

static

Definition at line 782 of file gpu_shader.cc.

References blender::gpu::g_shader_builtin_srgb_is_dirty.

◆ transform_feedback_disable()

virtual void blender::gpu::Shader::transform_feedback_disable ( )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ transform_feedback_enable()

virtual bool blender::gpu::Shader::transform_feedback_enable ( VertBuf * )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ transform_feedback_names_set()

virtual void blender::gpu::Shader::transform_feedback_names_set	(	Span< const char * >	name_list,
		eGPUShaderTFBType	geom_type )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ unbind()

virtual void blender::gpu::Shader::unbind ( )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

Referenced by GPU_shader_unbind().

◆ uniform_float()

virtual void blender::gpu::Shader::uniform_float	(	int	location,
		int	comp_len,
		int	array_size,
		const float *	data )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ uniform_int()

virtual void blender::gpu::Shader::uniform_int	(	int	location,
		int	comp_len,
		int	array_size,
		const int *	data )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ vertex_interface_declare()

virtual std::string blender::gpu::Shader::vertex_interface_declare ( const shader::ShaderCreateInfo & info ) const

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ vertex_shader_from_glsl()

virtual void blender::gpu::Shader::vertex_shader_from_glsl ( MutableSpan< const char * > sources )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

◆ warm_cache()

virtual void blender::gpu::Shader::warm_cache ( int limit )

pure virtual

Implemented in blender::gpu::GLShader, blender::gpu::MTLShader, and blender::gpu::VKShader.

Member Data Documentation

◆ constants

struct blender::gpu::Shader::Constants blender::gpu::Shader::constants

Referenced by blender::gpu::MTLShader::bake_compute_pipeline_state(), blender::gpu::MTLShader::bake_current_pipeline_state(), blender::gpu::MTLShader::bake_pipeline_state(), blender::gpu::GLShader::constants_declare(), blender::gpu::VKShader::ensure_and_get_compute_pipeline(), blender::gpu::VKShader::ensure_and_get_graphics_pipeline(), blender::gpu::MTLContext::ensure_compute_pipeline_state(), blender::gpu::MTLShader::finalize(), and blender::gpu::MTLParallelShaderCompiler::precompile_specializations().

◆ interface

ShaderInterface* blender::gpu::Shader::interface = nullptr

Uniform & attribute locations for shader.

Definition at line 47 of file gpu_shader_private.hh.

Referenced by blender::gpu::MTLShader::bind(), blender::gpu::MTLShader::get_interface(), blender::gpu::VKShader::interface_get(), blender::gpu::MTLParallelShaderCompiler::precompile_specializations(), blender::gpu::MTLShader::prepare_ssbo_vertex_fetch_metadata(), and blender::gpu::MTLShader::set_interface().

◆ name

char blender::gpu::Shader::name[64]

protected

For debugging purpose.

Definition at line 70 of file gpu_shader_private.hh.

Referenced by blender::gpu::MTLShader::bake_compute_pipeline_state(), blender::gpu::MTLShader::bake_pipeline_state(), blender::gpu::MTLShader::finalize(), and name_get().

◆ parent_shader_

Shader* blender::gpu::Shader::parent_shader_ = nullptr

protected

Definition at line 76 of file gpu_shader_private.hh.

Referenced by blender::gpu::MTLShader::has_parent_shader(), parent_get(), parent_set(), and blender::gpu::MTLShader::warm_cache().

The documentation for this class was generated from the following files:

Classes

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Shader()

◆ ~Shader()

Member Function Documentation

◆ bind()

◆ compute_layout_declare()

◆ compute_shader_from_glsl()

◆ defines_declare()

◆ finalize()

◆ fragment_interface_declare()

◆ fragment_shader_from_glsl()

◆ geometry_interface_declare()

◆ geometry_layout_declare()

◆ geometry_shader_from_glsl()

◆ get_ssbo_vertex_fetch_output_num_verts()

◆ get_uses_ssbo_vertex_fetch()

◆ init()

◆ name_get()

◆ parent_get()

◆ parent_set()

◆ print_log()

◆ program_handle_get()

◆ resources_declare()

◆ set_framebuffer_srgb_target()

◆ set_srgb_uniform()

◆ specialization_constants_init()

◆ srgb_uniform_dirty_get()

◆ transform_feedback_disable()

◆ transform_feedback_enable()

◆ transform_feedback_names_set()

◆ unbind()

◆ uniform_float()

◆ uniform_int()

◆ vertex_interface_declare()

◆ vertex_shader_from_glsl()

◆ warm_cache()

Member Data Documentation

◆ constants

◆ interface

◆ name

◆ parent_shader_