Struct Material 

pub struct Material { /* private fields */ }

Control how disks are rendered.

Disks are always opaque and alpha in any texture or background color is ignored.

By default Material is initialized with only one background color. Color the instances differently by setting more than one color with set_background_colors. The color of each disk is given by background_colors[tag % len(background_colors)] so you may set fewer colors than there are disks. sync assigns tag values in increasing order to each primitive.

The background_color tints the texture by multiplication. With a None texture (the default), background_color sets the exact color of the disk.

Set the initial material by piping MaterialParameters into Disk::setup. After it is initialized, change the material during execution via the material field inResMut<disk::Representation<A>>.

Implementations

impl Material

pub fn set_background_colors( &mut self, buffers: ResMut<'_, Assets<ShaderStorageBuffer>>, colors: &[LinearRgba], )

Set new background colors.

Panics

WebGL2 builds (identified by the wasm32 target without the webgpu feature) support only 1024 background colors.

Desktop target builds or wasm32 target builds with webgpu support a much larger number of colors and will not panic.

Trait Implementations

impl AsBindGroup for Material

type Data = ()

Data that will be stored alongside the “prepared” bind group.

type Param = (Res<'static, RenderAssets<GpuImage>>, Res<'static, FallbackImage>, Res<'static, RenderAssets<GpuShaderStorageBuffer>>)

fn label() -> &'static str

label

fn unprepared_bind_group( &self, layout: &BindGroupLayout, render_device: &RenderDevice, (images, fallback_image, storage_buffers): &mut SystemParamItem<'_, '_, Self::Param>, force_no_bindless: bool, ) -> Result<UnpreparedBindGroup, AsBindGroupError>

Returns a vec of (binding index, OwnedBindingResource).

fn bind_group_data(&self) -> Self::Data

fn bind_group_layout_entries( render_device: &RenderDevice, force_no_bindless: bool, ) -> Vec<BindGroupLayoutEntry>

Returns a vec of bind group layout entries.

fn bindless_descriptor() -> Option<BindlessDescriptor>

fn bindless_slot_count() -> Option<BindlessSlabResourceLimit>

The number of slots per bind group, if bindless mode is enabled.

fn bindless_supported(_: &RenderDevice) -> bool

True if the hardware actually supports bindless textures for this type, taking the device and driver capabilities into account.

fn as_bind_group( &self, layout_descriptor: &BindGroupLayoutDescriptor, render_device: &RenderDevice, pipeline_cache: &PipelineCache, param: &mut <Self::Param as SystemParam>::Item<'_, '_>, ) -> Result<PreparedBindGroup, AsBindGroupError>

Creates a bind group for self matching the layout defined in [AsBindGroup::bind_group_layout].

fn bind_group_layout(render_device: &RenderDevice) -> BindGroupLayout

where Self: Sized,

Creates the bind group layout matching all bind groups returned by [AsBindGroup::as_bind_group]

fn bind_group_layout_descriptor( render_device: &RenderDevice, ) -> BindGroupLayoutDescriptor

where Self: Sized,

Creates the bind group layout descriptor matching all bind groups returned by [AsBindGroup::as_bind_group] TODO: we only need RenderDevice to determine if bindless is supported

impl Clone for Material

fn clone(&self) -> Material

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Material

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Material2d for Material

fn fragment_shader() -> ShaderRef

Returns this material’s fragment shader. If [ShaderRef::Default] is returned, the default mesh fragment shader will be used.

fn vertex_shader() -> ShaderRef

Returns this material’s vertex shader. If [ShaderRef::Default] is returned, the default mesh vertex shader will be used.

fn alpha_mode(&self) -> AlphaMode2d

fn depth_bias(&self) -> f32

Add a bias to the view depth of the mesh which can be used to force a specific render order.

fn specialize( descriptor: &mut RenderPipelineDescriptor, layout: &MeshVertexBufferLayoutRef, key: Material2dKey<Self>, ) -> Result<(), SpecializedMeshPipelineError>

Customizes the default [RenderPipelineDescriptor].

impl TypePath for Material

fn type_path() -> &'static str

Returns the fully qualified path of the underlying type.

fn short_type_path() -> &'static str

Returns a short, pretty-print enabled path to the type.

fn type_ident() -> Option<&'static str>

Returns the name of the type, or None if it is anonymous.

fn crate_name() -> Option<&'static str>

Returns the name of the crate the type is in, or None if it is anonymous.

fn module_path() -> Option<&'static str>

Returns the path to the module the type is in, or None if it is anonymous.

impl VisitAssetDependencies for Material

fn visit_dependencies(&self, visit: &mut impl FnMut(UntypedAssetId))

impl Asset for Material