fc831c390d
This commit adds support for *decal projectors* to Bevy, allowing for textures to be projected on top of geometry. Decal projectors are clusterable objects, just as punctual lights and light probes are. This means that decals are only evaluated for objects within the conservative bounds of the projector, and they don't require a second pass. These clustered decals require support for bindless textures and as such currently don't work on WebGL 2, WebGPU, macOS, or iOS. For an alternative that doesn't require bindless, see PR #16600. I believe that both contact projective decals in #16600 and clustered decals are desirable to have in Bevy. Contact projective decals offer broader hardware and driver support, while clustered decals don't require the creation of bounding geometry. A new example, `decal_projectors`, has been added, which demonstrates multiple decals on a rotating object. The decal projectors can be scaled and rotated with the mouse. There are several limitations of this initial patch that can be addressed in follow-ups: 1. There's no way to specify the Z-index of decals. That is, the order in which multiple decals are blended on top of one another is arbitrary. A follow-up could introduce some sort of Z-index field so that artists can specify that some decals should be blended on top of others. 2. Decals don't take the normal of the surface they're projected onto into account. Most decal implementations in other engines have a feature whereby the angle between the decal projector and the normal of the surface must be within some threshold for the decal to appear. Often, artists can specify a fade-off range for a smooth transition between oblique surfaces and aligned surfaces. 3. There's no distance-based fadeoff toward the end of the projector range. Many decal implementations have this. This addresses #2401. ## Showcase 
120 lines
5.0 KiB
WebGPU Shading Language
120 lines
5.0 KiB
WebGPU Shading Language
#define_import_path bevy_pbr::mesh_view_bindings
|
|
|
|
#import bevy_pbr::mesh_view_types as types
|
|
#import bevy_render::{
|
|
view::View,
|
|
globals::Globals,
|
|
}
|
|
|
|
@group(0) @binding(0) var<uniform> view: View;
|
|
@group(0) @binding(1) var<uniform> lights: types::Lights;
|
|
#ifdef NO_CUBE_ARRAY_TEXTURES_SUPPORT
|
|
@group(0) @binding(2) var point_shadow_textures: texture_depth_cube;
|
|
#else
|
|
@group(0) @binding(2) var point_shadow_textures: texture_depth_cube_array;
|
|
#endif
|
|
@group(0) @binding(3) var point_shadow_textures_comparison_sampler: sampler_comparison;
|
|
#ifdef PCSS_SAMPLERS_AVAILABLE
|
|
@group(0) @binding(4) var point_shadow_textures_linear_sampler: sampler;
|
|
#endif // PCSS_SAMPLERS_AVAILABLE
|
|
#ifdef NO_ARRAY_TEXTURES_SUPPORT
|
|
@group(0) @binding(5) var directional_shadow_textures: texture_depth_2d;
|
|
#else
|
|
@group(0) @binding(5) var directional_shadow_textures: texture_depth_2d_array;
|
|
#endif
|
|
@group(0) @binding(6) var directional_shadow_textures_comparison_sampler: sampler_comparison;
|
|
#ifdef PCSS_SAMPLERS_AVAILABLE
|
|
@group(0) @binding(7) var directional_shadow_textures_linear_sampler: sampler;
|
|
#endif // PCSS_SAMPLERS_AVAILABLE
|
|
|
|
#if AVAILABLE_STORAGE_BUFFER_BINDINGS >= 3
|
|
@group(0) @binding(8) var<storage> clusterable_objects: types::ClusterableObjects;
|
|
@group(0) @binding(9) var<storage> clusterable_object_index_lists: types::ClusterLightIndexLists;
|
|
@group(0) @binding(10) var<storage> cluster_offsets_and_counts: types::ClusterOffsetsAndCounts;
|
|
#else
|
|
@group(0) @binding(8) var<uniform> clusterable_objects: types::ClusterableObjects;
|
|
@group(0) @binding(9) var<uniform> clusterable_object_index_lists: types::ClusterLightIndexLists;
|
|
@group(0) @binding(10) var<uniform> cluster_offsets_and_counts: types::ClusterOffsetsAndCounts;
|
|
#endif
|
|
|
|
@group(0) @binding(11) var<uniform> globals: Globals;
|
|
@group(0) @binding(12) var<uniform> fog: types::Fog;
|
|
@group(0) @binding(13) var<uniform> light_probes: types::LightProbes;
|
|
|
|
const VISIBILITY_RANGE_UNIFORM_BUFFER_SIZE: u32 = 64u;
|
|
#if AVAILABLE_STORAGE_BUFFER_BINDINGS >= 6
|
|
@group(0) @binding(14) var<storage> visibility_ranges: array<vec4<f32>>;
|
|
#else
|
|
@group(0) @binding(14) var<uniform> visibility_ranges: array<vec4<f32>, VISIBILITY_RANGE_UNIFORM_BUFFER_SIZE>;
|
|
#endif
|
|
|
|
@group(0) @binding(15) var<uniform> ssr_settings: types::ScreenSpaceReflectionsSettings;
|
|
@group(0) @binding(16) var screen_space_ambient_occlusion_texture: texture_2d<f32>;
|
|
|
|
#ifdef MULTIPLE_LIGHT_PROBES_IN_ARRAY
|
|
@group(0) @binding(17) var diffuse_environment_maps: binding_array<texture_cube<f32>, 8u>;
|
|
@group(0) @binding(18) var specular_environment_maps: binding_array<texture_cube<f32>, 8u>;
|
|
#else
|
|
@group(0) @binding(17) var diffuse_environment_map: texture_cube<f32>;
|
|
@group(0) @binding(18) var specular_environment_map: texture_cube<f32>;
|
|
#endif
|
|
@group(0) @binding(19) var environment_map_sampler: sampler;
|
|
@group(0) @binding(20) var<uniform> environment_map_uniform: types::EnvironmentMapUniform;
|
|
|
|
#ifdef IRRADIANCE_VOLUMES_ARE_USABLE
|
|
#ifdef MULTIPLE_LIGHT_PROBES_IN_ARRAY
|
|
@group(0) @binding(21) var irradiance_volumes: binding_array<texture_3d<f32>, 8u>;
|
|
#else
|
|
@group(0) @binding(21) var irradiance_volume: texture_3d<f32>;
|
|
#endif
|
|
@group(0) @binding(22) var irradiance_volume_sampler: sampler;
|
|
#endif
|
|
|
|
#ifdef CLUSTERED_DECALS_ARE_USABLE
|
|
@group(0) @binding(23) var<storage> clustered_decals: types::ClusteredDecals;
|
|
@group(0) @binding(24) var clustered_decal_textures: binding_array<texture_2d<f32>, 8u>;
|
|
@group(0) @binding(25) var clustered_decal_sampler: sampler;
|
|
#endif // CLUSTERED_DECALS_ARE_USABLE
|
|
|
|
// NB: If you change these, make sure to update `tonemapping_shared.wgsl` too.
|
|
@group(0) @binding(26) var dt_lut_texture: texture_3d<f32>;
|
|
@group(0) @binding(27) var dt_lut_sampler: sampler;
|
|
|
|
#ifdef MULTISAMPLED
|
|
#ifdef DEPTH_PREPASS
|
|
@group(0) @binding(28) var depth_prepass_texture: texture_depth_multisampled_2d;
|
|
#endif // DEPTH_PREPASS
|
|
#ifdef NORMAL_PREPASS
|
|
@group(0) @binding(29) var normal_prepass_texture: texture_multisampled_2d<f32>;
|
|
#endif // NORMAL_PREPASS
|
|
#ifdef MOTION_VECTOR_PREPASS
|
|
@group(0) @binding(30) var motion_vector_prepass_texture: texture_multisampled_2d<f32>;
|
|
#endif // MOTION_VECTOR_PREPASS
|
|
|
|
#else // MULTISAMPLED
|
|
|
|
#ifdef DEPTH_PREPASS
|
|
@group(0) @binding(28) var depth_prepass_texture: texture_depth_2d;
|
|
#endif // DEPTH_PREPASS
|
|
#ifdef NORMAL_PREPASS
|
|
@group(0) @binding(29) var normal_prepass_texture: texture_2d<f32>;
|
|
#endif // NORMAL_PREPASS
|
|
#ifdef MOTION_VECTOR_PREPASS
|
|
@group(0) @binding(30) var motion_vector_prepass_texture: texture_2d<f32>;
|
|
#endif // MOTION_VECTOR_PREPASS
|
|
|
|
#endif // MULTISAMPLED
|
|
|
|
#ifdef DEFERRED_PREPASS
|
|
@group(0) @binding(31) var deferred_prepass_texture: texture_2d<u32>;
|
|
#endif // DEFERRED_PREPASS
|
|
|
|
@group(0) @binding(32) var view_transmission_texture: texture_2d<f32>;
|
|
@group(0) @binding(33) var view_transmission_sampler: sampler;
|
|
|
|
#ifdef OIT_ENABLED
|
|
@group(0) @binding(34) var<storage, read_write> oit_layers: array<vec2<u32>>;
|
|
@group(0) @binding(35) var<storage, read_write> oit_layer_ids: array<atomic<i32>>;
|
|
@group(0) @binding(36) var<uniform> oit_settings: types::OrderIndependentTransparencySettings;
|
|
#endif // OIT_ENABLED
|