|
Blender V5.3
|
Describe inputs & outputs, stage interfaces, resources and sources of a shader. If all data is correctly provided, this is all that is needed to create and compile a #gpu::Shader. More...
#include <gpu_shader_create_info.hh>
Inherited by blender::gpu::shader::GPUCodegenCreateInfo.
Classes | |
| struct | Conditions |
| struct | BuiltinBit |
| struct | VertIn |
| struct | GeometryStageLayout |
| struct | ComputeStageLayout |
| struct | FragOut |
| struct | SubpassIn |
| struct | SharedVariable |
| struct | Sampler |
| struct | Image |
| struct | UniformBuf |
| struct | StorageBuf |
| struct | AccelerationStructure |
| struct | Resource |
| struct | StageInterfaceInfoHandle |
| struct | PushConst |
| struct | AdditionalInfo |
Public Types | |
| using | ConditionFn = std::function<bool(Span<CompilationConstant>)> |
| using | Self = ShaderCreateInfo |
Public Member Functions | |
| BuiltinBits | builtins_combined () const |
| Vector< Resource, 0 > & | resources_get_ (Frequency freq) |
| Vector< Resource > | resources_get_all_ () const |
| ShaderCreateInfo (const char *name) | |
| ~ShaderCreateInfo ()=default | |
| Self & | noop () |
Shaders in/outs (fixed function pipeline config) | |
| Self & | vertex_in (int slot, Type type, StringRefNull name, ConditionFn cond=nullptr) |
| Self & | vertex_out (StageInterfaceInfo &interface, ConditionFn cond=nullptr) |
| Self & | geometry_layout (PrimitiveIn prim_in, PrimitiveOut prim_out, int max_vertices, int invocations=-1) |
| Self & | local_group_size (int local_size_x, int local_size_y=1, int local_size_z=1) |
| Self & | early_fragment_test (bool enable) |
| Self & | geometry_out (StageInterfaceInfo &interface, ConditionFn cond=nullptr) |
| Self & | fragment_out (int slot, Type type, StringRefNull name, DualBlend blend=DualBlend::NONE, int raster_order_group=-1, ConditionFn cond=nullptr) |
| Self & | subpass_in (int slot, Type type, ImageType img_type, StringRefNull name, int raster_order_group=-1) |
| Self & | shared_resource_descriptor (void(*fn)(ShaderCreateInfo &)) |
Shader compilation constants | |
Compilation constants are constants defined in the create info. They cannot be changed after the shader is created. It is a replacement to macros with added type safety. | |
| Self & | compilation_constant (Type type, StringRefNull name, double default_value) |
Shader specialization constants | |
| Self & | specialization_constant (Type type, StringRefNull name, double default_value) |
Compute shader Shared variables | |
| Self & | shared_variable (Type type, StringRefNull name) |
Resources bindings points | |
| Self & | uniform_buf (int slot, StringRefNull type_name, StringRefNull name, Frequency freq=Frequency::PASS, ConditionFn cond=nullptr) |
| Self & | storage_buf (int slot, Qualifier qualifiers, StringRefNull type_name, StringRefNull name, Frequency freq=Frequency::PASS, ConditionFn cond=nullptr) |
| Self & | acceleration_structure (int slot, StringRefNull name, Frequency freq=Frequency::PASS, ConditionFn cond=nullptr) |
| Self & | image (int slot, TextureFormat format, Qualifier qualifiers, ImageReadWriteType type, StringRefNull name, Frequency freq=Frequency::PASS, ConditionFn cond=nullptr) |
| Self & | sampler (int slot, ImageType type, StringRefNull name, Frequency freq=Frequency::PASS, ConditionFn cond=nullptr) |
Shader Source | |
| Self & | vertex_source (StringRefNull filename) |
| Self & | fragment_source (StringRefNull filename) |
| Self & | compute_source (StringRefNull filename) |
| Self & | vertex_function (StringRefNull function_name) |
| Self & | fragment_function (StringRefNull function_name) |
| Self & | compute_function (StringRefNull function_name) |
Push constants | |
Data managed by gpu::Shader. Can be set through uniform functions. Must be less than 128bytes. | |
| Self & | push_constant (Type type, StringRefNull name, int array_size=0, ConditionFn cond=nullptr) |
Defines | |
| Self & | define (StringRefNull name, StringRefNull value="") |
| Self & | do_static_compilation (bool value) |
| Self & | builtins (BuiltinBits builtin, ConditionFn cond=nullptr) |
| Self & | depth_write (DepthWrite value) |
| Self & | metal_backend_only (bool flag) |
Additional Create Info | |
Used to share parts of the infos that are common to many shaders. | |
| Self & | additional_info (StringRefNull info_name) |
| template<typename... Args> | |
| Self & | additional_info (StringRefNull info_name, Args... args) |
| Self & | additional_info_with_condition (StringRefNull info_name, ConditionFn cond=nullptr) |
Typedef Sources | |
Some resource declarations might need some special structure defined. Adding a file using typedef_source will include it before the resource and interface definitions. | |
| Self & | typedef_source (StringRefNull filename) |
mtl_max_total_threads_per_threadgroup | |
max_total_threads_per_threadgroup - Provides compiler hint for maximum threadgroup size up front. Maximum value is 1024. | |
| Self & | mtl_max_total_threads_per_threadgroup (ushort max_total_threads_per_threadgroup) |
Recursive evaluation. | |
Flatten all dependency so that this descriptor contains all the data from the additional descriptors. This avoids tedious traversal in shader source creation. | |
| void | finalize (const bool recursive=false) |
| std::string | resource_guard_defines (Span< CompilationConstant > constants) const |
| std::string | iface_guard_defines () const |
| void | extend_predicate (Vector< Resource, 0 > &resource_vector, ShaderCreateInfo::Resource res_copy, Span< ConditionFn > additional_conditions) const |
| void | extend_predicate (Vector< PushConst, 0 > &resource_vector, ShaderCreateInfo::PushConst res_copy, Span< ConditionFn > additional_conditions) const |
| void | assert_no_overlap (const ShaderCreateInfo &info, const bool test, const StringRefNull error) const |
| void | set_resource_slot (Resource &res, int &images, int &samplers, int &ubos, int &ssbos, int &acceleration_structures) const |
| std::string | check_error () const |
| bool | is_vulkan_compatible () const |
| void | validate_merge (const ShaderCreateInfo &other_info) |
| void | validate_vertex_attributes (const ShaderCreateInfo *other_info=nullptr) |
Pipeline warm-up | |
| PipelineState & | pipeline_state () |
| Create a new pipeline state. | |
Static Public Member Functions | |
| static int | find_constant (Span< CompilationConstant > constants, StringRefNull name) |
Operators. | |
| bool | operator== (const ShaderCreateInfo &b) const |
| bool | has_resource_type (Resource::BindType bind_type) const |
| bool | has_resource_image () const |
| int | sampler_count () const |
| int | max_sampler_slot () const |
| std::ostream & | operator<< (std::ostream &stream, const ShaderCreateInfo &info) |
Describe inputs & outputs, stage interfaces, resources and sources of a shader. If all data is correctly provided, this is all that is needed to create and compile a #gpu::Shader.
IMPORTANT: All strings are references only. Make sure all the strings used by a ShaderCreateInfo are not freed until it is consumed or deleted.
Definition at line 799 of file gpu_shader_create_info.hh.
| using blender::gpu::shader::ShaderCreateInfo::ConditionFn = std::function<bool(Span<CompilationConstant>)> |
Definition at line 800 of file gpu_shader_create_info.hh.
Definition at line 1193 of file gpu_shader_create_info.hh.
| ShaderCreateInfo::ShaderCreateInfo | ( | const char * | name | ) |
Definition at line 101 of file gpu_shader_create_info.cc.
References name_.
Referenced by assert_no_overlap(), finalize(), blender::gpu::shader::GPUCodegenCreateInfo::GPUCodegenCreateInfo(), operator<<, operator==(), blender::gpu::shader::ShaderCreateInfo::Resource::Resource(), resource_guard_defines(), shared_resource_descriptor(), validate_merge(), and validate_vertex_attributes().
|
default |
|
inline |
Definition at line 1437 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Resource::ACCELERATION_STRUCTURE, builtins(), interface_names_size_, blender::gpu::shader::PASS, blender::gpu::shader::RAY_QUERY, resources_get_(), and blender::blender::StringRefBase::size().
Referenced by blender::gpu::shader::ShaderCreateInfo::Resource::operator==().
|
inline |
Definition at line 1599 of file gpu_shader_create_info.hh.
References additional_infos_.
Referenced by blender::eevee::add_pipeline_create_info(), additional_info(), finalize(), blender::eevee::ShaderModule::material_create_info_amend(), and resource_guard_defines().
|
inline |
Definition at line 1605 of file gpu_shader_create_info.hh.
References additional_info().
|
inline |
Definition at line 1612 of file gpu_shader_create_info.hh.
References additional_infos_, and blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions().
| void ShaderCreateInfo::assert_no_overlap | ( | const ShaderCreateInfo & | info, |
| const bool | test, | ||
| const StringRefNull | error ) const |
Definition at line 298 of file gpu_shader_create_info.cc.
References blender::BLI_assert(), name_, and ShaderCreateInfo().
Referenced by finalize().
|
inline |
Definition at line 1572 of file gpu_shader_create_info.hh.
References builtins_, and blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions().
Referenced by acceleration_structure(), blender::gpu::ShaderCompiler::compile(), blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::GPU_shader_create_from_info_python(), blender::GPU_shader_preprocess_source(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::tests::test_framebuffer_multi_viewport(), blender::gpu::tests::test_framebuffer_subpass_input(), and blender::gpu::tests::test_shader_create_info_pipeline().
|
inline |
Definition at line 858 of file gpu_shader_create_info.hh.
References builtins_, and blender::gpu::shader::NONE.
Referenced by blender::gpu::available_buffer_slots(), check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), blender::gpu::generate_builtins(), blender::gpu::generate_fragment_builtins(), blender::gpu::generate_raster_builtins(), blender::gpu::generate_resources(), blender::gpu::get_stage_out_class_name(), blender::GPU_shader_preprocess_source(), blender::gpu::VKShader::init(), blender::gpu::VKShaderInterface::init(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), blender::gpu::GLShader::vertex_interface_declare(), and blender::gpu::VKShader::vertex_interface_declare().
| std::string ShaderCreateInfo::check_error | ( | ) | const |
Definition at line 335 of file gpu_shader_create_info.cc.
References blender::gpu::shader::ShaderCreateInfo::Resource::ACCELERATION_STRUCTURE, blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::add(), blender::gpu::shader::BARYCENTRIC_COORD, batch_resources_, blender::gpu::shader::ShaderCreateInfo::Resource::bind_type, builtins_combined(), compilation_constants_, compute_source_, ELEM, blender::gpu::shader::float3x3_t, blender::gpu::shader::float4x4_t, fragment_source_, blender::G, blender::G_DEBUG_GPU, geometry_resources_, geometry_source_, blender::gpu::shader::ShaderCreateInfo::Resource::IMAGE, blender::gpu::shader::metadata::inout, blender::blender::StringRefBase::is_empty(), is_vulkan_compatible(), blender::gpu::shader::LAYER, name_, pass_resources_, resources_get_all_(), blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER, shared_variables_, blender::gpu::shader::ShaderCreateInfo::Resource::slot, specialization_constants_, blender::gpu::shader::ShaderCreateInfo::Resource::STORAGE_BUFFER, blender::gpu::shader::ShaderCreateInfo::Resource::UNIFORM_BUFFER, vertex_out_interfaces_, vertex_source_, and blender::gpu::shader::VIEWPORT_INDEX.
Referenced by blender::gpu::ShaderCompiler::compile(), and blender::GPU_shader_create_info_check_error().
|
inline |
Definition at line 1310 of file gpu_shader_create_info.hh.
References BLI_assert_msg, blender::gpu::shader::bool_t, compilation_constants_, blender::gpu::shader::int_t, interface_names_size_, blender::gpu::shader::CompilationConstant::name, blender::blender::StringRefBase::size(), blender::gpu::shader::CompilationConstant::type, blender::gpu::shader::uint_t, and blender::gpu::shader::CompilationConstant::value.
Referenced by blender::eevee::add_pipeline_create_info(), and blender::eevee::ShaderModule::material_create_info_amend().
|
inline |
Definition at line 1518 of file gpu_shader_create_info.hh.
References compute_entry_fn_.
|
inline |
Definition at line 1500 of file gpu_shader_create_info.hh.
References compute_source_, and blender::gpu::shader::parser::filename().
Referenced by blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), blender::GPU_shader_create_from_info_python(), and blender::pygpu_shader_info_compute_source().
|
inline |
Definition at line 1554 of file gpu_shader_create_info.hh.
References defines_.
Referenced by blender::eevee::add_pipeline_create_info(), blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::GPU_shader_create_from_info_python(), blender::GPU_shader_preprocess_source(), blender::eevee::ShaderModule::material_create_info_amend(), blender::pygpu_shader_info_define(), and blender::gpu::tests::test_framebuffer_subpass_input().
|
inline |
Definition at line 1579 of file gpu_shader_create_info.hh.
References depth_write_.
Referenced by blender::pygpu_shader_info_depth_write().
|
inline |
Definition at line 1566 of file gpu_shader_create_info.hh.
References do_static_compilation_.
|
inline |
Force fragment tests before fragment shader invocation. IMPORTANT: This is incompatible with using the gl_FragDepth output.
Definition at line 1243 of file gpu_shader_create_info.hh.
References early_fragment_test_.
| void ShaderCreateInfo::extend_predicate | ( | Vector< PushConst, 0 > & | resource_vector, |
| ShaderCreateInfo::PushConst | res_copy, | ||
| Span< ConditionFn > | additional_conditions ) const |
IMPORTANT: We keep duplicates until we evaluate the conditions.
Definition at line 289 of file gpu_shader_create_info.cc.
References blender::gpu::shader::ShaderCreateInfo::PushConst::conditions.
| void ShaderCreateInfo::extend_predicate | ( | Vector< Resource, 0 > & | resource_vector, |
| ShaderCreateInfo::Resource | res_copy, | ||
| Span< ConditionFn > | additional_conditions ) const |
IMPORTANT: We keep duplicates until we evaluate the conditions.
Definition at line 280 of file gpu_shader_create_info.cc.
References blender::gpu::shader::ShaderCreateInfo::Resource::conditions.
Referenced by finalize().
| void ShaderCreateInfo::finalize | ( | const bool | recursive = false | ) |
Definition at line 141 of file gpu_shader_create_info.cc.
References additional_info(), additional_infos_, assert_no_overlap(), batch_resources_, blender::BLI_assert(), builtins_, builtins_combined(), compilation_constants_, compute_entry_fn_, compute_layout_, compute_source_, defines_, depth_write_, early_fragment_test_, extend_predicate(), finalize(), finalized_, fragment_entry_fn_, fragment_outputs_, fragment_source_, geometry_entry_fn_, geometry_layout_, geometry_out_interfaces_, geometry_resources_, geometry_source_, blender::gpu_shader_create_info_get(), interface_names_size_, blender::blender::StringRefBase::is_empty(), blender::gpu::shader::LAYER, blender::gpu::shader::ShaderCreateInfo::ComputeStageLayout::local_size_x, name_, pass_resources_, push_constants_, ShaderCreateInfo(), shared_variables_, specialization_constants_, subpass_inputs_, typedef_sources_, blender::gpu::shader::UNCHANGED, validate_vertex_attributes(), vertex_entry_fn_, vertex_inputs_, vertex_out_interfaces_, and vertex_source_.
Referenced by blender::compositor::CachedShader::CachedShader(), finalize(), and blender::GPU_generate_pass().
|
inlinestatic |
Definition at line 972 of file gpu_shader_create_info.hh.
|
inline |
Definition at line 1512 of file gpu_shader_create_info.hh.
References fragment_entry_fn_.
Referenced by blender::eevee::add_pipeline_create_info().
|
inline |
Definition at line 1261 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions(), fragment_outputs_, blender::gpu::shader::NONE, and raster_order_group.
Referenced by blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::pygpu_shader_info_fragment_out(), blender::gpu::tests::test_framebuffer_multi_viewport(), blender::gpu::tests::test_framebuffer_subpass_input(), blender::gpu::tests::test_shader_create_info_pipeline(), and blender::gpu::tests::test_shader_python_graphic().
|
inline |
Definition at line 1494 of file gpu_shader_create_info.hh.
References blender::gpu::shader::parser::filename(), and fragment_source_.
Referenced by blender::eevee::add_pipeline_create_info(), blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::GPU_shader_create_from_info_python(), blender::pygpu_shader_info_fragment_source(), blender::gpu::tests::test_framebuffer_multi_viewport(), blender::gpu::tests::test_framebuffer_subpass_input(), and blender::gpu::tests::test_shader_create_info_pipeline().
|
inline |
Definition at line 1219 of file gpu_shader_create_info.hh.
References geometry_layout_, blender::gpu::shader::ShaderCreateInfo::GeometryStageLayout::invocations, blender::gpu::shader::ShaderCreateInfo::GeometryStageLayout::max_vertices, blender::gpu::shader::ShaderCreateInfo::GeometryStageLayout::primitive_in, and blender::gpu::shader::ShaderCreateInfo::GeometryStageLayout::primitive_out.
|
inline |
Only needed if geometry shader is enabled. IMPORTANT: Input and output instance name will have respectively "_in" and "_out" suffix appended in the geometry shader IF AND ONLY IF the vertex_out interface instance name matches the geometry_out interface instance name.
Definition at line 1255 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions(), and geometry_out_interfaces_.
|
inline |
Definition at line 1796 of file gpu_shader_create_info.hh.
References has_resource_type(), and blender::gpu::shader::ShaderCreateInfo::Resource::IMAGE.
|
inline |
Definition at line 1776 of file gpu_shader_create_info.hh.
References batch_resources_, geometry_resources_, and pass_resources_.
Referenced by has_resource_image().
| std::string ShaderCreateInfo::iface_guard_defines | ( | ) | const |
Definition at line 132 of file gpu_shader_create_info.cc.
References vertex_out_interfaces_.
Referenced by blender::gpu::ShaderCompiler::compile().
|
inline |
Definition at line 1450 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Resource::IMAGE, interface_names_size_, blender::gpu::shader::PASS, resources_get_(), and blender::blender::StringRefBase::size().
Referenced by blender::gpu::shader::ShaderCreateInfo::Resource::operator==(), blender::pygpu_shader_info_image(), and blender::gpu::tests::test_shader_python_compute().
| bool ShaderCreateInfo::is_vulkan_compatible | ( | ) | const |
Definition at line 82 of file gpu_shader_create_info.cc.
References geometry_out_interfaces_, blender::gpu::shader::is_vulkan_compatible_interface(), and vertex_out_interfaces_.
Referenced by check_error().
|
inline |
Definition at line 1231 of file gpu_shader_create_info.hh.
References compute_layout_, blender::gpu::shader::ShaderCreateInfo::ComputeStageLayout::local_size_x, blender::gpu::shader::ShaderCreateInfo::ComputeStageLayout::local_size_y, and blender::gpu::shader::ShaderCreateInfo::ComputeStageLayout::local_size_z.
Referenced by blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), blender::pygpu_shader_info_local_group_size(), and blender::gpu::tests::test_shader_python_compute().
|
inline |
Definition at line 1816 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER.
Referenced by blender::gpu::generate_resources(), and blender::gpu::MTLShader::patch_create_info().
|
inline |
Definition at line 1585 of file gpu_shader_create_info.hh.
References metal_backend_only_.
|
inline |
Definition at line 1649 of file gpu_shader_create_info.hh.
References UNUSED_VARS.
|
inline |
Definition at line 1196 of file gpu_shader_create_info.hh.
|
inline |
Definition at line 1707 of file gpu_shader_create_info.hh.
References additional_infos_, b, batch_resources_, builtins_, compute_layout_, compute_source_, compute_source_generated, defines_, fragment_outputs_, fragment_source_, fragment_source_generated, geometry_layout_, geometry_out_interfaces_, geometry_resources_, geometry_source_, pass_resources_, push_constants_, ShaderCreateInfo(), subpass_inputs_, TEST_EQUAL, TEST_VECTOR_EQUAL, typedef_source_generated, typedef_sources_, vertex_inputs_, vertex_out_interfaces_, vertex_source_, and vertex_source_generated.
|
inline |
Create a new pipeline state.
On Metal and Vulkan pipelines states will be pre-compiled when creating the shader to reduce compilation stuttering when using the shader.
Definition at line 1852 of file gpu_shader_create_info.hh.
References pipelines_.
Referenced by blender::gpu::tests::test_shader_create_info_pipeline().
|
inline |
Definition at line 1533 of file gpu_shader_create_info.hh.
References blender::BLI_assert(), BLI_assert_msg, blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions(), blender::blender::StringRefBase::find(), interface_names_size_, push_constants_, blender::blender::StringRefBase::size(), and blender::gpu::shader::uint_t.
Referenced by blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), blender::ocio::GPUShaderBinder::create_gpu_shader(), and blender::pygpu_shader_info_push_constant().
| std::string ShaderCreateInfo::resource_guard_defines | ( | Span< CompilationConstant > | constants | ) | const |
Definition at line 117 of file gpu_shader_create_info.cc.
References additional_info(), additional_infos_, blender::gpu_shader_create_info_get(), name_, resource_guard_defines(), and ShaderCreateInfo().
Referenced by blender::gpu::ShaderCompiler::compile(), and resource_guard_defines().
|
inline |
Definition at line 1086 of file gpu_shader_create_info.hh.
References blender::gpu::shader::BATCH, batch_resources_, BLI_assert_unreachable, blender::gpu::shader::GEOMETRY, geometry_resources_, blender::gpu::shader::PASS, and pass_resources_.
Referenced by acceleration_structure(), image(), sampler(), storage_buf(), and uniform_buf().
Definition at line 1101 of file gpu_shader_create_info.hh.
References batch_resources_, geometry_resources_, and pass_resources_.
Referenced by check_error(), blender::gpu::GLShaderInterface::GLShaderInterface(), blender::gpu_pass_validate(), and validate_merge().
|
inline |
Definition at line 1468 of file gpu_shader_create_info.hh.
References interface_names_size_, blender::gpu::shader::PASS, resources_get_(), blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER, and blender::blender::StringRefBase::size().
Referenced by blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::gpu::shader::GPUCodegen::generate_resources(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::shader::ShaderCreateInfo::Resource::operator==(), and blender::pygpu_shader_info_sampler().
|
inline |
Definition at line 1801 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER.
| void ShaderCreateInfo::set_resource_slot | ( | Resource & | res, |
| int & | images, | ||
| int & | samplers, | ||
| int & | ubos, | ||
| int & | ssbos, | ||
| int & | acceleration_structures ) const |
Definition at line 309 of file gpu_shader_create_info.cc.
References blender::gpu::shader::ShaderCreateInfo::Resource::ACCELERATION_STRUCTURE, blender::gpu::shader::ShaderCreateInfo::Resource::bind_type, blender::gpu::shader::ShaderCreateInfo::Resource::IMAGE, blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER, blender::gpu::shader::ShaderCreateInfo::Resource::slot, blender::gpu::shader::ShaderCreateInfo::Resource::STORAGE_BUFFER, and blender::gpu::shader::ShaderCreateInfo::Resource::UNIFORM_BUFFER.
|
inline |
Definition at line 1294 of file gpu_shader_create_info.hh.
References ShaderCreateInfo().
|
inline |
Definition at line 1395 of file gpu_shader_create_info.hh.
References shared_variables_.
|
inline |
Definition at line 1360 of file gpu_shader_create_info.hh.
References BLI_assert_msg, blender::gpu::shader::bool_t, float, blender::gpu::shader::float_t, blender::gpu::shader::int_t, interface_names_size_, blender::gpu::shader::SpecializationConstant::name, blender::blender::StringRefBase::size(), specialization_constants_, blender::gpu::shader::SpecializationConstant::type, blender::gpu::shader::uint_t, and blender::gpu::shader::SpecializationConstant::value.
|
inline |
Definition at line 1421 of file gpu_shader_create_info.hh.
References interface_names_size_, blender::gpu::shader::PASS, resources_get_(), blender::blender::StringRefBase::size(), and blender::gpu::shader::ShaderCreateInfo::Resource::STORAGE_BUFFER.
Referenced by blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), and blender::pygpu_shader_info_storage_buf().
|
inline |
Allows to fetch frame-buffer values from previous render sub-pass.
On Apple Silicon, the additional raster_order_group is there to set the sub-pass dependencies. Any sub-pass input need to have the same raster_order_group defined in the shader writing them.
IMPORTANT: Currently emulated on all backend except Metal. This is only for debugging purpose as it is too slow to be viable.
TODO(fclem): Vulkan can implement that using subpassInput. However sub-pass boundaries might be difficult to inject implicitly and will require more high level changes. TODO(fclem): OpenGL can emulate that using GL_EXT_shader_framebuffer_fetch.
Definition at line 1287 of file gpu_shader_create_info.hh.
References raster_order_group, and subpass_inputs_.
Referenced by blender::gpu::tests::test_framebuffer_subpass_input().
|
inline |
Definition at line 1628 of file gpu_shader_create_info.hh.
References blender::gpu::shader::parser::filename(), and typedef_sources_.
Referenced by blender::opensubdiv::compile_eval_patches_shader(), blender::opensubdiv::compile_eval_stencil_shader(), blender::ocio::GPUShaderBinder::create_gpu_shader(), and blender::pygpu_shader_info_typedef_source().
|
inline |
Definition at line 1407 of file gpu_shader_create_info.hh.
References interface_names_size_, blender::gpu::shader::PASS, resources_get_(), blender::blender::StringRefBase::size(), and blender::gpu::shader::ShaderCreateInfo::Resource::UNIFORM_BUFFER.
Referenced by blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::gpu::shader::GPUCodegen::generate_resources(), and blender::pygpu_shader_info_uniform_buf().
| void ShaderCreateInfo::validate_merge | ( | const ShaderCreateInfo & | other_info | ) |
Error detection that some backend compilers do not complain about.
Definition at line 522 of file gpu_shader_create_info.cc.
References blender::gpu::shader::ShaderCreateInfo::Resource::ACCELERATION_STRUCTURE, blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::add(), batch_resources_, blender::gpu::shader::ShaderCreateInfo::Resource::bind_type, geometry_resources_, blender::gpu::shader::ShaderCreateInfo::Resource::IMAGE, name_, pass_resources_, resources_get_all_(), blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER, ShaderCreateInfo(), blender::gpu::shader::ShaderCreateInfo::Resource::slot, blender::gpu::shader::ShaderCreateInfo::Resource::STORAGE_BUFFER, and blender::gpu::shader::ShaderCreateInfo::Resource::UNIFORM_BUFFER.
| void ShaderCreateInfo::validate_vertex_attributes | ( | const ShaderCreateInfo * | other_info = nullptr | ) |
Definition at line 598 of file gpu_shader_create_info.cc.
References blender::BLI_assert(), blender::gpu::shader::float3x3_t, blender::gpu::shader::float4x4_t, name_, ShaderCreateInfo(), and vertex_inputs_.
Referenced by finalize().
|
inline |
Definition at line 1506 of file gpu_shader_create_info.hh.
References vertex_entry_fn_.
Referenced by blender::eevee::add_pipeline_create_info().
|
inline |
Definition at line 1205 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions(), interface_names_size_, blender::blender::StringRefBase::size(), and vertex_inputs_.
Referenced by blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::gpu::shader::GPUCodegen::generate_attribs(), blender::eevee::ShaderModule::material_create_info_amend(), blender::pygpu_shader_info_vertex_in(), and blender::gpu::tests::test_shader_python_graphic().
|
inline |
Definition at line 1212 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Conditions::Conditions(), and vertex_out_interfaces_.
Referenced by blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::gpu::shader::GPUCodegen::generate_attribs(), and blender::pygpu_shader_info_vertex_out().
|
inline |
Definition at line 1488 of file gpu_shader_create_info.hh.
References blender::gpu::shader::parser::filename(), and vertex_source_.
Referenced by blender::eevee::add_pipeline_create_info(), blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::GPU_shader_create_from_info_python(), blender::pygpu_shader_info_vertex_source(), blender::gpu::tests::test_framebuffer_multi_viewport(), blender::gpu::tests::test_framebuffer_subpass_input(), and blender::gpu::tests::test_shader_create_info_pipeline().
|
friend |
Debug print
Definition at line 1736 of file gpu_shader_create_info.hh.
References blender::gpu::shader::ShaderCreateInfo::Resource::ACCELERATION_STRUCTURE, batch_resources_, geometry_resources_, blender::gpu::shader::ShaderCreateInfo::Resource::IMAGE, pass_resources_, blender::gpu::shader::ShaderCreateInfo::Resource::SAMPLER, ShaderCreateInfo(), blender::gpu::shader::ShaderCreateInfo::Resource::STORAGE_BUFFER, and blender::gpu::shader::ShaderCreateInfo::Resource::UNIFORM_BUFFER.
| Vector<AdditionalInfo, 0> blender::gpu::shader::ShaderCreateInfo::additional_infos_ |
Definition at line 1179 of file gpu_shader_create_info.hh.
Referenced by additional_info(), additional_info_with_condition(), finalize(), operator==(), and resource_guard_defines().
Definition at line 1084 of file gpu_shader_create_info.hh.
Referenced by blender::eevee::add_pipeline_create_info(), blender::gpu::available_buffer_slots(), check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::generate_resources(), has_resource_type(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), operator<<, operator==(), blender::gpu::patch_create_info_atomic_workaround(), blender::gpu::GLShader::resources_declare(), blender::gpu::VKShader::resources_declare(), resources_get_(), resources_get_all_(), blender::gpu::ShaderInterface::set_image_formats_from_info(), and validate_merge().
| Vector<BuiltinBit, 0> blender::gpu::shader::ShaderCreateInfo::builtins_ |
Definition at line 856 of file gpu_shader_create_info.hh.
Referenced by builtins(), builtins_combined(), blender::gpu::ShaderCompiler::compile(), finalize(), and operator==().
| Vector<CompilationConstant, 0> blender::gpu::shader::ShaderCreateInfo::compilation_constants_ |
Definition at line 969 of file gpu_shader_create_info.hh.
Referenced by check_error(), compilation_constant(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::generate_resources(), blender::eevee::SlotAllocator::reserve_slots(), blender::gpu::GLShader::resources_declare(), and blender::gpu::VKShader::resources_declare().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::compute_entry_fn_ = "main" |
Definition at line 1161 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile(), compute_function(), and finalize().
| ComputeStageLayout blender::gpu::shader::ShaderCreateInfo::compute_layout_ |
Definition at line 925 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::GLShader::compute_layout_declare(), blender::gpu::VKShader::compute_layout_declare(), blender::gpu::MTLShader::finalize(), finalize(), local_group_size(), and operator==().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::compute_source_ |
Definition at line 1159 of file gpu_shader_create_info.hh.
Referenced by check_error(), blender::gpu::ShaderCompiler::compile(), compute_source(), finalize(), blender::gpu::tests::gpu_shader_lib_test(), blender::gpu::VKShader::init(), blender::gpu::tests::ShaderSpecializationConst::init_shader(), and operator==().
| std::string blender::gpu::shader::ShaderCreateInfo::compute_source_generated |
Definition at line 870 of file gpu_shader_create_info.hh.
Referenced by blender::GPU_shader_create_from_info_python(), blender::gpu::VKShader::init(), operator==(), blender::pygpu_shader_info_compute_source(), and blender::gpu::tests::test_shader_python_compute().
| Vector<std::array<StringRefNull, 2>, 0> blender::gpu::shader::ShaderCreateInfo::defines_ |
Definition at line 1163 of file gpu_shader_create_info.hh.
Referenced by define(), blender::gpu::Shader::defines_declare(), finalize(), and operator==().
| Vector<StringRefNull, 0> blender::gpu::shader::ShaderCreateInfo::dependencies_generated |
Manually set generated dependencies file names.
Definition at line 874 of file gpu_shader_create_info.hh.
| DepthWrite blender::gpu::shader::ShaderCreateInfo::depth_write_ = DepthWrite::UNCHANGED |
Allow optimization when fragment shader writes to gl_FragDepth.
Definition at line 834 of file gpu_shader_create_info.hh.
Referenced by depth_write(), finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), blender::gpu::generate_fragment_builtins(), and blender::gpu::get_stage_out_class_name().
| bool blender::gpu::shader::ShaderCreateInfo::do_static_compilation_ = false |
True if the shader is static and can be pre-compiled at compile time.
Definition at line 826 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile(), do_static_compilation(), blender::GPU_shader_create_from_info_name(), and blender::gpu::VKShader::init().
| bool blender::gpu::shader::ShaderCreateInfo::early_fragment_test_ = false |
If true, force depth and stencil tests to always happen before fragment shader invocation.
Definition at line 832 of file gpu_shader_create_info.hh.
Referenced by early_fragment_test(), finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), and blender::gpu::generate_entry_point().
| bool blender::gpu::shader::ShaderCreateInfo::finalized_ = false |
If true, all additionally linked create info will be merged into this one.
Definition at line 830 of file gpu_shader_create_info.hh.
Referenced by finalize().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::fragment_entry_fn_ = "main" |
Definition at line 1161 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile(), finalize(), and fragment_function().
Definition at line 946 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), fragment_out(), blender::gpu::generate_fragment_out(), blender::gpu::get_stage_out_class_name(), and operator==().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::fragment_source_ |
Definition at line 1159 of file gpu_shader_create_info.hh.
Referenced by check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::VKShader::fragment_interface_declare(), fragment_source(), and operator==().
| std::string blender::gpu::shader::ShaderCreateInfo::fragment_source_generated |
Definition at line 869 of file gpu_shader_create_info.hh.
Referenced by blender::GPU_shader_create_from_info_python(), operator==(), blender::pygpu_shader_info_fragment_source(), and blender::gpu::tests::test_shader_python_graphic().
| GeneratedSourceList blender::gpu::shader::ShaderCreateInfo::generated_sources |
| StringRefNull blender::gpu::shader::ShaderCreateInfo::geometry_entry_fn_ = "main" |
Definition at line 1160 of file gpu_shader_create_info.hh.
Referenced by finalize().
| GeometryStageLayout blender::gpu::shader::ShaderCreateInfo::geometry_layout_ |
Definition at line 910 of file gpu_shader_create_info.hh.
Referenced by finalize(), geometry_layout(), blender::gpu::GLShader::geometry_layout_declare(), blender::gpu::VKShader::geometry_layout_declare(), and operator==().
| Vector<StageInterfaceInfoHandle, 0> blender::gpu::shader::ShaderCreateInfo::geometry_out_interfaces_ |
Definition at line 1127 of file gpu_shader_create_info.hh.
Referenced by finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), blender::gpu::GLShader::geometry_interface_declare(), blender::gpu::VKShader::geometry_interface_declare(), geometry_out(), is_vulkan_compatible(), and operator==().
Definition at line 1084 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::available_buffer_slots(), check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::generate_resources(), blender::gpu::GLShaderInterface::GLShaderInterface(), has_resource_type(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), operator<<, operator==(), blender::gpu::patch_create_info_atomic_workaround(), blender::gpu::GLShader::resources_declare(), blender::gpu::VKShader::resources_declare(), resources_get_(), resources_get_all_(), blender::gpu::ShaderInterface::set_image_formats_from_info(), and validate_merge().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::geometry_source_ |
Definition at line 1159 of file gpu_shader_create_info.hh.
Referenced by check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), operator==(), blender::gpu::GLShader::vertex_interface_declare(), and blender::gpu::VKShader::vertex_interface_declare().
| std::string blender::gpu::shader::ShaderCreateInfo::geometry_source_generated |
Definition at line 871 of file gpu_shader_create_info.hh.
| size_t blender::gpu::shader::ShaderCreateInfo::interface_names_size_ = 0 |
Maximum length of all the resource names including each null terminator. Only for names used by #gpu::ShaderInterface.
Definition at line 844 of file gpu_shader_create_info.hh.
Referenced by acceleration_structure(), compilation_constant(), finalize(), blender::gpu::GLShaderInterface::GLShaderInterface(), image(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), push_constant(), sampler(), specialization_constant(), storage_buf(), uniform_buf(), and vertex_in().
| bool blender::gpu::shader::ShaderCreateInfo::is_generated_ = true |
True if the shader is not part of gpu_shader_create_info_list.
Definition at line 828 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile().
| bool blender::gpu::shader::ShaderCreateInfo::metal_backend_only_ = false |
GPU Backend compatibility flag. Temporary requirement until Metal enablement is fully complete.
Definition at line 839 of file gpu_shader_create_info.hh.
Referenced by metal_backend_only().
| std::string blender::gpu::shader::ShaderCreateInfo::name_ |
Shader name for debugging.
Definition at line 824 of file gpu_shader_create_info.hh.
Referenced by blender::eevee::add_pipeline_create_info(), assert_no_overlap(), check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::GPU_shader_create_from_info_name(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::shader::ShaderCreateInfo::Resource::Resource(), resource_guard_defines(), ShaderCreateInfo(), validate_merge(), and validate_vertex_attributes().
Resources are grouped by frequency of change. Pass resources are meant to be valid for the whole pass. Batch resources can be changed in a more granular manner (per object/material). Geometry resources can be changed in a very granular manner (per draw-call). Misuse will only produce suboptimal performance.
Definition at line 1084 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::available_buffer_slots(), blender::compositor::CachedShader::CachedShader(), check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::generate_resources(), has_resource_type(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), operator<<, operator==(), blender::gpu::patch_create_info_atomic_workaround(), blender::gpu::GLShader::resources_declare(), blender::gpu::VKShader::resources_declare(), resources_get_(), resources_get_all_(), blender::gpu::ShaderInterface::set_image_formats_from_info(), and validate_merge().
| Vector<PipelineState, 0> blender::gpu::shader::ShaderCreateInfo::pipelines_ |
Definition at line 1181 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::VKShader::finalize(), and pipeline_state().
Definition at line 1154 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::available_buffer_slots(), blender::gpu::ShaderCompiler::compile(), blender::constants_calc_size(), blender::gpu::VKPushConstants::Layout::determine_storage_type(), blender::gpu::MTLShader::finalize(), finalize(), blender::gpu::generate_resources(), blender::gpu::GLShaderInterface::GLShaderInterface(), blender::gpu::init_struct(), blender::gpu::MTLPushConstantBuf::MTLPushConstantBuf(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), operator==(), push_constant(), blender::gpu::GLShader::resources_declare(), and blender::gpu::VKShader::resources_declare().
| Vector<SharedVariable, 0> blender::gpu::shader::ShaderCreateInfo::shared_variables_ |
Definition at line 989 of file gpu_shader_create_info.hh.
Referenced by check_error(), finalize(), blender::gpu::generate_resources(), blender::gpu::GLShader::resources_declare(), blender::gpu::VKShader::resources_declare(), and shared_variable().
| Vector<SpecializationConstant, 0> blender::gpu::shader::ShaderCreateInfo::specialization_constants_ |
Definition at line 970 of file gpu_shader_create_info.hh.
Referenced by check_error(), finalize(), blender::gpu::generate_resources(), blender::gpu::GLShaderInterface::GLShaderInterface(), blender::gpu::GLShader::init(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), blender::gpu::GLShader::resources_declare(), blender::gpu::VKShader::resources_declare(), specialization_constant(), and blender::gpu::Shader::specialization_constants_init().
Definition at line 967 of file gpu_shader_create_info.hh.
Referenced by finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), blender::gpu::generate_subpass_inputs(), blender::gpu::VKShader::init(), operator==(), and subpass_in().
| std::string blender::gpu::shader::ShaderCreateInfo::typedef_source_generated |
Definition at line 872 of file gpu_shader_create_info.hh.
Referenced by blender::ocio::GPUShaderBinder::create_gpu_shader(), blender::gpu::shader::GPUCodegen::generate_resources(), blender::GPU_shader_create_from_info_python(), blender::eevee::ShaderModule::material_create_info_amend(), operator==(), and blender::pygpu_shader_info_typedef_source().
| Vector<StringRefNull, 0> blender::gpu::shader::ShaderCreateInfo::typedef_sources_ |
Definition at line 1157 of file gpu_shader_create_info.hh.
Referenced by finalize(), operator==(), blender::pygpu_shader_info_typedef_source(), and typedef_source().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::vertex_entry_fn_ = "main" |
Definition at line 1160 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile(), finalize(), and vertex_function().
Definition at line 892 of file gpu_shader_create_info.hh.
Referenced by blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::generate_vertex_attributes(), blender::gpu::GLShaderInterface::GLShaderInterface(), blender::eevee::ShaderModule::material_create_info_amend(), blender::gpu::MTLShaderInterface::MTLShaderInterface(), operator==(), validate_vertex_attributes(), vertex_in(), blender::gpu::GLShader::vertex_interface_declare(), and blender::gpu::VKShader::vertex_interface_declare().
| Vector<StageInterfaceInfoHandle, 0> blender::gpu::shader::ShaderCreateInfo::vertex_out_interfaces_ |
Definition at line 1126 of file gpu_shader_create_info.hh.
Referenced by check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), blender::gpu::GLShader::fragment_interface_declare(), blender::gpu::VKShader::fragment_interface_declare(), blender::gpu::generate_vertex_out(), blender::gpu::GLShader::geometry_interface_declare(), blender::gpu::VKShader::geometry_interface_declare(), iface_guard_defines(), is_vulkan_compatible(), blender::eevee::ShaderModule::material_create_info_amend(), operator==(), blender::gpu::GLShader::vertex_interface_declare(), blender::gpu::VKShader::vertex_interface_declare(), and vertex_out().
| StringRefNull blender::gpu::shader::ShaderCreateInfo::vertex_source_ |
Definition at line 1159 of file gpu_shader_create_info.hh.
Referenced by check_error(), blender::gpu::ShaderCompiler::compile(), finalize(), operator==(), and vertex_source().
| std::string blender::gpu::shader::ShaderCreateInfo::vertex_source_generated |
Manually set generated code.
Definition at line 868 of file gpu_shader_create_info.hh.
Referenced by blender::GPU_shader_create_from_info_python(), operator==(), blender::pygpu_shader_info_vertex_source(), and blender::gpu::tests::test_shader_python_graphic().