mirror of
https://github.com/bevyengine/bevy
synced 2024-11-21 20:23:28 +00:00
f398674e51
This commit, a revamp of #12959, implements screen-space reflections (SSR), which approximate real-time reflections based on raymarching through the depth buffer and copying samples from the final rendered frame. This patch is a relatively minimal implementation of SSR, so as to provide a flexible base on which to customize and build in the future. However, it's based on the production-quality [raymarching code by Tomasz Stachowiak](https://gist.github.com/h3r2tic/9c8356bdaefbe80b1a22ae0aaee192db). For a general basic overview of screen-space reflections, see [1](https://lettier.github.io/3d-game-shaders-for-beginners/screen-space-reflection.html). The raymarching shader uses the basic algorithm of tracing forward in large steps, refining that trace in smaller increments via binary search, and then using the secant method. No temporal filtering or roughness blurring, is performed at all; for this reason, SSR currently only operates on very shiny surfaces. No acceleration via the hierarchical Z-buffer is implemented (though note that https://github.com/bevyengine/bevy/pull/12899 will add the infrastructure for this). Reflections are traced at full resolution, which is often considered slow. All of these improvements and more can be follow-ups. SSR is built on top of the deferred renderer and is currently only supported in that mode. Forward screen-space reflections are possible albeit uncommon (though e.g. *Doom Eternal* uses them); however, they require tracing from the previous frame, which would add complexity. This patch leaves the door open to implementing SSR in the forward rendering path but doesn't itself have such an implementation. Screen-space reflections aren't supported in WebGL 2, because they require sampling from the depth buffer, which Naga can't do because of a bug (`sampler2DShadow` is incorrectly generated instead of `sampler2D`; this is the same reason why depth of field is disabled on that platform). To add screen-space reflections to a camera, use the `ScreenSpaceReflectionsBundle` bundle or the `ScreenSpaceReflectionsSettings` component. In addition to `ScreenSpaceReflectionsSettings`, `DepthPrepass` and `DeferredPrepass` must also be present for the reflections to show up. The `ScreenSpaceReflectionsSettings` component contains several settings that artists can tweak, and also comes with sensible defaults. A new example, `ssr`, has been added. It's loosely based on the [three.js ocean sample](https://threejs.org/examples/webgl_shaders_ocean.html), but all the assets are original. Note that the three.js demo has no screen-space reflections and instead renders a mirror world. In contrast to #12959, this demo tests not only a cube but also a more complex model (the flight helmet). ## Changelog ### Added * Screen-space reflections can be enabled for very smooth surfaces by adding the `ScreenSpaceReflections` component to a camera. Deferred rendering must be enabled for the reflections to appear.   |
||
|---|---|---|
| .. | ||
| animate_shader.wgsl | ||
| array_texture.wgsl | ||
| circle_shader.wgsl | ||
| cubemap_unlit.wgsl | ||
| custom_gltf_2d.wgsl | ||
| custom_material.frag | ||
| custom_material.vert | ||
| custom_material.wgsl | ||
| custom_material_2d.wgsl | ||
| custom_material_import.wgsl | ||
| custom_material_screenspace_texture.wgsl | ||
| custom_vertex_attribute.wgsl | ||
| extended_material.wgsl | ||
| fallback_image_test.wgsl | ||
| game_of_life.wgsl | ||
| gpu_readback.wgsl | ||
| instancing.wgsl | ||
| irradiance_volume_voxel_visualization.wgsl | ||
| line_material.wgsl | ||
| post_processing.wgsl | ||
| shader_defs.wgsl | ||
| show_prepass.wgsl | ||
| texture_binding_array.wgsl | ||
| tonemapping_test_patterns.wgsl | ||
| water_material.wgsl | ||