Struct three_d::renderer::material::DeferredPhysicalMaterial

pub struct DeferredPhysicalMaterial {

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

The deferred part of a physically-based material that renders a Geometry 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>>

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>>

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>>

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>>

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

render_states: RenderStates

Render states

emissive: Color

Color of light shining from an object.

emissive_texture: Option<Rc<Texture2D>>

Texture with color of light shining from an object.

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: &[&dyn Light]
) -> String

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

fn use_uniforms(
    &self,
    program: &Program,
    _camera: &Camera,
    _lights: &[&dyn Light]
) -> 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.