glam

chore: Release package glam version 0.33.12

chore: Release package glam version 0.33.11

chore: Release package glam version 0.33.10

chore: Release package glam version 0.33.9

chore: Release package glam version 0.33.8

chore: Release package glam version 0.33.7

chore: Release package glam version 0.33.6

chore: Release package glam version 0.33.5

chore: Release package glam version 0.33.4

Added

• Added Vec3::angle_to which returns the signed angle (in radians) between two vectors around a given axis in the range [-π, +π]. The angle follows the right-hand rule around the axis and can be used with rotate_axis, e.g. self.rotate_axis(axis, self.angle_to(rhs, axis)) will be equal to rhs.

• Added Vec2::rotate_angle which rotates a vector by an angle (in radians), equivalent to self.rotate(Vec2::from_angle(angle)).

• Added glam_asserts that angle_to and angle_between inputs are non-zero vectors.

Changed

• to_array is now a const fn on all quaternion types.

Added

• Added the camera and dcamera modules containing view and projection constructor functions organized by handedness and graphics API convention.

  The view sub-module provides look_at_* and look_to_* functions that return Mat4, Affine3, Affine3A, Mat3, Mat3A, or Quat view transforms.

  The proj sub-module provides API-specific constructors for OpenGL, DirectX and Vulkan conventions, each offering perspective, perspective_infinite, perspective_infinite_reverse, orthographic, and frustum constructors for both left-handed and right-handed view spaces.

• Added a prelude module which re-exports all common types and traits but not camera modules.

• Added slerp_long method to quaternion types, a spherical linear interpolation that preserves the rotation direction.

• Added is_negative_mask method to all signed vector types which returns a boolean mask vector indicating which components have a negative sign.

Changed

• View and projection constructors (look_at_*, look_to_*, perspective_*, orthographic_*, frustum_*) have been moved off matrix, affine and quaternion types into the camera/dcamera modules as free functions. The existing methods on those types have been deprecated.

Changed

• Changed vector map method constraint from Fn to FnMut, allowing closures that mutate their captured state.

• Clarified documentation for any_orthogonal_pair method to specify it produces a right-handed basis.

Breaking changes

• All types apart from f32 and bool types are now optional but enabled by default. Unused types can be disabled to improve compile times.

• Added #[must_use] attribute to as_dmat2, as_dmat3 and as_dmat4 vector methods.

Fixed

• Fixed the implementation of dividing a scalar value by a matrix. This was actually dividing the matrix by the scalar value, with this fix 1.0/m == m.recip() is now true.

Added

• Added matrix recip() method which returns a new matrix containing the reciprocal of each element of the source matrix.

Breaking changes

• Updated the optional rand dependency to 0.10.

Added

• Added isize vector types ISizeVec2, ISizeVec3 and ISizeVec4.

• Added wasm64-unknown-unknown support. The wasm64-unknown-unknown target uses the same simd128 instructions as wasm32. Note that wasm64-unknown-unknown requires a nightly toolchain.

Changed

• The USES_WASM32_SIMD constant on vector types has been renamed to USES_WASM_SIMD, USES_WASM32_SIMD has been deprecated.

Breaking changes

• The signature of Quat::from_affine3(&Affine3A) was changed to Quat::from_affine3(&Affine3) with the addition of the Affine3 type.

• Removed deprecated Vec2 and DVec2 angle_between methods.

• Consistently use &self for matrix and affine type methods and self for vector, quat and mask types.

Added

• Added Affine3 type.

• Added diagonal method to matrix types which returns a vector containing the diagonal of the matrix.

• Added mul_diagonal_scale methods to matrix types which multiply the matrix by a scale vector without needing to multiply by a scale matrix.

• Added mul_transpose_vecn methods to matrix types which multiply the vector by the transpose of the matrix without needing to transpose it first. They can be slightly more efficient for SIMD backed types.

• Added try_inverse method to matrix types which returns an option containing the inverted matrix or None if the matrix was not invertible.

• Added inverse_or_zero method to matrix types which returns the inverted matrix or a zero matrix if the matrix was not invertible.

• Added step and saturate methods to the FloatExt trait.

• Added step, saturate, sqrt, sin, cos and sin_cos methods to float vector types.

• Added from_rotation_axes method to quaternion types. This method was previously internal only.

Added

• Added float vector exp2, ln and log2 methods.

• Added convenience methods for working with homogeneous coordinates, including 3D vector from_homogeneous and to_homogeneous and 4D vector project.

Fixed

• Fixed rand UniformSampler new_inclusive methods so they're actually inclusive.

Added

• Added 3D vector rotate_x, rotate_y, rotate_z and rotate_axis methods.

• Added arbitrary feature, providing arbitrary trait implementations for glam types.

• Added zerocopy feature, providing zerocopy trait implementations for glam types.

Changed

• Made the threshold used in DQuat::is_near_identity() more precise, previously it used the same threshold as Quat::is_near_identity.

Changed

• Updates from the rust-gpu project, primarily removing the requirement to use repr(simd) on spirv.

Changed

• Reverted change to use self in vectors and &self in vectors and matrices as this was a breaking change for some code.

Added

• Added encase feature, providing encase trait implementations for glam types.

Changed

• Consistently use self for vector and quat methods and &self for matrix and affine methods.

Added

• Added Vec3::to_vec3a and Vec3A::to_vec3 methods.

Fixed

• Fixed using bytemuck feature on spirv targets.

Added

• Added 4x4 matrix frustum_lh, frustum_rh and frustum_rh_gl methods.

• Added assign methods for all corresponding op trait impls (e.g. add_assign, div_assign, mul_assign, sub_assign etc.)

• Added by reference implementations for all op trait impls.

Changed

• bytemuck trait implementations now use derive macros to catch potentially misuse.

Fixed

• Fixed unsoundness in core-simd implementation of Vec3A to [f32;3] array and Vec3A to Vec3 conversion.

• Fixed potential unsoundness in conversion from Vec4 to (f32, f32, f32, f32) tuple conversion.

Added

• Added speedy feature, implementing serialization and deserialization via the speedy crate.

• Added fract_gl to the 'FloatExt' trait which uses the GLSL specification of fract, self - self.floor().

Added

• Added precision conversion functions for affine types: Affine3A::as_daffine3, DAffine3::as_affine3a, Affine2::as_daffine2 and DAffine3::as_affine2

• Added normalize_and_length method to f32 and f64 vectors.

Changed

• Vector min and max scalar implementations have been changed to use an if check instead of the built in Rust floating point primitive min and max methods. The Rust methods have special handling for NaN propagation however because this is not consistent between the different SIMD implementations in glam the most efficient implementation is preferred.

Added

• Added usize vector types, USizeVec2, USizeVec3 and USizeVec4.

• Added min_position and max_position methods for vector types, which return the index of the min or max element in the vector.

• Added rotate_towards method to 3D vector types.

Changed

• Removed the small angle check from 2D vector rotate_towards implementations as it was unnecessary and would not preserve the length of the input.

Breaking changes

• The up and dir vectors passed to affine and matrix look_to_lh and look_to_rh methods must now be normalized. This was changed to be consistent with other methods.

• Updated the optional rand dependency to 0.9

• Updated the optional rkyv dependency to 0.8

Added

• Implemented rand Uniform distribution trait for all vector types.

• Added "swizzle assignment" support to vector swizzles, in the form of v.with_zx(ivec2(1, 2)) which will return a copy of v where the z and x components are set to 1 and 2 respectively.

• Added Mat3 and Quat look_at_lh and look_at_rh methods.

• Added Quat look_to_lh and look_to_rh methods.

• Added 3D vector slerp method that performs a spherical linear interpolation between a source and a target 3D vector.

• Added manhattan_distance, checked_manhattan_distance and chebyshev_distance methods to integer vector types which calculates the Manhattan Distance and the Chebyshev Distance between two vectors.

• Added 4x4 matrix from_mat3_translation method to have parity with the 3D affine type.

Fixed

• Quat::rotate_towards() now returns the target Quat if the angle is small. Previously self was returned which could skip the rotation entirely.

Fixed

• Fix regression in vector write_to_slice methods where the destination had to be the same size as the input, but it should support writing to a slice that is the same size or larger than the input.

Added

• Added i8 and u8 vector types, I8Vec2, I8Vec3, I8Vec4, U8Vec2, U8Vec3 and U8Vec4.

• Added Mat4::project_point3a(Vec3A) method transforming points by perspective projections.

Changed

• Removed normalized assertions from quaternion multiplies as sometimes this is valid.

• Include Debug and Display implementations on spirv targets.

• Optimized vector from_slice and write_to_slice methods.

• Improved serde error messages.

Breaking changes

• EulerRot has been reimplemented and now has support for 24 different rotation order enum values.

Fixed

• Reduced the dot threshold at which quaternion slerp uses lerp to improve accuracy.

Added

• Added 3x3 matrix from_mat4_minor() and 2x2 matrix from_mat3_minor() methods.

• Added bvec2, bvec3, bvec3a, bvec4 and bvec4a vector mask creation functions.

• Added all 24 possible intrinsic and extrinsic Euler angle rotation combinations to EulerRot enum.

• Added is_finite_mask method to vector types which returns a vector mask.

• Added reflect and refract methods to vector types.

• Added to_euler methods to matrix types which extracts Euler angles from a rotation matrix for a given EulerRot.

• Added generic map method to vector types which applies a functor to all vector elements.

• Vector arithmetic ops are now implemented on references.

Changed

• Vector and quaternion lerp now uses a precise lerp algorithm.

Breaking changes

• Removed derives from glam::deref types used by Deref on SIMD vector types. These unintentionally added support for traits like PartialOrd to SIMD vector types. This may break existing code that was depending on this. Please use cmple().all() etc. instead of PartialOrd methods.

• Removed impl From<Vec4> for Vec3A as this violated the From trait contract that conversions should be lossless. Please use the explicit Vec3A::from_vec4 method instead.

• Renamed 2D vector angle_between to angle_to to differentiate from the 3D angle_between which has different semantics to the 2D version.

Added

• Added aarch64 neon support.

• Added rotate_towards methods for 2D vectors and quaternions.

• Added Vec3A::from_vec4 method which can perform a no-op conversion when SIMD is used. This replaces the impl From<Vec4> for Vec3A implementation.

Breaking changes

• Changed implementation of vector fract method to match the Rust implementation instead of the GLSL implementation, that is self - self.trunc() instead of self - self.floor().

Added

• Added vector fract_gl which uses the GLSL specification of fract, self - self.floor().

Breaking changes

• Minimum Supported Rust Version bumped to 1.68.2 for impl From<bool> for {f32,f64} support.

Fixed

• Respect precision format specifier in Display implementations. Previously it was ignored.

• Corrected precision documentation for vector is_normalized methods and changed the internal check to use 2e-4 to better match the documented precision value of 1e-4.

Added

• Added with_x, with_y, etc. to vector types which returns a copy of the vector with the new component value.

• Added midpoint method to vector types that returns the point between two points.

• Added move_towards for float vector types.

• Added saturating add and sub methods for signed and unsigned integer vector types.

• Added element wise sum and product methods for vector types.

• Added element wise absolute values method for matrix types.

• Added from_array method for boolean vector types.

• Added normalize_or method to vector types that returns the specified value if normalization failed.

• Added From<BVecN> support for all vector types.

• Added Div and DivAssign by scalar implementations to matrix types.

Breaking changes

• Changed Vec4 to always used BVec4A as a mask type, regardless if the target architecture has SIMD support in glam. Previously this was inconsistent on different hardware like ARM. This will have a slight performance cost when SIMD is not available. Vec4 will continue to use BVec4 as a mask type when the scalar-math feature is used.

Fixed

• Made Affine2 implement the bytemuck::AnyBitPattern trait instead of bytemuck::Pod as it contains internal padding due to Mat2 being 16 byte aligned.

• Updated the core-simd implementation to build on latest nightly.

Added

• Added to_angle method to 2D vectors.

• Added FloatExt trait which adds lerp, inverse_lerp and remap methods to f32 and f64 types.

• Added i16 and u16 vector types, I16Vec2, I16Vec3, I16Vec4, U16Vec2, U16Vec3 and U16Vec4.

Changed

• Renamed Quat::as_f64() to Quat::as_dquat() and DQuat::as_f32() to DQuat::as_quat() to be consistent with other types. The old methods have been deprecated.

• Added the #[must_use] attribute to all pure functions following the guidelines for the Rust standard library.

Fixed

• Fixed singularities in Quat::to_euler.

Added

• Added div_euclid and rem_euclid to integer vector types.

• Added wrapping and saturating arithmetic operations to integer vector types.

• Added to_scale_angle_translation to 2D affine types.

• Added mul_assign ops to affine types.

Changed

• Disable default features on optional rkyv dependency.

Added

• Implemented missing bytemuck, mint, rand, rkyv and serde traits for i64 and u64 types.

• Added missing safe From conversions from f32 vectors to f64 vectors.

• Added TryFrom implementations between different vector types.

• Added test and set methods to bool vector types for testing and setting individual mask elements.

• Added MIN, MAX, INFINITY and NEG_INFINITY vector constants.

Breaking changes

• Enabling libm in a std build now overrides the std math functions. This is unlikely to break anything but it is a change in behavior.

Added

• Added i64 and u64 vector types; I64Vec2, I64Vec3, I64Vec4, U64Vec2, U64Vec3 and U64Vec4.

• Added length_squared method on signed and unsigned integer vector types.

• Added distance_squared method on signed integer vector types.

• Implemented the bytemuck AnyBitPattern trait on Vec3A, Mat3A and Affine3A.

Changed

• Changed quaternion to_axis_angle for improved numerical stability.

Removed

• Removed dependency on serde_derive for improved compile times when using serde.

Breaking changes

• When the scalar-math feature is enabled the vector mask type for Vec3A was changed from BVec3 to BVec3A.

Added

• Added copysign method to signed vector types.

Breaking changes

• Added u32 implementation of BVec3A and BVec4 when SIMD is not available. These are used instead of aliasing to the bool implementations.

• Removed Add, Sub, and scalar Mul implementations from affine types as they didn't make sense on these types.

• Removed deprecated const_* macros. These have been replaced by const fn methods.

Fixed

• Fixed neg and signum to consistently handle negative zero across multiple platforms.

• Removed register_attr feature usage for SPIR-V targets.

Added

• Added missing Serialize, Deserialize and PartialEq implementations.

• Added Sum<Self> and Product<Self> implementations for all vector, matrix and quaternion types.

• Added 4x4 matrix methods look_to_lh and look_to_rh. These were previously private.

• Added dot_into_vec methods to vector which returns the result of the dot product splatted to all vector lanes.

• Added is_negative_bitmask to vector types which returns a u32 of bits for each negative vector lane.

• Added splat method and TRUE and FALSE constants to all BVec types.

• Added from_mat3a methods to Affine2, Mat2, Mat4 and Quat types.

Changed

• Disable serde default features.

• Made to_cols_array, to_cols_array_2d, and from_diagonal methods const fn.

Fixed

• Fixed glam_assert being too restrictive in matrix transform point and transform vector methods.

Added

• Added experimental core-simd feature which enables SIMD support via the unstable core::simd module.

Changed

• Derive from PartialEq and Eq instead of providing a trait implementation for all non SIMD types.

Fixed

• Restore missing $crate:: prefix in deprecated const_* macros.

• Fixed some performance regressions in affine and matrix determinant and inverses due to lack of inlining.

• Fixed some performance regressions in the SSE2 Vec3A to Vec3 from conversion.

Added

• Implemented BitXor and BitXorAssign traits for bool vectors.

Fixed

• Fix compilation when FMA support is enabled.

Breaking changes

• Minimum Supported Version of Rust bumped to 1.58.1 to allow const pointer dereferences in constant evaluation.

• The abs_diff_eq method on Mat2 and DMat2 now takes other by value instead of reference. This is consistent with the other matrix types.

• The AsMut and Deref trait implementations on Quat and DQuat was removed. Quaternion fields are now public.

• The AsRef trait implementations were removed from BVec2, BVec3, BVec3A, BVec4 and BVec4A.

Added

• NEG_ONE constant was added to all signed vector types.

• NEG_X, NEG_Y, NEG_Z and NEG_W negative axis vectors were added to signed vector types.

• The rotate and from_angle methods were added to Vec2 and DVec2. from_angle returns a 2D vector containing [angle.cos(), angle.sin()] that can be used to rotate another 2D vector.

• The from_array const function was added to all vector types.

Changed

• Source code is now largely generated. This removes most usage of macros internally to improve readability. There should be no change in API or behavior other than what is documented here.

• Many methods have been made const fn:

  • new, splat, from_slice, to_array and extend on vector types
  • from_cols, from_cols_array, from_cols_array_2d, from_cols_slice on matrix types
  • from_xyzw and from_array on quaternion types
  • from_cols on affine types

• The const new macros where deprecated.

Removed

• Deleted deprecated TransformRT and TransformSRT types.

Fixed

• Fixed a bug in the scalar implementation of 4D vector max_element method where the w element check was incorrect.

Fixed

• Fixed a bug with quaternion slerp with a rotation of tau.

Added

• Added to_array() to Quat and DQuat.
• Added mul_add method to all vector types - note that this will be slower without hardware support enabled.
• Added the fast-math flag which will sacrifice some float determinism for speed.

Fixed

• Fixed a bug in the sse2 and wasm32 implementations of Mat4::determinant().

Fixed

• Fixed SPIR-V build which was broken due to a typo.

Added

• Added the from_rotation_arc_2d() method to Quat and DQuat which will return a rotation between two 2D vectors around the z axis.
• Added impl of Neg operator for matrix types.
• Added cuda feature which forces glam types to match cuda's alignment requirements.

Changed

• The Quat and DQuat methods from_rotation_arc() and from_rotation_arc_colinear() are now available in no_std.
• The Vec3 and DVec3 methods any_orthogonal_vector(), any_orthonormal_vector() and any_orthonormal_pair() are now available in no_std.
• Added repr(C) attribute to affine types.

Removed

• Removed deprecated as_f32(), as_f64(), as_i32() and as_u32() methods.

Breaking changes

• Minimum Supported Version of Rust bumped to 1.52.1 for an update to the mint crate.

Added

• Added implementations for new IntoMint trait from the mint crate.
• Added mint conversions for Mat3A.
• Added as_vec3a cast methods to vector types.

Breaking changes

• Removed truncating vector From implementations. Use .truncate() or swizzle methods instead.

Added

• Added Not, Shl, Shr, BitAnd, BitOr and BitXor implementations for all IVec and UVec vector types.
• Added NAN constant for all types.
• Documented glam's architecture.

Changed

• Sum and Product traits are now implemented in no_std builds.

Breaking changes

• Minimum Supported Version of Rust bumped to 1.51.0 for wasm-bindgen-test and rustdoc alias support.

Added

• Added wasm32 SIMD intrinsics support.
• Added optional support for the rkyv serialization crate.
• Added Rem and RemAssign implementations for all vector types.
• Added quaternion xyz() method for returning the vector part of the quaternion.
• Added From((Scalar, Vector3)) for 4D vector types.

Changed

• Deprecated as_f32(), as_f64(), as_i32() and as_u32() methods in favor of more specific methods such as as_vec2(), as_dvec2(), as_ivec2() and as_uvec2() and so on.

Fixed

• Fix alignment unit tests on non x86 platforms.

Fixed

• Fix alignment unit tests on i686 and S390x.

Added

• Added serde support for Affine2, DAffine2, Affine3A and DAffine3.

Breaking changes

• The addition of Add and Sub implementations of scalar values for vector types may create ambiguities with existing calls to add and sub.
• Removed From<Mat3> implementation for Mat2 and From<DMat3> for DMat2. These have been replaced by Mat2::from_mat3() and DMat2::from_mat3().
• Removed From<Mat4> implementation for Mat3 and From<DMat4> for DMat3. These have been replaced by Mat3::from_mat4() and DMat3::from_mat4().
• Removed deprecated from_slice_unaligned(), write_to_slice_unaligned(), from_rotation_mat4 and from_rotation_ypr() methods.

Added

• Added col_mut() method which returns a mutable reference to a matrix column to all matrix types.
• Added AddAssign, MulAssign and SubAssign implementations for all matrix types.
• Added Add and Sub implementations of scalar values for vector types.
• Added more glam_assert! checks and documented methods where they are used.
• Added vector projection and rejection methods project_onto(), project_onto_normalized(), reject_from() and reject_from_normalized().
• Added Mat2::from_mat3(), DMat2::from_mat3(), Mat3::from_mat4(), DMat3::from_mat4() which create a smaller matrix from a larger one, discarding a final row and column of the input matrix.
• Added Mat3::from_mat2(), DMat3::from_mat2(), Mat4::from_mat3() and DMat4::from_mat3() which create an affine transform from a smaller linear transform matrix.

Changed

• Don't support AsRef and AsMut on SPIR-V targets. Also removed SPIR-V support for some methods that used as_ref(), including hash(). Not a breaking change as these methods would not have worked anyway.

Fixed

• Fixed compile time alignment checks failing on i686 targets.

Breaking changes

• sprirv-std dependency was removed, rust-gpu depends on glam internally again for now.
• Added must_use attribute to all inverse(), normalize(), try_normalize(), transpose() and conjugate() methods.

Added

• Added fract() method to float vector types which return a vector containing self - self.floor().
• Added optional support for the approx crate. Note that all glam types implement their own abs_diff_eq() method without requiring the approx dependency.