31835ff76d
Implement visibility ranges, also known as hierarchical levels of detail (HLODs). This commit introduces a new component, `VisibilityRange`, which allows developers to specify camera distances in which meshes are to be shown and hidden. Hiding meshes happens early in the rendering pipeline, so this feature can be used for level of detail optimization. Additionally, this feature is properly evaluated per-view, so different views can show different levels of detail. This feature differs from proper mesh LODs, which can be implemented later. Engines generally implement true mesh LODs later in the pipeline; they're typically more efficient than HLODs with GPU-driven rendering. However, mesh LODs are more limited than HLODs, because they require the lower levels of detail to be meshes with the same vertex layout and shader (and perhaps the same material) as the original mesh. Games often want to use objects other than meshes to replace distant models, such as *octahedral imposters* or *billboard imposters*. The reason why the feature is called *hierarchical level of detail* is that HLODs can replace multiple meshes with a single mesh when the camera is far away. This can be useful for reducing drawcall count. Note that `VisibilityRange` doesn't automatically propagate down to children; it must be placed on every mesh. Crossfading between different levels of detail is supported, using the standard 4x4 ordered dithering pattern from [1]. The shader code to compute the dithering patterns should be well-optimized. The dithering code is only active when visibility ranges are in use for the mesh in question, so that we don't lose early Z. Cascaded shadow maps show the HLOD level of the view they're associated with. Point light and spot light shadow maps, which have no CSMs, display all HLOD levels that are visible in any view. To support this efficiently and avoid doing visibility checks multiple times, we precalculate all visible HLOD levels for each entity with a `VisibilityRange` during the `check_visibility_range` system. A new example, `visibility_range`, has been added to the tree, as well as a new low-poly version of the flight helmet model to go with it. It demonstrates use of the visibility range feature to provide levels of detail. [1]: https://en.wikipedia.org/wiki/Ordered_dithering#Threshold_map [^1]: Unreal doesn't have a feature that exactly corresponds to visibility ranges, but Unreal's HLOD system serves roughly the same purpose. ## Changelog ### Added * A new `VisibilityRange` component is available to conditionally enable entity visibility at camera distances, with optional crossfade support. This can be used to implement different levels of detail (LODs). ## Screenshots High-poly model:  Low-poly model up close:  Crossfading between the two:  --------- Co-authored-by: Carter Anderson <mcanders1@gmail.com>
99 lines
3.8 KiB
WebGPU Shading Language
99 lines
3.8 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_sampler: sampler_comparison;
|
|
#ifdef NO_ARRAY_TEXTURES_SUPPORT
|
|
@group(0) @binding(4) var directional_shadow_textures: texture_depth_2d;
|
|
#else
|
|
@group(0) @binding(4) var directional_shadow_textures: texture_depth_2d_array;
|
|
#endif
|
|
@group(0) @binding(5) var directional_shadow_textures_sampler: sampler_comparison;
|
|
|
|
#if AVAILABLE_STORAGE_BUFFER_BINDINGS >= 3
|
|
@group(0) @binding(6) var<storage> point_lights: types::PointLights;
|
|
@group(0) @binding(7) var<storage> cluster_light_index_lists: types::ClusterLightIndexLists;
|
|
@group(0) @binding(8) var<storage> cluster_offsets_and_counts: types::ClusterOffsetsAndCounts;
|
|
#else
|
|
@group(0) @binding(6) var<uniform> point_lights: types::PointLights;
|
|
@group(0) @binding(7) var<uniform> cluster_light_index_lists: types::ClusterLightIndexLists;
|
|
@group(0) @binding(8) var<uniform> cluster_offsets_and_counts: types::ClusterOffsetsAndCounts;
|
|
#endif
|
|
|
|
@group(0) @binding(9) var<uniform> globals: Globals;
|
|
@group(0) @binding(10) var<uniform> fog: types::Fog;
|
|
@group(0) @binding(11) var<uniform> light_probes: types::LightProbes;
|
|
|
|
#if AVAILABLE_STORAGE_BUFFER_BINDINGS >= 6
|
|
@group(0) @binding(12) var<storage> visibility_ranges: array<vec4<f32>>;
|
|
#else
|
|
@group(0) @binding(12) var<uniform> visibility_ranges: array<vec4<f32>>;
|
|
#endif
|
|
|
|
@group(0) @binding(13) var screen_space_ambient_occlusion_texture: texture_2d<f32>;
|
|
|
|
#ifdef MULTIPLE_LIGHT_PROBES_IN_ARRAY
|
|
@group(0) @binding(14) var diffuse_environment_maps: binding_array<texture_cube<f32>, 8u>;
|
|
@group(0) @binding(15) var specular_environment_maps: binding_array<texture_cube<f32>, 8u>;
|
|
#else
|
|
@group(0) @binding(14) var diffuse_environment_map: texture_cube<f32>;
|
|
@group(0) @binding(15) var specular_environment_map: texture_cube<f32>;
|
|
#endif
|
|
@group(0) @binding(16) var environment_map_sampler: sampler;
|
|
|
|
#ifdef IRRADIANCE_VOLUMES_ARE_USABLE
|
|
#ifdef MULTIPLE_LIGHT_PROBES_IN_ARRAY
|
|
@group(0) @binding(17) var irradiance_volumes: binding_array<texture_3d<f32>, 8u>;
|
|
#else
|
|
@group(0) @binding(17) var irradiance_volume: texture_3d<f32>;
|
|
#endif
|
|
@group(0) @binding(18) var irradiance_volume_sampler: sampler;
|
|
#endif
|
|
|
|
// NB: If you change these, make sure to update `tonemapping_shared.wgsl` too.
|
|
@group(0) @binding(19) var dt_lut_texture: texture_3d<f32>;
|
|
@group(0) @binding(20) var dt_lut_sampler: sampler;
|
|
|
|
#ifdef MULTISAMPLED
|
|
#ifdef DEPTH_PREPASS
|
|
@group(0) @binding(21) var depth_prepass_texture: texture_depth_multisampled_2d;
|
|
#endif // DEPTH_PREPASS
|
|
#ifdef NORMAL_PREPASS
|
|
@group(0) @binding(22) var normal_prepass_texture: texture_multisampled_2d<f32>;
|
|
#endif // NORMAL_PREPASS
|
|
#ifdef MOTION_VECTOR_PREPASS
|
|
@group(0) @binding(23) var motion_vector_prepass_texture: texture_multisampled_2d<f32>;
|
|
#endif // MOTION_VECTOR_PREPASS
|
|
|
|
#else // MULTISAMPLED
|
|
|
|
#ifdef DEPTH_PREPASS
|
|
@group(0) @binding(21) var depth_prepass_texture: texture_depth_2d;
|
|
#endif // DEPTH_PREPASS
|
|
#ifdef NORMAL_PREPASS
|
|
@group(0) @binding(22) var normal_prepass_texture: texture_2d<f32>;
|
|
#endif // NORMAL_PREPASS
|
|
#ifdef MOTION_VECTOR_PREPASS
|
|
@group(0) @binding(23) var motion_vector_prepass_texture: texture_2d<f32>;
|
|
#endif // MOTION_VECTOR_PREPASS
|
|
|
|
#endif // MULTISAMPLED
|
|
|
|
#ifdef DEFERRED_PREPASS
|
|
@group(0) @binding(24) var deferred_prepass_texture: texture_2d<u32>;
|
|
#endif // DEFERRED_PREPASS
|
|
|
|
@group(0) @binding(25) var view_transmission_texture: texture_2d<f32>;
|
|
@group(0) @binding(26) var view_transmission_sampler: sampler;
|