Struct screen_13::driver::shader::Shader

pub struct Shader {
    pub entry_name: String,
    pub specialization_info: Option<SpecializationInfo>,
    pub spirv: Vec<u8>,
    pub stage: ShaderStageFlags,
    /* private fields */
}

Describes a shader program which runs on some pipeline stage.

Fields

entry_name: String

The name of the entrypoint which will be executed by this shader.

The default value is main.

specialization_info: Option<SpecializationInfo>

Data about Vulkan specialization constants.

Examples

Basic usage (GLSL):

#version 460 core

// Defaults to 6 if not set using ComputePipelineInfo.specialization_info!
layout(constant_id = 0) const uint MY_COUNT = 6;

layout(set = 0, binding = 0) uniform sampler2D my_samplers[MY_COUNT];

void main()
{
    // Code uses MY_COUNT number of my_samplers here
}

// We instead specify 42 for MY_COUNT:
let shader = Shader::new_fragment(my_shader_code.as_slice())
    .specialization_info(SpecializationInfo::new(
        [vk::SpecializationMapEntry {
            constant_id: 0,
            offset: 0,
            size: 4,
        }],
        42u32.to_ne_bytes()
    ));

spirv: Vec<u8>

Shader code.

Although SPIR-V code is specified as u32 values, this field uses u8 in order to make loading from file simpler. You should always have a SPIR-V code length which is a multiple of four bytes, or a panic will happen during pipeline creation.

stage: ShaderStageFlags

The shader stage this structure applies to.

Implementations

impl Shader

pub fn new(stage: ShaderStageFlags, spirv: impl ShaderCode) -> ShaderBuilder

Specifies a shader with the given stage and shader code values.

pub fn new_any_hit(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new ray trace shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_callable(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new ray trace shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_closest_hit(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new ray trace shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_compute(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new compute shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_fragment(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new fragment shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_geometry(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new geometry shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_intersection(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new ray trace shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_miss(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new ray trace shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_ray_gen(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new ray trace shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_tesselation_ctrl(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new tesselation control shader.

NOTE: May panic if the shader code is invalid.

pub fn new_tesselation_eval(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new tesselation evaluation shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

pub fn new_vertex(spirv: impl ShaderCode) -> ShaderBuilder

Creates a new vertex shader.

Panics

If the shader code is invalid or not a multiple of four bytes in length.

Trait Implementations

impl Clone for Shader

fn clone(&self) -> Shader

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Shader

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

Formats the value using the given formatter.

impl From<ShaderBuilder> for Shader

fn from(shader: ShaderBuilder) -> Self

Converts to this type from the input type.