Link listed types in lib.rs to their docs

Helpful because lib.rs is the 'main page' for docs.rs
This allows for easy/direct access to the mentioned types
Currently you need to look up mentioned types via the search bar
This commit is contained in:
Patiga 2022-08-19 13:34:21 +02:00
parent d09d06858f
commit 3aca9af616
1 changed files with 25 additions and 19 deletions

View File

@ -46,28 +46,34 @@ fn main() {
**nalgebra** is meant to be a general-purpose, low-dimensional, linear algebra library, with **nalgebra** is meant to be a general-purpose, low-dimensional, linear algebra library, with
an optimized set of tools for computer graphics and physics. Those features include: an optimized set of tools for computer graphics and physics. Those features include:
* A single parametrizable type `Matrix` for vectors, (square or rectangular) matrices, and slices * A single parametrizable type [`Matrix`](Matrix) for vectors, (square or rectangular) matrices, and
with dimensions known either at compile-time (using type-level integers) or at runtime. slices with dimensions known either at compile-time (using type-level integers) or at runtime.
* Matrices and vectors with compile-time sizes are statically allocated while dynamic ones are * Matrices and vectors with compile-time sizes are statically allocated while dynamic ones are
allocated on the heap. allocated on the heap.
* Convenient aliases for low-dimensional matrices and vectors: `Vector1` to `Vector6` and * Convenient aliases for low-dimensional matrices and vectors: [`Vector1`](Vector1) to
`Matrix1x1` to `Matrix6x6`, including rectangular matrices like `Matrix2x5`. [`Vector6`](Vector6) and [`Matrix1x1`](Matrix1) to [`Matrix6x6`](Matrix6), including rectangular
* Points sizes known at compile time, and convenience aliases: `Point1` to `Point6`. matrices like [`Matrix2x5`](Matrix2x5).
* Translation (seen as a transformation that composes by multiplication): `Translation2`, * Points sizes known at compile time, and convenience aliases: [`Point1`](Point1) to
`Translation3`. [`Point6`](Point6).
* Rotation matrices: `Rotation2`, `Rotation3`. * Translation (seen as a transformation that composes by multiplication):
* Quaternions: `Quaternion`, `UnitQuaternion` (for 3D rotation). [`Translation2`](Translation2), [`Translation3`](Translation3).
* Unit complex numbers can be used for 2D rotation: `UnitComplex`. * Rotation matrices: [`Rotation2`](Rotation2), [`Rotation3`](Rotation3).
* Algebraic entities with a norm equal to one: `Unit<T>`, e.g., `Unit<Vector3<f32>>`. * Quaternions: [`Quaternion`](Quaternion), [`UnitQuaternion`](UnitQuaternion) (for 3D rotation).
* Isometries (translation rotation): `Isometry2`, `Isometry3` * Unit complex numbers can be used for 2D rotation: [`UnitComplex`](UnitComplex).
* Similarity transformations (translation rotation uniform scale): `Similarity2`, `Similarity3`. * Algebraic entities with a norm equal to one: [`Unit<T>`](Unit), e.g., `Unit<Vector3<f32>>`.
* Affine transformations stored as a homogeneous matrix: `Affine2`, `Affine3`. * Isometries (translation rotation): [`Isometry2`](Isometry2), [`Isometry3`](Isometry3)
* Projective (i.e. invertible) transformations stored as a homogeneous matrix: `Projective2`, * Similarity transformations (translation rotation uniform scale):
`Projective3`. [`Similarity2`](Similarity2), [`Similarity3`](Similarity3).
* Affine transformations stored as a homogeneous matrix:
[`Affine2`](Affine2), [`Affine3`](Affine3).
* Projective (i.e. invertible) transformations stored as a homogeneous matrix:
[`Projective2`](Projective2), [`Projective3`](Projective3).
* General transformations that does not have to be invertible, stored as a homogeneous matrix: * General transformations that does not have to be invertible, stored as a homogeneous matrix:
`Transform2`, `Transform3`. [`Transform2`](Transform2), [`Transform3`](Transform3).
* 3D projections for computer graphics: `Perspective3`, `Orthographic3`. * 3D projections for computer graphics: [`Perspective3`](Perspective3),
* Matrix factorizations: `Cholesky`, `QR`, `LU`, `FullPivLU`, `SVD`, `Schur`, `Hessenberg`, `SymmetricEigen`. [`Orthographic3`](Orthographic3).
* Matrix factorizations: [`Cholesky`](Cholesky), [`QR`](QR), [`LU`](LU), [`FullPivLU`](FullPivLU),
[`SVD`](SVD), [`Schur`](Schur), [`Hessenberg`](Hessenberg), [`SymmetricEigen`](SymmetricEigen).
* Insertion and removal of rows of columns of a matrix. * Insertion and removal of rows of columns of a matrix.
*/ */