Data Structures | Macros | Typedefs | Functions
3x3 Matrices in floating point

Matrix definition and operations. More...

Data Structures

struct  _Eina_Matrix3
 Floating point matrix3 handler. More...
 

Macros

#define EINA_MATRIX3_FORMAT   "g %g %g | %g %g %g | %g %g %g"
 Helper macro for printf formatting.
 
#define EINA_MATRIX3_ARGS(m)
 Helper macro for printf formatting arg. More...
 

Typedefs

typedef struct _Eina_Matrix3 Eina_Matrix3
 Floating point matrix3 handler.
 

Functions

EAPI Eina_Matrix_Type eina_matrix3_type_get (const Eina_Matrix3 *m)
 Returns the type of the given floating point matrix. More...
 
EAPI void eina_matrix3_values_set (Eina_Matrix3 *m, double xx, double xy, double xz, double yx, double yy, double yz, double zx, double zy, double zz)
 Sets the values of the coefficients of the given floating point matrix. More...
 
EAPI void eina_matrix3_values_get (const Eina_Matrix3 *m, double *xx, double *xy, double *xz, double *yx, double *yy, double *yz, double *zx, double *zy, double *zz)
 Gets the values of the coefficients of the given floating point matrix. More...
 
EAPI void eina_matrix3_fixed_values_get (const Eina_Matrix3 *m, Eina_F16p16 *xx, Eina_F16p16 *xy, Eina_F16p16 *xz, Eina_F16p16 *yx, Eina_F16p16 *yy, Eina_F16p16 *yz, Eina_F16p16 *zx, Eina_F16p16 *zy, Eina_F16p16 *zz)
 Gets the values of the coefficients of the given fixed point matrix. More...
 
EAPI void eina_matrix3_matrix3_f16p16_to (const Eina_Matrix3 *m, Eina_Matrix3_F16p16 *fm)
 Transforms the given floating point matrix to the given fixed point matrix. More...
 
EAPI Eina_Bool eina_matrix3_equal (const Eina_Matrix3 *m1, const Eina_Matrix3 *m2)
 Checks whether the two given matrices are equal or not. More...
 
EAPI void eina_matrix3_compose (const Eina_Matrix3 *m1, const Eina_Matrix3 *m2, Eina_Matrix3 *dst)
 
EAPI void eina_matrix3_translate (Eina_Matrix3 *t, double tx, double ty)
 Sets the matrix values for a translation. More...
 
EAPI void eina_matrix3_scale (Eina_Matrix3 *t, double sx, double sy)
 Sets the matrix values for a scale. More...
 
EAPI void eina_matrix3_rotate (Eina_Matrix3 *t, double rad)
 Sets the matrix values for a rotation. More...
 
EAPI void eina_matrix3_identity (Eina_Matrix3 *t)
 Sets the given floating point matrix to the identity matrix. More...
 
EAPI double eina_matrix3_determinant (const Eina_Matrix3 *m)
 Returns the determinant of the given matrix. More...
 
EAPI void eina_matrix3_divide (Eina_Matrix3 *m, double scalar)
 Divides the given matrix by the given scalar. More...
 
EAPI void eina_matrix3_inverse (const Eina_Matrix3 *m, Eina_Matrix3 *m2)
 Computes the inverse of the given matrix. More...
 
EAPI void eina_matrix3_transpose (const Eina_Matrix3 *m, Eina_Matrix3 *a)
 
EAPI void eina_matrix3_cofactor (const Eina_Matrix3 *m, Eina_Matrix3 *a)
 
EAPI void eina_matrix3_adjoint (const Eina_Matrix3 *m, Eina_Matrix3 *a)
 
EAPI void eina_matrix3_point_transform (const Eina_Matrix3 *m, double x, double y, double *xr, double *yr)
 
EAPI void eina_matrix3_rectangle_transform (const Eina_Matrix3 *m, const Eina_Rectangle *r, const Eina_Quad *q)
 
EAPI Eina_Bool eina_matrix3_quad_quad_map (Eina_Matrix3 *m, const Eina_Quad *src, const Eina_Quad *dst)
 Creates a projective matrix that maps a quadrangle to a quadrangle.
 
EAPI Eina_Bool eina_matrix3_square_quad_map (Eina_Matrix3 *m, const Eina_Quad *q)
 
EAPI Eina_Bool eina_matrix3_quad_square_map (Eina_Matrix3 *m, const Eina_Quad *q)
 
EAPI void eina_matrix3_array_set (Eina_Matrix3 *m, const double *v)
 Sets array to matrix. More...
 
EAPI void eina_matrix3_copy (Eina_Matrix3 *dst, const Eina_Matrix3 *src)
 Copies matrix. More...
 
EAPI void eina_matrix3_multiply (Eina_Matrix3 *out, const Eina_Matrix3 *mat_a, const Eina_Matrix3 *mat_b)
 Multiplies two matrix. More...
 
EAPI void eina_matrix3_multiply_copy (Eina_Matrix3 *out, const Eina_Matrix3 *mat_a, const Eina_Matrix3 *mat_b)
 Multiplies two matrix. More...
 
EAPI void eina_matrix3_scale_transform_set (Eina_Matrix3 *out, double s_x, double s_y)
 Transforms scale of matrix. More...
 
EAPI void eina_matrix3_position_transform_set (Eina_Matrix3 *out, const double p_x, const double p_y)
 Transforms position of matrix. More...
 
EAPI void eina_normal3_matrix_get (Eina_Matrix3 *out, const Eina_Matrix4 *m)
 Sets normal of the given matrix. More...
 
EAPI void eina_matrix3_matrix4_to (Eina_Matrix4 *m4, const Eina_Matrix3 *m3)
 Converts an Eina_Matrix3 into an Eina_Matrix4. More...
 

Detailed Description

Matrix definition and operations.

Macro Definition Documentation

◆ EINA_MATRIX3_ARGS

#define EINA_MATRIX3_ARGS (   m)
Value:
(m)->xx, (m)->xy, (m)->xz, \
(m)->yx, (m)->yy, (m)->yz, \
(m)->zx, (m)->zy, (m)->zz

Helper macro for printf formatting arg.

Function Documentation

◆ eina_matrix3_type_get()

EAPI Eina_Matrix_Type eina_matrix3_type_get ( const Eina_Matrix3 m)

Returns the type of the given floating point matrix.

Parameters
mThe floating point matrix.
Returns
The type of the matrix.

This function returns the type of the matrix m. No check is done on m.

Since
1.14

References EINA_DBL_EQ, EINA_MATRIX_TYPE_AFFINE, EINA_MATRIX_TYPE_IDENTITY, and EINA_MATRIX_TYPE_PROJECTIVE.

Referenced by eina_matrix3_multiply().

◆ eina_matrix3_values_set()

EAPI void eina_matrix3_values_set ( Eina_Matrix3 m,
double  xx,
double  xy,
double  xz,
double  yx,
double  yy,
double  yz,
double  zx,
double  zy,
double  zz 
)

Sets the values of the coefficients of the given floating point matrix.

Parameters
mThe floating point matrix.
xxThe first coefficient value.
xyThe second coefficient value.
xzThe third coefficient value.
yxThe fourth coefficient value.
yyThe fifth coefficient value.
yzThe sixth coefficient value.
zxThe seventh coefficient value.
zyThe heighth coefficient value.
zzThe nineth coefficient value.

This function sets the values of the coefficients of the matrix m. No check is done on m.

See also
eina_matrix3_values_get()
Since
1.14

◆ eina_matrix3_values_get()

EAPI void eina_matrix3_values_get ( const Eina_Matrix3 m,
double *  xx,
double *  xy,
double *  xz,
double *  yx,
double *  yy,
double *  yz,
double *  zx,
double *  zy,
double *  zz 
)

Gets the values of the coefficients of the given floating point matrix.

Parameters
mThe floating point matrix.
xxThe first coefficient value.
xyThe second coefficient value.
xzThe third coefficient value.
yxThe fourth coefficient value.
yyThe fifth coefficient value.
yzThe sixth coefficient value.
zxThe seventh coefficient value.
zyThe heighth coefficient value.
zzThe nineth coefficient value.

This function gets the values of the coefficients of the matrix m. No check is done on m.

See also
eina_matrix3_values_set()
Since
1.14

◆ eina_matrix3_fixed_values_get()

EAPI void eina_matrix3_fixed_values_get ( const Eina_Matrix3 m,
Eina_F16p16 xx,
Eina_F16p16 xy,
Eina_F16p16 xz,
Eina_F16p16 yx,
Eina_F16p16 yy,
Eina_F16p16 yz,
Eina_F16p16 zx,
Eina_F16p16 zy,
Eina_F16p16 zz 
)

Gets the values of the coefficients of the given fixed point matrix.

Parameters
mThe fixed point matrix.
xxThe first coefficient value.
xyThe second coefficient value.
xzThe third coefficient value.
yxThe fourth coefficient value.
yyThe fifth coefficient value.
yzThe sixth coefficient value.
zxThe seventh coefficient value.
zyThe heighth coefficient value.
zzThe nineth coefficient value.

This function gets the values of the coefficients of the matrix m. No check is done on m.

See also
eina_matrix3_values_set()
Since
1.14

References eina_f16p16_double_from().

Referenced by eina_matrix3_matrix3_f16p16_to().

◆ eina_matrix3_matrix3_f16p16_to()

EAPI void eina_matrix3_matrix3_f16p16_to ( const Eina_Matrix3 m,
Eina_Matrix3_F16p16 fm 
)

Transforms the given floating point matrix to the given fixed point matrix.

Parameters
mThe floating point matrix.
fmThe fixed point matrix.

This function transforms the floating point matrix m to a fixed point matrix and store the coefficients into the fixed point matrix fm.

Since
1.14

References eina_matrix3_fixed_values_get().

◆ eina_matrix3_equal()

EAPI Eina_Bool eina_matrix3_equal ( const Eina_Matrix3 m1,
const Eina_Matrix3 m2 
)

Checks whether the two given matrices are equal or not.

Parameters
m1The first matrix.
m2The second matrix.
Returns
EINA_TRUE if the two matrices are equal, 0 otherwise.

This function return EINA_TRUE if thematrices m1 and m2 are equal, EINA_FALSE otherwise. No check is done on the matrices.

Since
1.14

References EINA_DBL_EQ, EINA_FALSE, EINA_TRUE, _Eina_Matrix3::xx, _Eina_Matrix3::xy, _Eina_Matrix3::xz, _Eina_Matrix3::yx, _Eina_Matrix3::yy, _Eina_Matrix3::yz, _Eina_Matrix3::zx, _Eina_Matrix3::zy, and _Eina_Matrix3::zz.

◆ eina_matrix3_compose()

EAPI void eina_matrix3_compose ( const Eina_Matrix3 m1,
const Eina_Matrix3 m2,
Eina_Matrix3 dst 
)

◆ eina_matrix3_translate()

EAPI void eina_matrix3_translate ( Eina_Matrix3 t,
double  tx,
double  ty 
)

Sets the matrix values for a translation.

Parameters
[in]mThe matrix to set the translation values
[in]txThe X coordinate translate
[in]tyThe Y coordinate translate
Since
1.14

References eina_matrix3_compose().

◆ eina_matrix3_scale()

EAPI void eina_matrix3_scale ( Eina_Matrix3 t,
double  sx,
double  sy 
)

Sets the matrix values for a scale.

Parameters
[in]mThe matrix to set the scale values
[in]sxThe X coordinate scale
[in]syThe Y coordinate scale
Since
1.14

References eina_matrix3_compose().

◆ eina_matrix3_rotate()

EAPI void eina_matrix3_rotate ( Eina_Matrix3 t,
double  rad 
)

Sets the matrix values for a rotation.

Parameters
[in]tThe matrix to set the rotation values
[in]radThe radius to rotate the matrix
Since
1.14

References eina_matrix3_compose().

◆ eina_matrix3_identity()

EAPI void eina_matrix3_identity ( Eina_Matrix3 t)

Sets the given floating point matrix to the identity matrix.

Parameters
mThe floating point matrix to set

This function sets m to the identity matrix. No check is done on m.

Since
1.14

Referenced by eina_matrix3_inverse(), eina_matrix3_position_transform_set(), and eina_matrix3_scale_transform_set().

◆ eina_matrix3_determinant()

EAPI double eina_matrix3_determinant ( const Eina_Matrix3 m)

Returns the determinant of the given matrix.

Parameters
mThe matrix.
Returns
The determinant.

This function returns the determinant of the matrix m. No check is done on m.

Since
1.14

Referenced by eina_matrix3_inverse().

◆ eina_matrix3_divide()

EAPI void eina_matrix3_divide ( Eina_Matrix3 m,
double  scalar 
)

Divides the given matrix by the given scalar.

Parameters
mThe matrix.
scalarThe scalar number.

This function divides the matrix m by scalar. No check is done on m.

Since
1.14

Referenced by eina_matrix3_inverse(), and eina_matrix3_quad_square_map().

◆ eina_matrix3_inverse()

EAPI void eina_matrix3_inverse ( const Eina_Matrix3 m,
Eina_Matrix3 m2 
)

Computes the inverse of the given matrix.

Parameters
mThe matrix to inverse.
m2The inverse matrix.

This function inverse the matrix m and stores the result in m2. No check is done on m or m2. If m can not be invertible, then m2 is set to the identity matrix.

Since
1.14

References EINA_DBL_EQ, eina_matrix3_adjoint(), eina_matrix3_determinant(), eina_matrix3_divide(), and eina_matrix3_identity().

Referenced by eina_matrix3_quad_square_map().

◆ eina_matrix3_transpose()

EAPI void eina_matrix3_transpose ( const Eina_Matrix3 m,
Eina_Matrix3 a 
)
Since
1.14

Referenced by eina_matrix3_adjoint().

◆ eina_matrix3_cofactor()

EAPI void eina_matrix3_cofactor ( const Eina_Matrix3 m,
Eina_Matrix3 a 
)
Since
1.14

Referenced by eina_matrix3_adjoint().

◆ eina_matrix3_adjoint()

EAPI void eina_matrix3_adjoint ( const Eina_Matrix3 m,
Eina_Matrix3 a 
)
Since
1.14

References eina_matrix3_cofactor(), and eina_matrix3_transpose().

Referenced by eina_matrix3_inverse().

◆ eina_matrix3_point_transform()

EAPI void eina_matrix3_point_transform ( const Eina_Matrix3 m,
double  x,
double  y,
double *  xr,
double *  yr 
)
Since
1.14

References EINA_DBL_EQ.

Referenced by eina_matrix3_rectangle_transform().

◆ eina_matrix3_rectangle_transform()

EAPI void eina_matrix3_rectangle_transform ( const Eina_Matrix3 m,
const Eina_Rectangle r,
const Eina_Quad q 
)

◆ eina_matrix3_square_quad_map()

EAPI Eina_Bool eina_matrix3_square_quad_map ( Eina_Matrix3 m,
const Eina_Quad q 
)

◆ eina_matrix3_quad_square_map()

EAPI Eina_Bool eina_matrix3_quad_square_map ( Eina_Matrix3 m,
const Eina_Quad q 
)

◆ eina_matrix3_array_set()

EAPI void eina_matrix3_array_set ( Eina_Matrix3 m,
const double *  v 
)

Sets array to matrix.

Parameters
mThe result matrix
vThe the array[9] for set

Set to matrix first 9 elements from array

Since
1.17

◆ eina_matrix3_copy()

EAPI void eina_matrix3_copy ( Eina_Matrix3 dst,
const Eina_Matrix3 src 
)

Copies matrix.

Parameters
dstThe matrix copy
srcThe matrix for copy.
Since
1.16

Referenced by eina_matrix3_multiply(), and eina_matrix3_multiply_copy().

◆ eina_matrix3_multiply()

EAPI void eina_matrix3_multiply ( Eina_Matrix3 out,
const Eina_Matrix3 mat_a,
const Eina_Matrix3 mat_b 
)

Multiplies two matrix.

Parameters
outThe resulting matrix
mat_aThe first member of the multiplication
mat_bThe second member of the multiplication
Since
1.17

References eina_matrix3_copy(), eina_matrix3_type_get(), and EINA_MATRIX_TYPE_IDENTITY.

Referenced by eina_matrix3_multiply_copy().

◆ eina_matrix3_multiply_copy()

EAPI void eina_matrix3_multiply_copy ( Eina_Matrix3 out,
const Eina_Matrix3 mat_a,
const Eina_Matrix3 mat_b 
)

Multiplies two matrix.

Parameters
outThe resulting matrix
mat_aThe first member of the multiplication
mat_bThe second member of the multiplication
Since
1.17

References eina_matrix3_copy(), and eina_matrix3_multiply().

◆ eina_matrix3_scale_transform_set()

EAPI void eina_matrix3_scale_transform_set ( Eina_Matrix3 out,
double  s_x,
double  s_y 
)

Transforms scale of matrix.

Parameters
outThe resulting matrix
s_xThe scale value for x
s_yThe scale value for y
Since
1.17

References eina_matrix3_identity().

◆ eina_matrix3_position_transform_set()

EAPI void eina_matrix3_position_transform_set ( Eina_Matrix3 out,
const double  p_x,
const double  p_y 
)

Transforms position of matrix.

Parameters
outThe resulting matrix
p_xThe position value for x
p_yThe position value for y
Since
1.17

References eina_matrix3_identity().

◆ eina_normal3_matrix_get()

EAPI void eina_normal3_matrix_get ( Eina_Matrix3 out,
const Eina_Matrix4 m 
)

Sets normal of the given matrix.

Parameters
outThe result mtrix of normal
mThe matrix
Since
1.17

◆ eina_matrix3_matrix4_to()

EAPI void eina_matrix3_matrix4_to ( Eina_Matrix4 m4,
const Eina_Matrix3 m3 
)

Converts an Eina_Matrix3 into an Eina_Matrix4.

Parameters
m3The destination Eina_Matrix3.
m4The source Eina_Matrix4.
Since
1.15