use crate::uniforms::{BindUniform, NoUniformBinder, UniformStorage}; use librashader_common::Size; use librashader_preprocess::ShaderParameter; use librashader_reflect::reflect::semantics::{ BindingMeta, MemberOffset, Semantic, TextureBinding, TextureSemantics, UniformBinding, UniformMeta, UniqueSemantics, }; use rustc_hash::FxHashMap; use std::collections::HashMap; use std::hash::BuildHasher; use std::ops::{Deref, DerefMut}; /// Trait for input textures used during uniform binding, pub trait TextureInput { /// Gets the size of this input texture. fn size(&self) -> Size; } /// A uniform member offset with context that needs to be resolved. pub trait ContextOffset where H: BindUniform, H: BindUniform, H: BindUniform, H: for<'a> BindUniform, H: for<'a> BindUniform, { /// Gets the `MemberOffset` part of the offset. fn offset(&self) -> MemberOffset; /// Gets the context part of the offset. fn context(&self) -> C; } impl ContextOffset> for MemberOffset where H: BindUniform, f32>, H: BindUniform, u32>, H: BindUniform, i32>, H: for<'a> BindUniform, &'a [f32; 4]>, H: for<'a> BindUniform, &'a [f32; 16]>, { fn offset(&self) -> MemberOffset { *self } fn context(&self) -> Option<()> { None } } /// Trait that abstracts binding of semantics to shader uniforms. pub trait BindSemantics, U = Box<[u8]>, P = Box<[u8]>> where C: Copy, U: Deref + DerefMut, P: Deref + DerefMut, H: BindUniform, H: BindUniform, H: BindUniform, H: for<'b> BindUniform, H: for<'b> BindUniform, { /// The type of the input texture used for semantic binding. type InputTexture: TextureInput; /// The set of texture samplers available. type SamplerSet; /// The descriptor set or object that holds sampler and texture bindings. type DescriptorSet<'a>; /// The device context containing the state of the graphics processor. type DeviceContext; /// The type of uniform offsets to use. type UniformOffset: ContextOffset; /// Bind a texture to the input descriptor set fn bind_texture<'a>( descriptors: &mut Self::DescriptorSet<'a>, samplers: &Self::SamplerSet, binding: &TextureBinding, texture: &Self::InputTexture, device: &Self::DeviceContext, ); #[allow(clippy::too_many_arguments)] /// Write uniform and texture semantics to the provided storages. fn bind_semantics<'a>( device: &Self::DeviceContext, sampler_set: &Self::SamplerSet, uniform_storage: &mut UniformStorage, descriptor_set: &mut Self::DescriptorSet<'a>, mvp: &[f32; 16], frame_count: u32, frame_direction: i32, framebuffer_size: Size, viewport_size: Size, original: &Self::InputTexture, source: &Self::InputTexture, uniform_bindings: &HashMap, texture_meta: &HashMap, TextureBinding, impl BuildHasher>, pass_outputs: impl Iterator>>, pass_feedback: impl Iterator>>, original_history: impl Iterator>>, lookup_textures: impl Iterator)>, parameter_defaults: &HashMap, runtime_parameters: &HashMap, ) { // Bind MVP if let Some(offset) = uniform_bindings.get(&UniqueSemantics::MVP.into()) { uniform_storage.bind_mat4(offset.offset(), mvp, offset.context()); } // Bind OutputSize if let Some(offset) = uniform_bindings.get(&UniqueSemantics::Output.into()) { uniform_storage.bind_vec4(offset.offset(), framebuffer_size, offset.context()); } // bind FinalViewportSize if let Some(offset) = uniform_bindings.get(&UniqueSemantics::FinalViewport.into()) { uniform_storage.bind_vec4(offset.offset(), viewport_size, offset.context()); } // bind FrameCount if let Some(offset) = uniform_bindings.get(&UniqueSemantics::FrameCount.into()) { uniform_storage.bind_scalar(offset.offset(), frame_count, offset.context()); } // bind FrameDirection if let Some(offset) = uniform_bindings.get(&UniqueSemantics::FrameDirection.into()) { uniform_storage.bind_scalar(offset.offset(), frame_direction, offset.context()); } // bind Original sampler if let Some(binding) = texture_meta.get(&TextureSemantics::Original.semantics(0)) { Self::bind_texture(descriptor_set, sampler_set, binding, original, device); } // bind OriginalSize if let Some(offset) = uniform_bindings.get(&TextureSemantics::Original.semantics(0).into()) { uniform_storage.bind_vec4(offset.offset(), original.size(), offset.context()); } // bind Source sampler if let Some(binding) = texture_meta.get(&TextureSemantics::Source.semantics(0)) { Self::bind_texture(descriptor_set, sampler_set, binding, source, device); } // bind SourcelSize if let Some(offset) = uniform_bindings.get(&TextureSemantics::Source.semantics(0).into()) { uniform_storage.bind_vec4(offset.offset(), source.size(), offset.context()); } // OriginalHistory0 aliases OriginalHistory // bind OriginalHistory0 sampler if let Some(binding) = texture_meta.get(&TextureSemantics::OriginalHistory.semantics(0)) { Self::bind_texture(descriptor_set, sampler_set, binding, original, device); } // bind OriginalHistory0Size if let Some(offset) = uniform_bindings.get(&TextureSemantics::OriginalHistory.semantics(0).into()) { uniform_storage.bind_vec4(offset.offset(), original.size(), offset.context()); } // bind OriginalHistory1-.. for (index, history) in original_history.enumerate() { let Some(history) = history else { continue; }; let history = history.as_ref(); if let Some(binding) = texture_meta.get(&TextureSemantics::OriginalHistory.semantics(index + 1)) { Self::bind_texture(descriptor_set, sampler_set, binding, history, device); } if let Some(offset) = uniform_bindings.get( &TextureSemantics::OriginalHistory .semantics(index + 1) .into(), ) { uniform_storage.bind_vec4(offset.offset(), history.size(), offset.context()); } } // bind PassOutput0.. // The caller should be responsible for limiting this up to // pass_index for (index, output) in pass_outputs.enumerate() { let Some(output) = output else { continue; }; let output = output.as_ref(); if let Some(binding) = texture_meta.get(&TextureSemantics::PassOutput.semantics(index)) { Self::bind_texture(descriptor_set, sampler_set, binding, output, device); } if let Some(offset) = uniform_bindings.get(&TextureSemantics::PassOutput.semantics(index).into()) { uniform_storage.bind_vec4(offset.offset(), output.size(), offset.context()); } } // bind PassFeedback0.. for (index, feedback) in pass_feedback.enumerate() { let Some(output) = feedback else { continue; }; let feedback = output.as_ref(); if let Some(binding) = texture_meta.get(&TextureSemantics::PassFeedback.semantics(index)) { Self::bind_texture(descriptor_set, sampler_set, binding, feedback, device); } if let Some(offset) = uniform_bindings.get(&TextureSemantics::PassFeedback.semantics(index).into()) { uniform_storage.bind_vec4(offset.offset(), feedback.size(), offset.context()); } } // bind User parameters for (id, offset) in uniform_bindings .iter() .filter_map(|(binding, value)| match binding { UniformBinding::Parameter(id) => Some((id, value)), _ => None, }) { let id = id.as_str(); let default = parameter_defaults.get(id).map_or(0f32, |f| f.initial); let value = *runtime_parameters.get(id).unwrap_or(&default); uniform_storage.bind_scalar(offset.offset(), value, offset.context()); } // bind luts for (index, lut) in lookup_textures { let lut = lut.as_ref(); if let Some(binding) = texture_meta.get(&TextureSemantics::User.semantics(index)) { Self::bind_texture(descriptor_set, sampler_set, binding, lut, device); } if let Some(offset) = uniform_bindings.get(&TextureSemantics::User.semantics(index).into()) { uniform_storage.bind_vec4(offset.offset(), lut.size(), offset.context()); } } } } /// Trait for objects that can be used to create a binding map. pub trait BindingUtil { /// Create the uniform binding map with the given reflection information. fn create_binding_map( &self, f: impl Fn(&dyn UniformMeta) -> T, ) -> FxHashMap; /// Calculate the number of required images for history. fn calculate_required_history<'a>(pass_meta: impl Iterator) -> usize where Self: 'a; } impl BindingUtil for BindingMeta { fn create_binding_map( &self, f: impl Fn(&dyn UniformMeta) -> T, ) -> FxHashMap { let mut uniform_bindings = FxHashMap::default(); for param in self.parameter_meta.values() { uniform_bindings.insert(UniformBinding::Parameter(param.id.clone()), f(param)); } for (semantics, param) in &self.unique_meta { uniform_bindings.insert(UniformBinding::SemanticVariable(*semantics), f(param)); } for (semantics, param) in &self.texture_size_meta { uniform_bindings.insert(UniformBinding::TextureSize(*semantics), f(param)); } uniform_bindings } fn calculate_required_history<'a>(pass_meta: impl Iterator) -> usize where Self: 'a, { let mut required_images = 0; for pass in pass_meta { // If a shader uses history size, but not history, we still need to keep the texture. let texture_count = pass .texture_meta .iter() .filter(|(semantics, _)| semantics.semantics == TextureSemantics::OriginalHistory) .count(); let texture_size_count = pass .texture_size_meta .iter() .filter(|(semantics, _)| semantics.semantics == TextureSemantics::OriginalHistory) .count(); required_images = std::cmp::max(required_images, texture_count); required_images = std::cmp::max(required_images, texture_size_count); } required_images } }