e6ba9a6d18
# Objective Closes #18075 In order to enable a number of patterns for dynamic materials in the engine, it's necessary to decouple the renderer from the `Material` trait. This opens the possibility for: - Materials that aren't coupled to `AsBindGroup`. - 2d using the underlying 3d bindless infrastructure. - Dynamic materials that can change their layout at runtime. - Materials that aren't even backed by a Rust struct at all. ## Solution In short, remove all trait bounds from render world material systems and resources. This means moving a bunch of stuff onto `MaterialProperties` and engaging in some hacks to make specialization work. Rather than storing the bind group data in `MaterialBindGroupAllocator`, right now we're storing it in a closure on `MaterialProperties`. TBD if this has bad performance characteristics. ## Benchmarks - `many_cubes`: `cargo run --example many_cubes --release --features=bevy/trace_tracy -- --vary-material-data-per-instance`:  - @DGriffin91's Caldera `cargo run --release --features=bevy/trace_tracy -- --random-materials`  - @DGriffin91's Caldera with 20 unique material types (i.e. `MaterialPlugin<M>`) and random materials per mesh `cargo run --release --features=bevy/trace_tracy -- --random-materials`  ### TODO - We almost certainly lost some parallelization from removing the type params that could be gained back from smarter iteration. - Test all the things that could have broken. - ~Fix meshlets~ ## Showcase See [the example](https://github.com/bevyengine/bevy/pull/19667/files#diff-9d768cfe1c3aa81eff365d250d3cbe5a63e8df63e81dd85f64c3c3cd993f6d94) for a custom material implemented without the use of the `Material` trait and thus `AsBindGroup`.  --------- Co-authored-by: IceSentry <IceSentry@users.noreply.github.com> Co-authored-by: IceSentry <c.giguere42@gmail.com>
83 lines
3.0 KiB
TOML
83 lines
3.0 KiB
TOML
[package]
|
|
name = "bevy_pbr"
|
|
version = "0.17.0-dev"
|
|
edition = "2024"
|
|
description = "Adds PBR rendering to Bevy Engine"
|
|
homepage = "https://bevy.org"
|
|
repository = "https://github.com/bevyengine/bevy"
|
|
license = "MIT OR Apache-2.0"
|
|
keywords = ["bevy"]
|
|
|
|
[features]
|
|
webgl = []
|
|
webgpu = []
|
|
pbr_transmission_textures = []
|
|
pbr_multi_layer_material_textures = []
|
|
pbr_anisotropy_texture = []
|
|
experimental_pbr_pcss = []
|
|
pbr_specular_textures = []
|
|
shader_format_glsl = ["bevy_render/shader_format_glsl"]
|
|
trace = ["bevy_render/trace"]
|
|
# Enables the meshlet renderer for dense high-poly scenes (experimental)
|
|
meshlet = ["dep:lz4_flex", "dep:range-alloc", "dep:half", "dep:bevy_tasks"]
|
|
# Enables processing meshes into meshlet meshes
|
|
meshlet_processor = [
|
|
"meshlet",
|
|
"dep:meshopt",
|
|
"dep:metis",
|
|
"dep:itertools",
|
|
"dep:bitvec",
|
|
]
|
|
|
|
[dependencies]
|
|
# bevy
|
|
bevy_app = { path = "../bevy_app", version = "0.17.0-dev" }
|
|
bevy_asset = { path = "../bevy_asset", version = "0.17.0-dev" }
|
|
bevy_color = { path = "../bevy_color", version = "0.17.0-dev" }
|
|
bevy_core_pipeline = { path = "../bevy_core_pipeline", version = "0.17.0-dev" }
|
|
bevy_derive = { path = "../bevy_derive", version = "0.17.0-dev" }
|
|
bevy_diagnostic = { path = "../bevy_diagnostic", version = "0.17.0-dev" }
|
|
bevy_ecs = { path = "../bevy_ecs", version = "0.17.0-dev" }
|
|
bevy_image = { path = "../bevy_image", version = "0.17.0-dev" }
|
|
bevy_math = { path = "../bevy_math", version = "0.17.0-dev" }
|
|
bevy_reflect = { path = "../bevy_reflect", version = "0.17.0-dev" }
|
|
bevy_render = { path = "../bevy_render", version = "0.17.0-dev" }
|
|
bevy_tasks = { path = "../bevy_tasks", version = "0.17.0-dev", optional = true }
|
|
bevy_transform = { path = "../bevy_transform", version = "0.17.0-dev" }
|
|
bevy_utils = { path = "../bevy_utils", version = "0.17.0-dev" }
|
|
bevy_window = { path = "../bevy_window", version = "0.17.0-dev" }
|
|
bevy_platform = { path = "../bevy_platform", version = "0.17.0-dev", default-features = false, features = [
|
|
"std",
|
|
] }
|
|
|
|
# other
|
|
bitflags = { version = "2.3", features = ["bytemuck"] }
|
|
fixedbitset = "0.5"
|
|
thiserror = { version = "2", default-features = false }
|
|
derive_more = { version = "2", default-features = false, features = ["from"] }
|
|
# meshlet
|
|
lz4_flex = { version = "0.11", default-features = false, features = [
|
|
"frame",
|
|
], optional = true }
|
|
range-alloc = { version = "0.1.3", optional = true }
|
|
half = { version = "2", features = ["bytemuck"], optional = true }
|
|
meshopt = { version = "0.4.1", optional = true }
|
|
metis = { version = "0.2", optional = true }
|
|
itertools = { version = "0.14", optional = true }
|
|
bitvec = { version = "1", optional = true }
|
|
# direct dependency required for derive macro
|
|
bytemuck = { version = "1", features = ["derive", "must_cast"] }
|
|
radsort = "0.1"
|
|
smallvec = "1.6"
|
|
nonmax = "0.5"
|
|
static_assertions = "1"
|
|
tracing = { version = "0.1", default-features = false, features = ["std"] }
|
|
offset-allocator = "0.2"
|
|
|
|
[lints]
|
|
workspace = true
|
|
|
|
[package.metadata.docs.rs]
|
|
rustdoc-args = ["-Zunstable-options", "--generate-link-to-definition"]
|
|
all-features = true
|