Struct three_d::renderer::DeferredPipeline

pub struct DeferredPipeline {
    pub debug_type: DebugType,
    /* private fields */
}

Deferred render pipeline which can render objects (implementing the Geometry trait) with a DeferredPhysicalMaterial and lighting. Deferred rendering draws the geometry information into a buffer in the DeferredPipeline::render_pass and use that information in the DeferredPipeline::lighting_pass. This means that the lighting is only calculated once per pixel since the depth testing is happening in the render pass. For now only supports a cook-torrance LightingModel. Note: Deferred rendering does not support blending and therefore does not support transparency!

Fields

debug_type: DebugType

Set this to visualize the positions, normals etc. for debug purposes.

Implementations

impl DeferredPipeline

pub fn new(context: &Context) -> ThreeDResult<Self>

Constructor.

pub fn render_pass(
    &mut self,
    camera: &Camera,
    objects: &[(impl Geometry, &DeferredPhysicalMaterial)]
) -> ThreeDResult<()>

Render the given geometry and material parameters to a buffer. This function must not be called in a render target render function and needs to be followed by a call to DeferredPipeline::lighting_pass.

pub fn lighting_pass(
    &mut self,
    camera: &Camera,
    lights: &[&dyn Light]
) -> ThreeDResult<()>

Uses the geometry and surface material parameters written in the last DeferredPipeline::render_pass call and all of the given lights to render the objects. Must be called in a render target render function, for example in the callback function of Screen::write.

pub fn geometry_pass_texture(&self) -> &Texture2DArray

Returns the geometry pass texture

pub fn geometry_pass_depth_texture_array(&self) -> &DepthTargetTexture2DArray

Returns the geometry pass depth texture

pub fn geometry_pass_depth_texture(&self) -> DepthTargetTexture2D

Returns the geometry pass depth texture