Struct three_d::renderer::material::DeferredPhysicalMaterial

pub struct DeferredPhysicalMaterial {
    pub name: String,
    pub albedo: Color,
    pub albedo_texture: Option<Rc<Texture2D<u8>>>,
    pub metallic: f32,
    pub roughness: f32,
    pub metallic_roughness_texture: Option<Rc<Texture2D<u8>>>,
    pub occlusion_strength: f32,
    pub occlusion_texture: Option<Rc<Texture2D<u8>>>,
    pub normal_scale: f32,
    pub normal_texture: Option<Rc<Texture2D<u8>>>,
    pub render_states: RenderStates,
    pub alpha_cutout: Option<f32>,
}

The deferred part of a physically-based material that renders a Shadable object in an approximate correct physical manner based on Physically Based Rendering (PBR). Must be used together with a DeferredPipeline. This material is affected by lights.

Fields

name: String

Name. Used for matching geometry and material.

albedo: Color

Albedo base color, also called diffuse color. Assumed to be in linear color space.

albedo_texture: Option<Rc<Texture2D<u8>>>

Texture with albedo base colors, also called diffuse color. Assumed to be in sRGB with or without an alpha channel.

metallic: f32

A value in the range [0..1] specifying how metallic the material is.

roughness: f32

A value in the range [0..1] specifying how rough the material surface is.

metallic_roughness_texture: Option<Rc<Texture2D<u8>>>

Texture containing the metallic and roughness parameters which are multiplied with the Self::metallic and Self::roughness values in the shader. The metallic values are sampled from the blue channel and the roughness from the green channel.

occlusion_strength: f32

A scalar multiplier controlling the amount of occlusion applied from the Self::occlusion_texture. A value of 0.0 means no occlusion. A value of 1.0 means full occlusion.

occlusion_texture: Option<Rc<Texture2D<u8>>>

An occlusion map. Higher values indicate areas that should receive full indirect lighting and lower values indicate no indirect lighting. The occlusion values are sampled from the red channel.

normal_scale: f32

A scalar multiplier applied to each normal vector of the Self::normal_texture.

normal_texture: Option<Rc<Texture2D<u8>>>

A tangent space normal map, also known as bump map.

render_states: RenderStates

Render states

alpha_cutout: Option<f32>

Alpha cutout value for transparency in deferred rendering pipeline.

Implementations

impl DeferredPhysicalMaterial

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

Constructs a new deferred physical material from a CPUMaterial. If the input contains an CPUMaterial::occlusion_metallic_roughness_texture, this texture is used for both DeferredPhysicalMaterial::metallic_roughness_texture and DeferredPhysicalMaterial::occlusion_texture while any CPUMaterial::metallic_roughness_texture or CPUMaterial::occlusion_texture are ignored.

pub fn from_physical_material(physical_material: &PhysicalMaterial) -> Self

Constructs a deferred physical material from a physical material.

Trait Implementations

impl Clone for DeferredPhysicalMaterial

fn clone(&self) -> DeferredPhysicalMaterial

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for DeferredPhysicalMaterial

fn default() -> Self

Returns the “default value” for a type.

impl Material for DeferredPhysicalMaterial

fn fragment_shader_source(
    &self,
    use_vertex_colors: bool,
    lights: &Lights
) -> String

Returns the fragment shader source for this material. Should output the final fragment color.

fn use_uniforms(
    &self,
    program: &Program,
    _camera: &Camera,
    _lights: &Lights
) -> ThreeDResult<()>

Sends the uniform data needed for this material to the fragment shader.

fn render_states(&self) -> RenderStates

Returns the render states needed to render with this material.

fn is_transparent(&self) -> bool

Returns whether or not this material is transparent.