Vector-Traits Crate
vector-traits
is a Rust crate designed to provide a set of traits for abstracting over different vector
implementations and scalar types, offering a unified interface for a basic set of vector operations. This crate facilitates
seamless transitions between different vector libraries and scalar precisions (e.g., f32
and f64
) without
requiring significant code modifications.
Features
- Abstract over two-dimensional and three-dimensional vectors with
GenericVector2
andGenericVector3
traits. - Generic scalar trait
GenericScalar
for a flexible scalar type handling. - Basic vector traits
HasXY
andHasXYZ
for custom vector storage types, e.g., FFI types. - Seamless transition between different vector libraries like
cgmath
andglam
. - Ability to switch between different scalar types (
f32
,f64
) effortlessly.
Supported Vector Implementations
Currently, the following vector types from cgmath
and glam
libraries are supported:
glam::Vec2
,glam::DVec2
,glam::Vec3
,glam::Vec3A
andglam::DVec3
cgmath::Vector2
andcgmath::Vector3
(forf32
andf64
)
Usage
Add vector-traits
to your Cargo.toml
dependencies along with the desired features:
[]
= { = "0.3.4", = ["glam", "cgmath"] } # only use what you need
Documentation
For a deeper dive into vector-traits functionality, check the documentation generated by cargo doc or browse it online here.
Contributing
We welcome contributions from the community. Feel free to submit pull requests or report issues on our GitHub repository. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.