Crate glm [−] [src]
GLSL mathematics for Rust programming language.
glm-rs is yet another Rust math library for graphics applications. Inspired by the great GLM library for C++, the goal is to provide familiar math API to porgrammers who knows GLSL as well.
Differences to GLSL specification
Like GLM, following GLSL conventions is a strict policy of glm-rs too. glm crate implements all GLSL data types, operators and built-in functions. However, Rust is not a C-like language, and the syntax/semantics distances from Rust to GLSL is way longer than from C++ to GLSL. This is the major reason of following feature and syntax differences to GLSL specification,
- Precision qualifiers is not supported,
- Half float type is not available, yet,
There is no vector swizzle operators. For example, you can't do this,
let mut my_vec2 = my_vec4.wz; // and, my_vec2.yx = my_vec4.xx;
Part of swizzle operators can be done but must be in a very tedious way at the moment. The plan is to implemente accessing swizzle operators after Rust macro supports concatenating identifiers.
Because Rust does not support function name overloading, loads of convenient constructor functions can't be implemented. For example, you can't do this,
let v2 = vec2(1., 2.); // compile error: this function takes 3 parameters but 2 parameters were supplied [E0061] let v3 = vec3(v2, 3.);
This will be fixed in future version by introducing functions like
no_run fn vec21(x: Vec2, y: f32) -> Vec3
, in which function names indicate the forms of result vectors. - Also because of lacking of function name overloading, following built-in functions are added,atan2
,mod_s
,max_s
,min_s
,clamp_s
,mix_s
,mix_bool
,step_s
, andsmoothstep_s
.The suffix
_s
stands for scalar, which means this is a variant of original function that some parameters are specific to be scalar, instead a generic type.See documentation of these functions for detail. - Most explicit conversion functions, like
vec2
,dmat4x3
etc., do not work, for the same reason as above. This is rather inconvenient, and the plan is introducing functions liketo_vec2
,to_dmat4x3
in future version. - No implicit conversion. - Explicit type conversion functionbool
is renamed toboolean
. - Many explicit type conversion functions for vector types are introduced. In GLSL spec, these fucntions have the same name as vector type constructors, which is not allowed in Rust. The naming rule is to get a vector type conversion fucntion, adds ato_
before the constructor function. For example,let v = to_vec2(1_f32); assert_eq!(v, vec2(1., 1.));
- Lots of convertion functions are still missing (e.g., from matrices to vectors). These functions are syntax sugar actually, and will be fixed along with the constructor issue in future version.
GLSL uses out parameter for returning multiple results of functions. In Rust, we can do this by returning a tuple. Following functions' signatures are changed because of this,
modf
,frexp
,uaddCarry
,usubBorrow
,umulExtended
,imulExtended
The rule of changing is the out parameter is the second member of the return tuple. - Function parameters of matrix related functions (e.g.,
inverse
,cross
) are passed by reference, instead of by value as in the GLSL spec. For example,let m = mat2(1., 2., 3., 4.); // instead of `inverse(m)`, let inv = inverse(&m);
- Built-in function
mod
is renamed tofmod
, because mod is a Rust keyword.
Reexports
pub use builtin::*; |
Modules
builtin |
Built-in funcions defined in GLSL specification chapter 8. |
ext |
Functions that extend the functionalities of GLSL data types. |
Macros
assert_approx_eq | |
assert_close_to |
Structs
Matrix2 | |
Matrix3 | |
Matrix4 | |
Matrix2x3 | |
Matrix2x4 | |
Matrix3x2 | |
Matrix3x4 | |
Matrix4x2 | |
Matrix4x3 | |
Vector2 | |
Vector3 | |
Vector4 |
Traits
ApproxEq |
Trait for comparing types that are derived from float numbers. |
BaseFloat |
Trait for primitive float number type. |
BaseInt |
Marker trait for primitive integer number type. |
BaseNum |
Trait for primitive number type. |
GenBVec |
Generic boolean vector type. |
GenFloat |
Generic float number type. |
GenFloatVec |
Generic type of vectors of float number. |
GenInt |
Generic interger type. |
GenMat |
Generic Matrix type. |
GenNum |
Generic numeric type. |
GenNumVec |
Trait of all vector types that are GenNum. |
GenSquareMat |
Generic type of square matrix. |
GenVec |
Generic vector type. |
PrimCast |
This trait provides parameterized function |
Primitive |
Marker trait for primitive types. |
SignedNum |
Trait for numerical types that have negative values. |
Functions
boolean | |
bvec2 | |
bvec3 | |
bvec4 | |
dmat2 | |
dmat3 | |
dmat4 | |
dmat2x3 | |
dmat2x4 | |
dmat3x2 | |
dmat3x4 | |
dmat4x2 | |
dmat4x3 | |
double | |
dvec2 | |
dvec3 | |
dvec4 | |
float | |
int | |
is_approx_eq |
Returns the result of |
is_close_to |
Returns the result of |
ivec2 | |
ivec3 | |
ivec4 | |
mat2 | |
mat3 | |
mat4 | |
mat2x3 | |
mat2x4 | |
mat3x2 | |
mat3x4 | |
mat4x2 | |
mat4x3 | |
to_bvec2 | |
to_bvec3 | |
to_bvec4 | |
to_dvec2 | |
to_dvec3 | |
to_dvec4 | |
to_ivec2 | |
to_ivec3 | |
to_ivec4 | |
to_uvec2 | |
to_uvec3 | |
to_uvec4 | |
to_vec2 | |
to_vec3 | |
to_vec4 | |
uint | |
uvec2 | |
uvec3 | |
uvec4 | |
vec2 | |
vec3 | |
vec4 |