mirror of
https://github.com/bevyengine/bevy
synced 2024-12-19 17:43:07 +00:00
bfd1d4b0a7
# Objective Update Bevy to wgpu 0.15. ## Changelog - Update to wgpu 0.15, wgpu-hal 0.15.1, and naga 0.11 - Users can now use the [DirectX Shader Compiler](https://github.com/microsoft/DirectXShaderCompiler) (DXC) on Windows with DX12 for faster shader compilation and ShaderModel 6.0+ support (requires `dxcompiler.dll` and `dxil.dll`, which are included in DXC downloads from [here](https://github.com/microsoft/DirectXShaderCompiler/releases/latest)) ## Migration Guide ### WGSL Top-Level `let` is now `const` All top level constants are now declared with `const`, catching up with the wgsl spec. `let` is no longer allowed at the global scope, only within functions. ```diff -let SOME_CONSTANT = 12.0; +const SOME_CONSTANT = 12.0; ``` #### `TextureDescriptor` and `SurfaceConfiguration` now requires a `view_formats` field The new `view_formats` field in the `TextureDescriptor` is used to specify a list of formats the texture can be re-interpreted to in a texture view. Currently only changing srgb-ness is allowed (ex. `Rgba8Unorm` <=> `Rgba8UnormSrgb`). You should set `view_formats` to `&[]` (empty) unless you have a specific reason not to. #### The DirectX Shader Compiler (DXC) is now supported on DX12 DXC is now the default shader compiler when using the DX12 backend. DXC is Microsoft's replacement for their legacy FXC compiler, and is faster, less buggy, and allows for modern shader features to be used (ShaderModel 6.0+). DXC requires `dxcompiler.dll` and `dxil.dll` to be available, otherwise it will log a warning and fall back to FXC. You can get `dxcompiler.dll` and `dxil.dll` by downloading the latest release from [Microsoft's DirectXShaderCompiler github repo](https://github.com/microsoft/DirectXShaderCompiler/releases/latest) and copying them into your project's root directory. These must be included when you distribute your Bevy game/app/etc if you plan on supporting the DX12 backend and are using DXC. `WgpuSettings` now has a `dx12_shader_compiler` field which can be used to choose between either FXC or DXC (if you pass None for the paths for DXC, it will check for the .dlls in the working directory). |
||
|---|---|---|
| .. | ||
| clustered_forward.wgsl | ||
| depth.wgsl | ||
| fog.rs | ||
| fog.wgsl | ||
| light.rs | ||
| mesh.rs | ||
| mesh.wgsl | ||
| mesh_bindings.wgsl | ||
| mesh_functions.wgsl | ||
| mesh_types.wgsl | ||
| mesh_vertex_output.wgsl | ||
| mesh_view_bindings.wgsl | ||
| mesh_view_types.wgsl | ||
| mod.rs | ||
| pbr.wgsl | ||
| pbr_bindings.wgsl | ||
| pbr_functions.wgsl | ||
| pbr_lighting.wgsl | ||
| pbr_prepass.wgsl | ||
| pbr_types.wgsl | ||
| shadows.wgsl | ||
| skinning.wgsl | ||
| utils.wgsl | ||
| wireframe.wgsl | ||