Struct three_d::renderer::material::ColorMaterial

pub struct ColorMaterial {
    pub color: Srgba,
    pub texture: Option<Texture2DRef>,
    pub render_states: RenderStates,
    pub is_transparent: bool,
}

A material that renders a Geometry in a color defined by multiplying a color with an optional texture and optional per vertex colors. This material is not affected by lights.

Fields

color: Srgba

Base surface color.

texture: Option<Texture2DRef>

An optional texture which is samples using uv coordinates (requires that the Geometry supports uv coordinates). The colors are assumed to be in linear sRGB (RgbU8), linear sRGB with an alpha channel (RgbaU8) or HDR color space.

render_states: RenderStates

Render states.

is_transparent: bool

Whether this material should be treated as a transparent material (An object needs to be rendered differently depending on whether it is transparent or opaque).

Implementations

impl ColorMaterial

pub fn new(context: &Context, cpu_material: &CpuMaterial) -> Self

Constructs a new color material from a CpuMaterial. Tries to infer whether this material is transparent or opaque from the alpha value of the albedo color and the alpha values in the albedo texture. Since this is not always correct, it is preferred to use ColorMaterial::new_opaque or ColorMaterial::new_transparent.

pub fn new_opaque(context: &Context, cpu_material: &CpuMaterial) -> Self

Constructs a new opaque color material from a CpuMaterial.

pub fn new_transparent(context: &Context, cpu_material: &CpuMaterial) -> Self

Constructs a new transparent color material from a CpuMaterial.

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

Creates a color material from a PhysicalMaterial.

Trait Implementations

impl Clone for ColorMaterial

fn clone(&self) -> ColorMaterial

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for ColorMaterial

fn default() -> ColorMaterial

Returns the “default value” for a type.

impl FromCpuMaterial for ColorMaterial

fn from_cpu_material(context: &Context, cpu_material: &CpuMaterial) -> Self

Creates a new material that can be used for rendering from a CpuMaterial.

impl Material for ColorMaterial

fn id(&self) -> u16

Returns a unique ID for each variation of the shader source returned from Material::fragment_shader_source.

fn fragment_shader_source(&self, _lights: &[&dyn Light]) -> String

Returns the fragment shader source for this material.

fn fragment_attributes(&self) -> FragmentAttributes

Returns a FragmentAttributes struct that describes which fragment attributes, ie. the input from the vertex shader, are required for rendering with this material.

fn use_uniforms( &self, program: &Program, camera: &Camera, _lights: &[&dyn Light] )

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 material_type(&self) -> MaterialType

Returns the type of material.