awsm-renderer 0.3.1

awsm-renderer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

//! Transparent material render pass execution.

use crate::{
    error::Result,
    render::RenderContext,
    render_passes::{
        material_transparent::{
            bind_group::MaterialTransparentBindGroups, pipeline::MaterialTransparentPipelines,
        },
        RenderPassInitContext,
    },
    renderable::Renderable,
};

/// Transparent material pass bind groups and pipelines.
pub struct MaterialTransparentRenderPass {
    pub bind_groups: MaterialTransparentBindGroups,
    pub pipelines: MaterialTransparentPipelines,
}

impl MaterialTransparentRenderPass {
    /// Creates the transparent material render pass resources.
    pub async fn new(ctx: &mut RenderPassInitContext<'_>) -> Result<Self> {
        let bind_groups = MaterialTransparentBindGroups::new(ctx).await?;
        let pipelines = MaterialTransparentPipelines::new(ctx, &bind_groups).await?;

        Ok(Self {
            bind_groups,
            pipelines,
        })
    }

    /// Rebuilds bind groups and pipelines after texture pool changes.
    pub async fn texture_pool_changed(
        &mut self,
        ctx: &mut RenderPassInitContext<'_>,
    ) -> Result<()> {
        self.bind_groups = self.bind_groups.clone_because_texture_pool_changed(ctx)?;
        self.pipelines = MaterialTransparentPipelines::new(ctx, &self.bind_groups).await?;

        Ok(())
    }

    /// Executes the transparent material pass.
    pub fn render(
        &self,
        ctx: &RenderContext,
        renderables: &[Renderable],
        is_hud: bool,
    ) -> Result<()> {
        let render_pass = if is_hud {
            ctx.begin_hud_transparent_pass(Some("Material Transparent Pass (HUD)"))?
        } else {
            ctx.begin_world_transparent_pass(Some("Material Transparent Pass"))?
        };

        let (main_bind_group, shadows_bind_group, texture_bind_group, mesh_material_bind_group) =
            self.bind_groups.get_bind_groups()?;

        // 16.B slot order: main (was main + lights) / shadows /
        // texture_pool / mesh_material (per-mesh, dynamic-offset).
        render_pass.set_bind_group(0u32, main_bind_group, None)?;
        render_pass.set_bind_group(1u32, shadows_bind_group, None)?;
        render_pass.set_bind_group(2u32, texture_bind_group, None)?;

        let mut last_render_pipeline_key = None;
        for renderable in renderables {
            if let Some(render_pipeline_key) = renderable.material_transparent_render_pipeline_key()
            {
                if last_render_pipeline_key != Some(render_pipeline_key) {
                    render_pass.set_pipeline(ctx.pipelines.render.get(render_pipeline_key)?);
                    last_render_pipeline_key = Some(render_pipeline_key);
                }

                renderable.push_material_transparent_pass_commands(
                    ctx,
                    &render_pass,
                    mesh_material_bind_group,
                )?;
            }
        }

        render_pass.end();

        Ok(())
    }
}