Skip to content

Latest commit

 

History

History
334 lines (246 loc) · 24.6 KB

CHANGELOG.md

File metadata and controls

334 lines (246 loc) · 24.6 KB
Raw

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.

[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 ⭐

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 🛠

[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_dynamicPR#394, vector_insert_dynamicPR#411, textures::StorageImage2dPR#434, any/allPR#380, discardPR#441, demote_to_helper_invocationPR#380, SampledImagePR#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.