Struct RuntimeShader 

pub struct RuntimeShader { /* private fields */ }

A custom WGSL shader effect, analogous to Android’s RuntimeShader.

The shader source must be a complete WGSL module that declares:

@group(0) @binding(0) var input_texture: texture_2d<f32>;
@group(0) @binding(1) var input_sampler: sampler;
@group(1) @binding(0) var<uniform> u: array<vec4<f32>, 64>;

Float uniforms are packed linearly into the u array. Access them in WGSL as u[index / 4][index % 4] for individual floats, or u[index / 4].xy for vec2, etc. User uniforms may use indices 0..248; slots 248..256 are reserved for renderer metadata.

RuntimeShader pipelines operate on premultiplied-alpha textures. Custom shaders should preserve premultiplied output semantics.

Implementations

impl RuntimeShader

pub const MAX_UNIFORMS: usize = 256

Total uniform storage size in floats (64 vec4s = 256 floats).

The final slots are reserved for renderer-managed data.

pub const RESERVED_UNIFORM_START: usize = 248

First renderer-reserved uniform slot.

pub const MAX_USER_UNIFORMS: usize = Self::RESERVED_UNIFORM_START

Maximum user-addressable uniform count.

pub fn new(wgsl_source: &str) -> RuntimeShader

Create a new RuntimeShader from WGSL source code.

pub fn from_shared_source(source: Arc<str>) -> RuntimeShader

Create a RuntimeShader from shared WGSL source code.

This avoids repeatedly copying large shader modules for animated effects that rebuild only their uniform payload every frame.

pub fn set_input_padding(&mut self, padding: f32)

Declares how far the shader may sample outside its effect rect, in logical pixels. Backdrop rendering uses this to capture enough input around refractive and displacement shaders.

pub fn input_padding(&self) -> f32

Returns the declared input padding in logical pixels.

pub fn set_float(&mut self, index: usize, value: f32)

Set a single float uniform at the given index.

Invalid renderer-reserved ranges are ignored. Use Self::try_set_float when the caller needs to handle invalid uniform writes explicitly.

pub fn try_set_float( &mut self, index: usize, value: f32, ) -> Result<(), RuntimeShaderUniformError>

Set a single float uniform at the given index.

pub fn set_float2(&mut self, index: usize, x: f32, y: f32)

Set a vec2 uniform at the given index (consumes indices [index, index+1]).

Invalid renderer-reserved ranges are ignored. Use Self::try_set_float2 when the caller needs to handle invalid uniform writes explicitly.

pub fn try_set_float2( &mut self, index: usize, x: f32, y: f32, ) -> Result<(), RuntimeShaderUniformError>

Set a vec2 uniform at the given index (consumes indices [index, index+1]).

pub fn set_float4(&mut self, index: usize, x: f32, y: f32, z: f32, w: f32)

Set a vec4 uniform at the given index (consumes indices [index..index+4]).

Invalid renderer-reserved ranges are ignored. Use Self::try_set_float4 when the caller needs to handle invalid uniform writes explicitly.

pub fn try_set_float4( &mut self, index: usize, x: f32, y: f32, z: f32, w: f32, ) -> Result<(), RuntimeShaderUniformError>

Set a vec4 uniform at the given index (consumes indices [index..index+4]).

pub fn source(&self) -> &str

Get the WGSL source code.

pub fn uniforms(&self) -> &[f32]

Get the uniform data as a float slice (for uploading to GPU).

pub fn uniforms_padded(&self) -> [f32; 256]

Get the uniform data padded to full 256-float array (for GPU uniform buffer).

pub fn source_hash(&self) -> u64

Compute a hash of the shader source for pipeline caching.

Trait Implementations

impl Clone for RuntimeShader

fn clone(&self) -> RuntimeShader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuntimeShader

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for RuntimeShader

fn eq(&self, other: &RuntimeShader) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl RenderHash for RuntimeShader

fn render_hash(&self) -> u64