rust-gpu/CHANGELOG.md

rust-gpu Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Removed 🔥

• PR#1052 removed --no-spirt, committing to SPIR-T as a mandatory part of the Rust-GPU compiler backend, to reduce the cost of maintenance, testing and further feature development
  • Note: if you were using --no-spirt to work around naga issue #1977
    (valid loops causing The 'break' is used outside of a 'loop' or 'switch' context),
    you may be able to cargo update -p naga to update to a fixed naga version
    (0.11.1 for wgpu 0.15, 0.12.1 for wgpu 0.16, and any later versions)

Fixed 🩹

• PR#1059 fixed the inline pass not copying OpDecorates in the callee (which led to their loss).

[0.7.0]

Added ⭐

• PR#1020 added SPIR-T qptr support in the form of --spirt-passes=qptr, a way to turn off "Storage Class inference", and reporting for SPIR-T diagnostics - to test qptr fully, you can use:
  RUSTGPU_CODEGEN_ARGS="--no-infer-storage-classes --spirt-passes=qptr"
  (see also the SPIR-T qptr PR for more details about the qptr experiment)
• PR#1039 added new experimental sample_with to Image API to set additional image operands
• PR#1031 added Components generic parameter to Image type, allowing images to return lower dimensional vectors and even scalars from the sampling API

Changed 🛠

• PR#1040 refactored "zombie" (delayed error) reporting to use SPIR-V OpSource, be more helpful, and added --no-early-report-zombies to delay it even further
  (see also the --no-early-report-zombies codegen args docs)
• PR#1035 reduced the number of CGUs ("codegen units") used by spirv-builder to just 1
• PR#1011 made NonWritable all read-only storage buffers (i.e. those typed &T, where T doesn't have interior mutability)
• PR#1029 fixed SampledImage::sample() fns being unnecessarily marked as unsafe

Fixed 🩹

• PR#1041 fixed Image::gather() not always returning a Vec4.
• PR#1025 fixed #1024 by keeping checked arithmetic "zombie" bools disjoint from normal bool (false) consts
• PR#1023 fixed #1021 by always inlining calls with "not obviously legal" pointer args (instead of only inlining calls with "obviously illegal" pointer args)
• PR#1009 fixed #1008 by reinstating mutability checks for entry-point parameters pointing into read-only storage classes (e.g. #[spirv(uniform)] x: &mut u32 is now again an error)
• PR#995 fixed #994 by using OpAtomicFAddEXT instead of OpAtomicFMaxEXT in atomic_f_add

[0.6.1]

Fixed 🩹

• PR#1006 fixed #1002 by rewriting away all spirv-std uses of asm!("OpReturnValue %result") and disallowing OpReturn/OpReturnValue from inline asm! (as it's always UB to leave asm! blocks in any way other than falling through their end)

[0.6.0]

Added ⭐

• PR#998 added extra_arg() SpirvBuilder API to be able to set codegen args otherwise not supported by the API (for example, to set --spirv-passes)

Changed 🛠

• PR#999 made the SPIR-🇹 shader IR framework the default (you can opt out via RUSTGPU_CODEGEN_ARGS=--no-spirt)
• PR#992 renamed rust-toolchain to rust-toolchain.toml
• PR#991 updated toolchain to nightly-2023-01-21
• PR#990 removed return type inference from Image API and made glam usage mandatory

[0.5.0]

Added ⭐

• PR#988 added a couple of (highly experimental) SPIR-🇹 optimization passes, and --spirt-passes=... codegen args as a way to enable them
  (see also the --spirt-passes codegen args docs)

Changed 🛠️

• PR#982 updated toolchain to nightly-2022-12-18
• PR#953 migrated to the Rust 2021 edition, and fixed Rust 2021 support for shader crates to be on par with Rust 2018 (discrepancies having been limited to/caused by panic! changes in Rust 2021)

[0.4.0]

Added ⭐

• PR#959 added two spirv-builder environment variables to customize only the rustc invocations for shader crates and their dependencies:
  • RUSTGPU_RUSTFLAGS="..." for shader RUSTFLAGS="..."
  • RUSTGPU_CODEGEN_ARGS="..." for shader "codegen args" (i.e. RUSTFLAGS=-Cllvm-args="...")
    (check out the "codegen args" docs, or run with RUSTGPU_CODEGEN_ARGS=--help to see the full list of options)
• PR#940 integrated the experimental SPIR-🇹 shader IR framework into the linker
  (opt-in via RUSTGPU_CODEGEN_ARGS=--spirt, see also the --spirt docs, for more details)

Changed 🛠️

• PR#958 updated toolchain to nightly-2022-10-29
• PR#941 applied workspace inheritance to Cargo.toml files
• PR#959 moved rustc_codegen_spirv debugging functionality from environment variables to "codegen args" options/flags (see the updated docs for more details)
• PR#967 made --dump-* "codegen args" include identifying information (e.g. crate names) in the names of files they emit

Removed 🔥

• PR#946 removed the fn/closure #[spirv(unroll_loops)] attribute, as it has no users, is becoming non-trivial to support, and requires redesign for better ergonomics (e.g. #[spirv(unroll)] applied to individual loops, not the whole fn/closure)

[0.4.0-alpha.17]

Fixed 🩹

• PR#937 fixed Rust-GPU crates not referring to each-other by exact version
• PR#937 fixed spirv-std referring to an older version of spirv-std-macros

[0.4.0-alpha.16]

Added ⭐

• PR#935 added check for environment variable RUSTGPU_SKIP_TOOLCHAIN_CHECK to prevent toolchain check

Changed 🛠️

• 🚨BREAKING🚨 #926 migrated from register_attr to register_tool. More information.
• PR#935 updated toolchain to nightly-2022-10-01
• PR#934 updated glam to 0.22
• PR#928 updated spirv-tools to 0.9 (SPIRV-Tools 2022.4)

Removed 🔥

• PR#934 Removed glam::BVec support (they are no longer #[repl(simd)] in glam, as Rust doesn't support SIMD vectors with bool elements)

Fixed 🩹

• PR#927 re-taught Cargo to rebuild shader crates when rustc_codegen_spirv is rebuilt, via -Zbinary-dep-depinfo (broken since a toolchain update in 0.4.0-alpha.13, and has been causing spurious build failures ever since)

[0.4.0-alpha.15]

Added ⭐

• PR#919 added a build-time check for the nightly toolchain version, to provide user-friendly error messages

Changed 🛠️

• PR#918 updated toolchain to nightly-2022-08-29

[0.4.0-alpha.14]

Changed 🛠

• PR#904 renamed helper spirv-types crate to spirv-std-types

[0.4.0-alpha.13]

Added ⭐

• PR#717 added noreturn support to inline asm!
• PR#742 added a spirv-builder option to include all debug info
• PR#787 documented Cargo.toml [profile.⋯.build-override] setting for avoiding slow builds
• PR#830 added a spirv-builder option to preserve unused descriptor bindings
• PR#875 added warnings for #[inline(never)]s the inliner doesn't respect (for legalization reasons)
• PR#848 added #[spirv(subgroup_local_invocation_id)] built-in (and an examples/shaders/reduce compute shader)
• new spirv-std APIs: ByteAddressableBuffer^#735, SampledImage::sample_by_lod^#755, arch::read_clock_khr^#757, arch::{signed,unsigned}_{min,max}^#763, debug_printf!^#768, arch::*memory_barrier*^#769, arch::IndexUnchecked^#805, RayQuery::confirm_intersection^#822, arch::atomic_i_increment^#839, arch::atomic^#877

Changed 🛠

• PR#743 set the SPIR-V "generator magic number" to the value reserved for Rust-GPU
• PR#761 made spirv-std build on stable Rust by avoiding enums in const-generics
• PR#784 documented spirv-std throughout
• PR#862 updated toolchain to nightly-2022-04-11
• PR#846 updated spirv-tools to 0.8 (SPIRV-Tools 2022.1)
• PR#888 widened the supported glam version range to 0.17-0.21

Fixed 🩹

• PR#729 fixed #723 by explicitly allowing unused shader inputs/outputs in storage class inference
• PR#732 fixed rustc ICE messages being truncated with rustc_codegen_spirv (broken since a toolchain update in 0.4.0-alpha.12)
• PR#737 fixed #642 by re-adding -Zsymbol-mangling-version=v0 (for generic parameters in fn names)
• PR#766 fixed #373 and #731 by hooking rustc to limit function call ABIs to what Rust-GPU supports
• PR#793 fixed #748 by supporting SPIR-V 1.4's changed entry-point rules
• PR#844 fixed #836 by making newtypes (e.g. single-field structs) wrapping ScalarPairs (e.g. (u32, u32) or &[T]) have the same SPIR-V type as their inner field

[0.4.0-alpha.12]

Added ⭐

• PR#704 added Image::gather and Image::sample_bias to spirv-std
• PR#709 added float packing/unpacking operations to spirv-std

Changed 🛠

• PR#716 updated toolchain to nightly-2021-08-10

Removed 🔥

• PR#710 removed "implicit bindless" and kernel modes

[0.4.0-alpha.11]

Changed 🛠

• PR#702 updated glam to 0.17

[0.4.0-alpha.10]

Added ⭐

• PR#655 added a watch feature to spirv-builder for hot reloading shaders
• PR#652 documented Image! in the Rust-GPU book
• PR#660 added a spirv-builder option to name global OpVariables
• PR#662 added type aliases for common uses of Image!
• PR#683 added a spirv-builder option to treat warnings as errors

Changed 🛠

• PR#672 updated toolchain to nightly-2021-06-09
• PR#674 updated glam to 0.16

Removed 🔥

• PR#666 removed arch::arithmetic from spirv-std

[0.4.0-alpha.9]

Fixed 🩹

• fixed miscompilation in peephole optimizations (see PR#646)

[0.4.0-alpha.8]

Added ⭐

• PR#608 added Image::query_* operations to spirv-std
• PR#610 added spirv-builder support for enabling extra extensions and/or capabilities
• PR#612 added is_helper_invocation to spirv-std
• PR#624 added OpTypeSampler and OpTypeAccelerationStructureKHR support to inline asm!
• PR#622 added the ability to query entry-point names from spirv-builder
• PR#630 added a more convenient API to spirv-builder, for requesting extensions and/or capabilties
• PR#629 added an optimization to convert N identical scalar (e.g. arithmetic) ops, into one N-wide vector op (as e.g. glam only emits the former)
• PR#596 added a RuntimeArray type to spirv-val, to represent SPIR-V OpRuntimeArrays
• PR#635 added several spirv-builder options for controlling spirv-val flags
• PR#643 added Image::read_subpass to spirv-std

Changed 🛠

• PR#616 updated spirv-tools to 0.6.1 and turned on emission of line-based debug info
• PR#631 updated toolchain to nightly-2021-05-24
• PR#641 made spirv-std depend on glam (0.15.2), instead of the other way around

[0.4.0-alpha.7]

Fixed 🩹

• PR#607 removed accidental use of feature(or_patterns) (recently stabilized, only on nightly)

[0.4.0-alpha.6]

Added ⭐

• PR#586 added support for constant memory (&'static _ references), within the limits of SPIR-V
• PR#559 added the ability to set a Rust "target triple" in spirv-builder (e.g. "spirv-unknown-vulkan1.1" for Vulkan 1.1)
• PR#563 added SPV_KHR_ray_tracing APIs to spirv-std
• PR#572 added SPV_KHR_ray_query APIs to spirv-std
• PR#359 added a const-generic Image type, and Image! macro wrapping it (to add "named parameters"), to spirv-std

Changed 🛠

• PR#587 updated glam to 0.14
• PR#605 updated toolchain to nightly-2021-04-25

Fixed 🩹

• PR#594 fixed #585 by explicitly banning Image/Sampler/SampledImage entry-point parameters not behind references
• PR#598 fixed #581 by switching memory::Semantics from an enum to a bitflags!, in spirv-std

[0.4.0-alpha.5]

Removed 🔥

• PR#583 removed memcmp from spirv-std

[0.4.0-alpha.4]

Added ⭐

• PR#519 added memory_barrier and control_barrier to spirv-std

Changed 🛠

• PR#567 removed the need to manually specify the storage class for Image/Sampler/ImageSampler entry-point parameters

Deprecated 🚧

• PR#576 deprecated #[spirv(block)] in favor of automatically wrapping the user types in "interface blocks"

[0.4.0-alpha.3]

Added ⭐

• PR#551 added multi-module (one SPIR-V module per entry-point) support to spirv-builder
• PR#504 added basic support for unsized structs (e.g. ending with a [T] field)
• PR#545 added Image methods for sampling depth reference and/or with project coordinate, to spirv-std

[0.4.0-alpha.2]

Added ⭐

• PR#541 added #[spirv(invariant)] (like the invariant keyword in GLSL)

Fixed 🩹

• made arch::derivative functions public, in spirv-std

[0.4.0-alpha.1]

Added ⭐

• PR#498 added sample_by_lod/sample_by_gradient image methods to spirv-std
• PR#521 added Cubemap to spirv-std
• PR#520 added arch::primitive functions to spirv-std

Changed 🛠

• PR#496 updated spirv-tools to 0.5.0
• PR#516 updated toolchain to nightly-2021-03-21
• PR#443 replaced spirv_std::storage_class "named pointer types" with #[spirv(...)] &T entry-point parameters

[0.3.1]

Added ⭐

• PR#480 added a fetch image method to spirv-std
• PR#446 added arch::* functions for all SPIR-V arithmetic operations (not involving matrices), to spirv-std

Removed 🔥

• PR#476 removed glam as a dependency of spirv-std

[0.3.0]

Added ⭐

• PR#414 added storage class type inference
• PR#469 added initial support for Algebraic Data Type enums (e.g. Option<T>)
• PR#421 added ability to provide const arguments to asm!
• PR#458 added ability to set entry_point_name in entry point attributes to change the final name of an entry point
• PR#337 added #[spirv(unroll_loops)] attribute to functions, which tells rustc_codegen_spirv to annotate all loops inside with Unroll
• PR#394 added a new [arch] module which provides an abstraction some basic SPIR-V instructions as free functions.
• PR#340 added the spirv-std-macros crate for holding the spirv proc macro
• PR#392 added the gpu_only proc macro
• PR#377 Derivative is now implemented for glam::{Vec2, Vec3, Vec3A, Vec4}
• PR#401 added ability to build shaders in release mode
• new spirv-std APIs: vector_extract_dynamic^PR#394, vector_insert_dynamic^PR#411, textures::StorageImage2d^PR#434, any/all^PR#380, discard^PR#441, demote_to_helper_invocation^PR#380, SampledImage^PR#320

Changed 🛠

• PR#461 removed requirement of #[allow(unused_attributes)] in front of #[spirv] attributes to remove warnings
• PR#398 rustc_codegen_spirv now removes different OpNames that target the same ID
• PR#396 rustc_codegen_spirv now tries to deduplicate generated OpVariables

[0.2.0]

Added ⭐

• PR#287 added a new structurizer, which means that you can now use match expressions and continues
• PR#317 added the #[spirv(flat)] attribute that matches SPIR-V's "Flat" decorator.
• PR#276 added support for textures.
• PR#305 added support for panic!
• PR#165 added support for SPIR-V 1.0
• PR#268 added support for procedural macros
• PR#195 added initial support for compute shaders
• PR#254 added initial support in Rust and rust-gpu for inline SPIR-V with the asm! nightly feature

Changed 🛠

• PR#219 improvements to error messages regarding constant pointers
• PR#280 all Storage Classes (e.g. Input/Output) are now defined in spirv_std::storage_class
• PR#275 Rust's language items such rust_eh_personality and panic_handler are now defined in spirv-std for SPIR-V targets

[0.1.0]

Initial release.