rafx-api 0.0.16

Rendering framework built on an extensible asset pipeline
Documentation
use crate::vulkan::{
    RafxDeviceContextVulkan, RafxRenderpassVulkanColorAttachment, RafxRenderpassVulkanDef,
    RafxRenderpassVulkanDepthAttachment,
};
use crate::*;
use ash::vk;
use std::ffi::CString;

#[derive(Debug)]
pub struct RafxPipelineVulkan {
    pipeline_type: RafxPipelineType,
    pipeline: vk::Pipeline,
    // It's a RafxRootSignatureVulkan, but stored as RafxRootSignature so we can return refs to it
    root_signature: RafxRootSignature,
}

impl Drop for RafxPipelineVulkan {
    fn drop(&mut self) {
        unsafe {
            let device = self
                .root_signature
                .vk_root_signature()
                .unwrap()
                .device_context()
                .device();
            device.destroy_pipeline(self.pipeline, None);
        }
    }
}

impl RafxPipelineVulkan {
    pub fn pipeline_type(&self) -> RafxPipelineType {
        self.pipeline_type
    }

    pub fn root_signature(&self) -> &RafxRootSignature {
        &self.root_signature
    }

    pub fn vk_pipeline(&self) -> vk::Pipeline {
        self.pipeline
    }

    pub fn set_debug_name(
        &self,
        name: impl AsRef<str>,
    ) {
        use ash::vk::Handle;
        let device_context = self
            .root_signature
            .vk_root_signature()
            .unwrap()
            .device_context();
        if device_context.device_info().debug_names_enabled {
            if let Some(debug_reporter) = device_context.debug_reporter() {
                debug_reporter.set_object_debug_name(
                    device_context.device().handle(),
                    vk::ObjectType::PIPELINE,
                    self.vk_pipeline().as_raw(),
                    name,
                );
            }
        }
    }

    pub fn new_graphics_pipeline(
        device_context: &RafxDeviceContextVulkan,
        pipeline_def: &RafxGraphicsPipelineDef,
    ) -> RafxResult<Self> {
        //log::trace!("Create pipeline\n{:#?}", pipeline_def);

        //TODO: Cache
        let vk_root_signature = pipeline_def.root_signature.vk_root_signature().unwrap();

        // image layouts and load/store ops don't affect compatibility
        // https://www.khronos.org/registry/vulkan/specs/1.1-extensions/html/chap9.html#renderpass-compatibility
        let color_attachments: Vec<_> = pipeline_def
            .color_formats
            .iter()
            .map(|&format| RafxRenderpassVulkanColorAttachment {
                format,
                load_op: Default::default(),
                store_op: Default::default(),
            })
            .collect();

        // does not affect compatibility for single-pass renderpasses
        let resolve_attachments = vec![];

        let depth_attachment = if let Some(depth_format) = pipeline_def.depth_stencil_format {
            assert_ne!(depth_format, RafxFormat::UNDEFINED);
            Some(RafxRenderpassVulkanDepthAttachment {
                format: depth_format,
                depth_load_op: Default::default(),
                stencil_load_op: Default::default(),
                depth_store_op: Default::default(),
                stencil_store_op: Default::default(),
            })
        } else {
            None
        };

        // Temporary renderpass, required to create pipeline but don't need to keep it
        let renderpass = device_context.create_renderpass(&RafxRenderpassVulkanDef {
            color_attachments,
            resolve_attachments,
            depth_attachment,
            sample_count: pipeline_def.sample_count,
        })?;

        let mut entry_point_names = vec![];
        for stage in pipeline_def.shader.vk_shader().unwrap().stages() {
            entry_point_names
                .push(CString::new(stage.reflection.entry_point_name.clone()).unwrap());
        }

        let mut stages = vec![];
        for (stage, entry_point_cstr) in pipeline_def
            .shader
            .vk_shader()
            .unwrap()
            .stages()
            .iter()
            .zip(&entry_point_names)
        {
            stages.push(
                vk::PipelineShaderStageCreateInfo::builder()
                    .name(entry_point_cstr)
                    .module(
                        stage
                            .shader_module
                            .vk_shader_module()
                            .unwrap()
                            .vk_shader_module(),
                    )
                    .stage(stage.reflection.shader_stage.into())
                    .build(),
            );
        }

        let mut bindings = Vec::with_capacity(pipeline_def.vertex_layout.buffers.len());
        let mut attributes = Vec::with_capacity(pipeline_def.vertex_layout.attributes.len());

        for (index, vertex_buffer) in pipeline_def.vertex_layout.buffers.iter().enumerate() {
            if vertex_buffer.stride > 0 {
                bindings.push(
                    vk::VertexInputBindingDescription::builder()
                        .binding(index as u32)
                        .input_rate(vertex_buffer.rate.into())
                        .stride(vertex_buffer.stride)
                        .build(),
                );
            }
        }

        for vertex_attribute in &pipeline_def.vertex_layout.attributes {
            attributes.push(
                vk::VertexInputAttributeDescription::builder()
                    .format(vertex_attribute.format.into())
                    .location(vertex_attribute.location)
                    .binding(vertex_attribute.buffer_index)
                    .offset(vertex_attribute.byte_offset)
                    .build(),
            );
        }

        let vertex_input_state = vk::PipelineVertexInputStateCreateInfo::builder()
            .vertex_binding_descriptions(&bindings)
            .vertex_attribute_descriptions(&attributes);

        let input_assembly_state = vk::PipelineInputAssemblyStateCreateInfo::builder()
            .topology(pipeline_def.primitive_topology.into())
            .primitive_restart_enable(false);

        // Tesselation not supported

        // Set up for dynamic viewport/scissor
        let viewport_state = vk::PipelineViewportStateCreateInfo::builder()
            .viewport_count(1)
            .scissor_count(1);

        let multisample_state = vk::PipelineMultisampleStateCreateInfo::builder()
            .rasterization_samples(pipeline_def.sample_count.into())
            .sample_shading_enable(false)
            .min_sample_shading(0.0)
            .alpha_to_coverage_enable(false) // pipeline_def.blend_state.alpha_to_coverage_enable?
            .alpha_to_one_enable(false);

        let rasterization_state =
            super::util::rasterizer_state_to_create_info(&pipeline_def.rasterizer_state);
        let depth_state = super::util::depth_state_to_create_info(pipeline_def.depth_state);
        let blend_state = super::util::blend_state_to_create_info(
            pipeline_def.blend_state,
            pipeline_def.color_formats.len(),
        );

        let dynamic_states = [
            vk::DynamicState::VIEWPORT,
            vk::DynamicState::SCISSOR,
            vk::DynamicState::STENCIL_REFERENCE,
        ];
        let dynamic_states_create_info =
            vk::PipelineDynamicStateCreateInfo::builder().dynamic_states(&dynamic_states);

        let pipeline_create_info = vk::GraphicsPipelineCreateInfo::builder()
            .stages(&stages)
            .vertex_input_state(&vertex_input_state)
            .input_assembly_state(&input_assembly_state)
            .viewport_state(&viewport_state)
            .rasterization_state(&rasterization_state)
            .multisample_state(&multisample_state)
            .depth_stencil_state(&depth_state)
            .color_blend_state(blend_state.blend_state())
            .dynamic_state(&dynamic_states_create_info)
            .layout(vk_root_signature.vk_pipeline_layout())
            .render_pass(renderpass.vk_renderpass())
            .subpass(0)
            .base_pipeline_handle(vk::Pipeline::null())
            .base_pipeline_index(-1)
            .build();

        let pipeline = unsafe {
            match device_context.device().create_graphics_pipelines(
                vk::PipelineCache::null(),
                &[pipeline_create_info],
                None,
            ) {
                Ok(result) => Ok(result),
                Err(e) => Err(e.1),
            }
        }?[0];

        let pipeline = RafxPipelineVulkan {
            pipeline_type: RafxPipelineType::Graphics,
            pipeline,
            root_signature: pipeline_def.root_signature.clone(),
        };

        if let Some(debug_name) = pipeline_def.debug_name {
            pipeline.set_debug_name(debug_name)
        }

        Ok(pipeline)
    }

    pub fn new_compute_pipeline(
        device_context: &RafxDeviceContextVulkan,
        pipeline_def: &RafxComputePipelineDef,
    ) -> RafxResult<Self> {
        //log::trace!("Create pipeline\n{:#?}", pipeline_def);

        //TODO: Cache
        let vk_root_signature = pipeline_def.root_signature.vk_root_signature().unwrap();

        let vk_shader = pipeline_def.shader.vk_shader().unwrap();
        assert_eq!(vk_shader.stages().len(), 1);
        assert_eq!(vk_shader.stage_flags(), RafxShaderStageFlags::COMPUTE);

        let mut entry_point_names = vec![];
        for stage in vk_shader.stages() {
            entry_point_names
                .push(CString::new(stage.reflection.entry_point_name.clone()).unwrap());
        }

        let compute_stage = &vk_shader.stages()[0];
        let entry_point_name =
            CString::new(compute_stage.reflection.entry_point_name.clone()).unwrap();
        let stage = vk::PipelineShaderStageCreateInfo::builder()
            .name(&entry_point_name)
            .module(
                compute_stage
                    .shader_module
                    .vk_shader_module()
                    .unwrap()
                    .vk_shader_module(),
            )
            .stage(vk::ShaderStageFlags::COMPUTE);

        let pipeline_create_info = vk::ComputePipelineCreateInfo::builder()
            .stage(*stage)
            .layout(vk_root_signature.vk_pipeline_layout())
            .base_pipeline_handle(vk::Pipeline::null())
            .base_pipeline_index(-1)
            .build();

        let pipeline = unsafe {
            match device_context.device().create_compute_pipelines(
                vk::PipelineCache::null(),
                &[pipeline_create_info],
                None,
            ) {
                Ok(result) => Ok(result),
                Err(e) => Err(e.1),
            }
        }?[0];

        let pipeline = RafxPipelineVulkan {
            pipeline_type: RafxPipelineType::Compute,
            pipeline,
            root_signature: pipeline_def.root_signature.clone(),
        };

        if let Some(debug_name) = pipeline_def.debug_name {
            pipeline.set_debug_name(debug_name)
        }

        Ok(pipeline)
    }
}