When the Cargo package manager gets the online package list component, the package name will be used as the identifier for the whole project. Keeping "-rs" -- while useful for the github repository -- will be redundant in Cargo because all of the projects will obviously be rust projects. This naming convention was adopted by one of your other repository gl-rx (https://github.com/bjz/gl-rs/pull/88) |
||
---|---|---|
src | ||
.gitignore | ||
.travis.yml | ||
AUTHORS | ||
cargo-lite.conf | ||
Cargo.toml | ||
LICENSE | ||
Makefile | ||
README.md |
cgmath-rs
A linear algebra and mathematics library for computer graphics.
The library provides:
- vectors:
Vec2
,Vec3
,Vec4
- square matrices:
Mat2
,Mat3
,Mat4
- a quaternion type:
Quat
- rotation matrices:
Rot2
,Rot3
- angle units:
Rad
,Deg
- points:
Point2
,Point3
- rays:
Ray2
,Ray3
- a plane type:
Plane
- perspective projections:
Perspective
,PerspectiveFov
,Ortho
- a view frustum:
Frustrum
- spatial transformations:
AffineMatrix3
,Transform3D
- axis-aligned bounding boxes:
Aabb2
,Aabb3
- oriented bounding boxes:
Obb2
,Obb3
- collision primitives:
Sphere
,Cylinder
Not all of the functionality has been implemented yet, and the existing code is not fully covered by the testsuite. If you encounter any mistakes or omissions please let me know by posting an issue, or even better: send me a pull request with a fix.
Limitations
cgmath is not an n-dimensional library and is aimed at computer graphics applications rather than general linear algebra. It only offers the 2, 3, and 4 dimensional structures that are more than useful for most computer graphics applications. This design decision was made in order to simplify the implementation (Rust cannot paramerise over constants at compile time), and to make dimension-specific optimisations easier in the future.
Contributing
Pull requests are most welcome, especially in the realm of performance enhancements and fixing any mistakes I may have made along the way. Unit tests and benchmarks are also required, so help on that front would be most appreciated.
Support
Contact bjz
on irc.mozilla.org #rust
and #rust-gamedev,
or post an issue on Github.