Crate hexga_math

Expand description

§A Math library that contains

This crate define N dimensional math stuff (2d, 3d, 4d, … nd) like vector/point of any type (float, int, uint, or even user defined) :

The same common functions such as min, max, mix, abs, and clamp work for

primitive values(u32, i32, f32, bool, …)
and on composite types (Array, Vector, Color, Rectangle, Matrix, Grid, …) that implement the Map / MapWith / MapIntern / MapInternWith traits.

Any external type implementing these traits automatically gains support for these common functions.

The crate also provide generic traits for casting with the same behavior as the as keyword :

Similar traits for casting remapping the range of an primitive to another primitive range also exist :

There are some quick typedef in the prelude :

int, uint and float : The default primitive precision used in the typedef. (can be change with the feature flags)
Point2, Point3, Point4 for Vector of int,
Vec2, Vec3, Vec4 for Vector of float,
Rect2, Rect3, Rect4 for Rectangle of float,
Rect2i, Rect3i, Rect4i for Rectangle of int (P for point),
Mat2, Mat3, Mat4 for Matrix of float, and Mat2i, Mat3i, Mat4i use int,
Grid2, Grid3, Grid3 can only be indexed by Point by default.

If you need more control about the precision, each type have another more generic base type :

Grid type uses a Point for the indexing precision, but that can be changed by using with the [hexga_math::grid::GridBase] type.
Angle and Time use a float precision that can be changed using AngleOf and TimeOf