diff --git a/crates/bevy_pbr/src/lib.rs b/crates/bevy_pbr/src/lib.rs index 997a0b99caac3..da63545eed6f0 100644 --- a/crates/bevy_pbr/src/lib.rs +++ b/crates/bevy_pbr/src/lib.rs @@ -422,13 +422,13 @@ impl Plugin for PbrPlugin { app.add_plugins(DeferredPbrLightingPlugin); } - // Initialize the default material. + // Initialize the default material handle. app.world_mut() .resource_mut::>() .insert( &Handle::::default(), StandardMaterial { - base_color: Color::WHITE, + base_color: Color::srgb(1.0, 0.0, 0.5), ..Default::default() }, ); @@ -439,14 +439,7 @@ impl Plugin for PbrPlugin { // Extract the required data from the main world render_app - .add_systems( - ExtractSchedule, - ( - extract_clusters, - extract_lights, - extract_default_materials.after(clear_material_instances::), - ), - ) + .add_systems(ExtractSchedule, (extract_clusters, extract_lights)) .add_systems( Render, ( diff --git a/crates/bevy_pbr/src/material.rs b/crates/bevy_pbr/src/material.rs index 2a06aee19c20f..916b5a4676476 100644 --- a/crates/bevy_pbr/src/material.rs +++ b/crates/bevy_pbr/src/material.rs @@ -270,7 +270,6 @@ where fn build(&self, app: &mut App) { app.init_asset::() .register_type::>() - .register_type::() .add_plugins(RenderAssetPlugin::>::default()); if let Some(render_app) = app.get_sub_app_mut(RenderApp) { @@ -283,10 +282,7 @@ where .add_render_command::>() .add_render_command::>() .init_resource::>>() - .add_systems( - ExtractSchedule, - (clear_material_instances::, extract_mesh_materials::).chain(), - ) + .add_systems(ExtractSchedule, extract_mesh_materials::) .add_systems( Render, queue_material_meshes:: @@ -550,16 +546,12 @@ pub const fn screen_space_specular_transmission_pipeline_key( } } -pub(super) fn clear_material_instances( - mut material_instances: ResMut>, -) { - material_instances.clear(); -} - fn extract_mesh_materials( mut material_instances: ResMut>, query: Extract)>>, ) { + material_instances.clear(); + for (entity, view_visibility, material) in &query { if view_visibility.get() { material_instances.insert(entity.into(), material.id()); @@ -567,18 +559,6 @@ fn extract_mesh_materials( } } -/// Extracts default materials for 3D meshes with no [`MeshMaterial3d`]. -pub(super) fn extract_default_materials( - mut material_instances: ResMut>, - query: Extract, Without)>>, -) { - for (entity, view_visibility) in &query { - if view_visibility.get() { - material_instances.insert(entity.into(), AssetId::default()); - } - } -} - /// For each view, iterates over all the meshes visible from that view and adds /// them to [`BinnedRenderPhase`]s or [`SortedRenderPhase`]s as appropriate. #[allow(clippy::too_many_arguments)] diff --git a/crates/bevy_pbr/src/mesh_material.rs b/crates/bevy_pbr/src/mesh_material.rs index c737c991b808b..84eaf7cffa79a 100644 --- a/crates/bevy_pbr/src/mesh_material.rs +++ b/crates/bevy_pbr/src/mesh_material.rs @@ -5,7 +5,7 @@ use bevy_ecs::{component::Component, reflect::ReflectComponent}; use bevy_reflect::{std_traits::ReflectDefault, Reflect}; use derive_more::derive::From; -/// A [material](Material) for a [`Mesh3d`]. +/// A [material](Material) used for rendering a [`Mesh3d`]. /// /// See [`Material`] for general information about 3D materials and how to implement your own materials. /// @@ -36,41 +36,8 @@ use derive_more::derive::From; /// )); /// } /// ``` -/// -/// ## Default Material -/// -/// Meshes without a [`MeshMaterial3d`] are rendered with a default [`StandardMaterial`]. -/// This material can be overridden by inserting a custom material for the default asset handle. -/// -/// ``` -/// # use bevy_pbr::{Material, MeshMaterial3d, StandardMaterial}; -/// # use bevy_ecs::prelude::*; -/// # use bevy_render::mesh::{Mesh, Mesh3d}; -/// # use bevy_color::Color; -/// # use bevy_asset::{Assets, Handle}; -/// # use bevy_math::primitives::Capsule3d; -/// # -/// fn setup( -/// mut commands: Commands, -/// mut meshes: ResMut>, -/// mut materials: ResMut>, -/// ) { -/// // Optional: Insert a custom default material. -/// materials.insert( -/// &Handle::::default(), -/// StandardMaterial::from(Color::srgb(1.0, 0.0, 1.0)), -/// ); -/// -/// // Spawn a capsule with no material. -/// // The mesh will be rendered with the default material. -/// commands.spawn(Mesh3d(meshes.add(Capsule3d::default()))); -/// } -/// ``` -/// -/// [`StandardMaterial`]: crate::StandardMaterial #[derive(Component, Clone, Debug, Deref, DerefMut, Reflect, PartialEq, Eq, From)] #[reflect(Component, Default)] -#[require(HasMaterial3d)] pub struct MeshMaterial3d(pub Handle); impl Default for MeshMaterial3d { @@ -90,12 +57,3 @@ impl From<&MeshMaterial3d> for AssetId { material.id() } } - -/// A component that marks an entity as having a [`MeshMaterial3d`]. -/// [`Mesh3d`] entities without this component are rendered with a [default material]. -/// -/// [`Mesh3d`]: bevy_render::mesh::Mesh3d -/// [default material]: crate::MeshMaterial3d#default-material -#[derive(Component, Clone, Debug, Default, Reflect)] -#[reflect(Component, Default)] -pub struct HasMaterial3d; diff --git a/crates/bevy_render/src/mesh/components.rs b/crates/bevy_render/src/mesh/components.rs index cb3d46afa4e6b..2e712c8054b48 100644 --- a/crates/bevy_render/src/mesh/components.rs +++ b/crates/bevy_render/src/mesh/components.rs @@ -6,13 +6,10 @@ use bevy_reflect::{std_traits::ReflectDefault, Reflect}; use bevy_transform::components::Transform; use derive_more::derive::From; -/// A component for rendering 2D meshes, typically with a [`MeshMaterial2d`] using a [`ColorMaterial`]. -/// -/// Meshes without a [`MeshMaterial2d`] will be rendered with a [default material]. +/// A component for 2D meshes. Requires a [`MeshMaterial2d`] to be rendered, commonly using a [`ColorMaterial`]. /// /// [`MeshMaterial2d`]: /// [`ColorMaterial`]: -/// [default material]: /// /// # Example /// @@ -53,13 +50,10 @@ impl From<&Mesh2d> for AssetId { } } -/// A component for rendering 3D meshes, typically with a [`MeshMaterial3d`] using a [`StandardMaterial`]. -/// -/// Meshes without a [`MeshMaterial3d`] will be rendered with a [default material]. +/// A component for 3D meshes. Requires a [`MeshMaterial3d`] to be rendered, commonly using a [`StandardMaterial`]. /// /// [`MeshMaterial3d`]: /// [`StandardMaterial`]: -/// [default material]: /// /// # Example /// diff --git a/crates/bevy_sprite/src/mesh2d/color_material.rs b/crates/bevy_sprite/src/mesh2d/color_material.rs index f2e5aab14e5ea..3b4ce7641627a 100644 --- a/crates/bevy_sprite/src/mesh2d/color_material.rs +++ b/crates/bevy_sprite/src/mesh2d/color_material.rs @@ -1,20 +1,15 @@ #![expect(deprecated)] -use crate::{ - clear_material_2d_instances, extract_default_materials_2d, AlphaMode2d, Material2d, - Material2dPlugin, MaterialMesh2dBundle, -}; +use crate::{AlphaMode2d, Material2d, Material2dPlugin, MaterialMesh2dBundle}; use bevy_app::{App, Plugin}; use bevy_asset::{load_internal_asset, Asset, AssetApp, Assets, Handle}; use bevy_color::{Alpha, Color, ColorToComponents, LinearRgba}; -use bevy_ecs::schedule::IntoSystemConfigs; use bevy_math::Vec4; use bevy_reflect::prelude::*; use bevy_render::{ render_asset::RenderAssets, render_resource::*, texture::{GpuImage, Image}, - ExtractSchedule, RenderApp, }; pub const COLOR_MATERIAL_SHADER_HANDLE: Handle = @@ -35,26 +30,16 @@ impl Plugin for ColorMaterialPlugin { app.add_plugins(Material2dPlugin::::default()) .register_asset_reflect::(); - // Initialize the default material. + // Initialize the default material handle. app.world_mut() .resource_mut::>() .insert( &Handle::::default(), ColorMaterial { - color: Color::WHITE, + color: Color::srgb(1.0, 0.0, 1.0), ..Default::default() }, ); - - let Some(render_app) = app.get_sub_app_mut(RenderApp) else { - return; - }; - - // Extract default materials for entities with no material. - render_app.add_systems( - ExtractSchedule, - extract_default_materials_2d.after(clear_material_2d_instances::), - ); } } diff --git a/crates/bevy_sprite/src/mesh2d/material.rs b/crates/bevy_sprite/src/mesh2d/material.rs index 3a78622b2bcea..cfef74be398f3 100644 --- a/crates/bevy_sprite/src/mesh2d/material.rs +++ b/crates/bevy_sprite/src/mesh2d/material.rs @@ -43,8 +43,6 @@ use bevy_utils::tracing::error; use core::{hash::Hash, marker::PhantomData}; use derive_more::derive::From; -use super::ColorMaterial; - /// Materials are used alongside [`Material2dPlugin`], [`Mesh2d`], and [`MeshMaterial2d`] /// to spawn entities that are rendered with a specific [`Material2d`] type. They serve as an easy to use high level /// way to render [`Mesh2d`] entities with custom shader logic. @@ -151,7 +149,7 @@ pub trait Material2d: AsBindGroup + Asset + Clone + Sized { } } -/// A [material](Material2d) for a [`Mesh2d`]. +/// A [material](Material2d) used for rendering a [`Mesh2d`]. /// /// See [`Material2d`] for general information about 2D materials and how to implement your own materials. /// @@ -179,40 +177,8 @@ pub trait Material2d: AsBindGroup + Asset + Clone + Sized { /// ``` /// /// [`MeshMaterial2d`]: crate::MeshMaterial2d -/// [`ColorMaterial`]: crate::ColorMaterial -/// -/// ## Default Material -/// -/// Meshes without a [`MeshMaterial2d`] are rendered with a default [`ColorMaterial`]. -/// This material can be overridden by inserting a custom material for the default asset handle. -/// -/// ``` -/// # use bevy_sprite::ColorMaterial; -/// # use bevy_ecs::prelude::*; -/// # use bevy_render::mesh::{Mesh, Mesh2d}; -/// # use bevy_color::Color; -/// # use bevy_asset::{Assets, Handle}; -/// # use bevy_math::primitives::Circle; -/// # -/// fn setup( -/// mut commands: Commands, -/// mut meshes: ResMut>, -/// mut materials: ResMut>, -/// ) { -/// // Optional: Insert a custom default material. -/// materials.insert( -/// &Handle::::default(), -/// ColorMaterial::from(Color::srgb(1.0, 0.0, 1.0)), -/// ); -/// -/// // Spawn a circle with no material. -/// // The mesh will be rendered with the default material. -/// commands.spawn(Mesh2d(meshes.add(Circle::new(50.0)))); -/// } -/// ``` #[derive(Component, Clone, Debug, Deref, DerefMut, Reflect, PartialEq, Eq, From)] #[reflect(Component, Default)] -#[require(HasMaterial2d)] pub struct MeshMaterial2d(pub Handle); impl Default for MeshMaterial2d { @@ -233,14 +199,6 @@ impl From<&MeshMaterial2d> for AssetId { } } -/// A component that marks an entity as having a [`MeshMaterial2d`]. -/// [`Mesh2d`] entities without this component are rendered with a [default material]. -/// -/// [default material]: crate::MeshMaterial2d#default-material -#[derive(Component, Clone, Debug, Default, Reflect)] -#[reflect(Component, Default)] -pub struct HasMaterial2d; - /// Sets how a 2d material's base color alpha channel is used for transparency. /// Currently, this only works with [`Mesh2d`]. Sprites are always transparent. /// @@ -284,7 +242,6 @@ where fn build(&self, app: &mut App) { app.init_asset::() .register_type::>() - .register_type::() .add_plugins(RenderAssetPlugin::>::default()); if let Some(render_app) = app.get_sub_app_mut(RenderApp) { @@ -294,14 +251,7 @@ where .add_render_command::>() .init_resource::>() .init_resource::>>() - .add_systems( - ExtractSchedule, - ( - clear_material_2d_instances::, - extract_mesh_materials_2d::, - ) - .chain(), - ) + .add_systems(ExtractSchedule, extract_mesh_materials_2d::) .add_systems( Render, queue_material2d_meshes:: @@ -327,16 +277,12 @@ impl Default for RenderMaterial2dInstances { } } -pub(crate) fn clear_material_2d_instances( - mut material_instances: ResMut>, -) { - material_instances.clear(); -} - fn extract_mesh_materials_2d( mut material_instances: ResMut>, query: Extract), With>>, ) { + material_instances.clear(); + for (entity, view_visibility, material) in &query { if view_visibility.get() { material_instances.insert(entity.into(), material.id()); @@ -344,20 +290,6 @@ fn extract_mesh_materials_2d( } } -/// Extracts default materials for 2D meshes with no [`MeshMaterial2d`]. -pub(crate) fn extract_default_materials_2d( - mut material_instances: ResMut>, - query: Extract, Without)>>, -) { - let default_material: AssetId = Handle::::default().id(); - - for (entity, view_visibility) in &query { - if view_visibility.get() { - material_instances.insert(entity.into(), default_material); - } - } -} - /// Render pipeline data for a given [`Material2d`] #[derive(Resource)] pub struct Material2dPipeline { diff --git a/examples/2d/mesh2d_manual.rs b/examples/2d/mesh2d_manual.rs index 758084fae35c6..b68470f0eda66 100644 --- a/examples/2d/mesh2d_manual.rs +++ b/examples/2d/mesh2d_manual.rs @@ -30,8 +30,8 @@ use bevy::{ Extract, Render, RenderApp, RenderSet, }, sprite::{ - extract_mesh2d, DrawMesh2d, HasMaterial2d, Material2dBindGroupId, Mesh2dPipeline, - Mesh2dPipelineKey, Mesh2dTransforms, MeshFlags, RenderMesh2dInstance, SetMesh2dBindGroup, + extract_mesh2d, DrawMesh2d, Material2dBindGroupId, Mesh2dPipeline, Mesh2dPipelineKey, + Mesh2dTransforms, MeshFlags, RenderMesh2dInstance, SetMesh2dBindGroup, SetMesh2dViewBindGroup, }, }; @@ -120,10 +120,8 @@ fn star( commands.spawn(Camera2d); } -// Require `HasMaterial2d` to indicate that no placeholder material should be rendeed. /// A marker component for colored 2d meshes #[derive(Component, Default)] -#[require(HasMaterial2d)] pub struct ColoredMesh2d; /// Custom pipeline for 2d meshes with vertex colors