Struct three_d::renderer::DeferredPipeline

pub struct DeferredPipeline {
    pub debug_type: DebugType,
    pub lighting_model: LightingModel,
    // some fields omitted
}

Deferred render pipeline which can render objects (implementing the Geometry trait) with materials (implementing the DeferredMaterial trait) and lighting. Supports different types of lighting models by changing the DeferredPipeline::lighting_model field. Deferred rendering draws the geometry information into a buffer in the DeferredPipeline::geometry_pass and use that information in the DeferredPipeline::light_pass. This means that the lighting is only calculated once per pixel since the depth testing is happening in the geometry pass. 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.

lighting_model: LightingModel

Implementations

impl DeferredPipeline

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

Constructor.

pub fn geometry_pass<G: Geometry, M: DeferredMaterial>(
    &mut self,
    camera: &Camera,
    objects: &[(G, M)]
) -> 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::light_pass.

pub fn light_pass(
    &mut self,
    camera: &Camera,
    ambient_light: Option<&AmbientLight>,
    directional_lights: &[&DirectionalLight],
    spot_lights: &[&SpotLight],
    point_lights: &[&PointLight]
) -> ThreeDResult<()>

Uses the geometry and surface material parameters written in the last DeferredPipeline::geometry_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) -> &ColorTargetTexture2DArray<u8>

pub fn geometry_pass_depth_texture_array(&self) -> &DepthTargetTexture2DArray

pub fn geometry_pass_depth_texture(&self) -> DepthTargetTexture2D