graphene_matrix_alloc ()

graphene_matrix_t *
graphene_matrix_alloc (void);

Allocates a new graphene_matrix_t.

[constructor]

Since: 1.0

graphene_matrix_free ()

void
graphene_matrix_free (graphene_matrix_t *m);

Frees the resources allocated by graphene_matrix_alloc().

Since: 1.0

graphene_matrix_init_identity ()

graphene_matrix_t *
graphene_matrix_init_identity (graphene_matrix_t *m);

Initializes a graphene_matrix_t with the identity matrix.

Since: 1.0

graphene_matrix_init_from_float ()

graphene_matrix_t *
graphene_matrix_init_from_float (graphene_matrix_t *m,
                                 const float *v);

Initializes a graphene_matrix_t with the given array of floating point values.

Since: 1.0

graphene_matrix_init_from_vec4 ()

graphene_matrix_t *
graphene_matrix_init_from_vec4 (graphene_matrix_t *m,
                                const graphene_vec4_t *v0,
                                const graphene_vec4_t *v1,
                                const graphene_vec4_t *v2,
                                const graphene_vec4_t *v3);

Initializes a graphene_matrix_t with the given four row vectors.

Since: 1.0

graphene_matrix_init_from_matrix ()

graphene_matrix_t *
graphene_matrix_init_from_matrix (graphene_matrix_t *m,
                                  const graphene_matrix_t *src);

Initializes a graphene_matrix_t using the values of the given matrix.

Since: 1.0

graphene_matrix_init_from_2d ()

graphene_matrix_t *
graphene_matrix_init_from_2d (graphene_matrix_t *m,
                              double xx,
                              double yx,
                              double xy,
                              double yy,
                              double x_0,
                              double y_0);

Initializes a graphene_matrix_t from the values of an affine transformation matrix.

The arguments map to the following matrix layout:

1
2
3

| xx yx |   |  a  b  0 |
| xy yy | = |  c  d  0 |
| x0 y0 |   | tx ty  1 |

This function can be used to convert between a matrix type from other libraries and a graphene_matrix_t.

Since: 1.0

graphene_matrix_init_perspective ()

graphene_matrix_t *
graphene_matrix_init_perspective (graphene_matrix_t *m,
                                  float fovy,
                                  float aspect,
                                  float z_near,
                                  float z_far);

Initializes a graphene_matrix_t with a perspective projection.

Since: 1.0

graphene_matrix_init_ortho ()

graphene_matrix_t *
graphene_matrix_init_ortho (graphene_matrix_t *m,
                            float left,
                            float right,
                            float top,
                            float bottom,
                            float z_near,
                            float z_far);

Initializes a graphene_matrix_t with an orthographic projection.

Since: 1.0

graphene_matrix_init_look_at ()

graphene_matrix_t *
graphene_matrix_init_look_at (graphene_matrix_t *m,
                              const graphene_vec3_t *eye,
                              const graphene_vec3_t *center,
                              const graphene_vec3_t *up);

Initializes a graphene_matrix_t so that it positions the "camera" at the given eye coordinates towards an object at the center coordinates. The top of the camera is aligned to the direction of the up vector.

Since: 1.0

graphene_matrix_init_frustum ()

graphene_matrix_t *
graphene_matrix_init_frustum (graphene_matrix_t *m,
                              float left,
                              float right,
                              float bottom,
                              float top,
                              float z_near,
                              float z_far);

Initializes a graphene_matrix_t compatible with graphene_frustum_t.

See also: graphene_frustum_init_from_matrix()

Since: 1.2

graphene_matrix_init_scale ()

graphene_matrix_t *
graphene_matrix_init_scale (graphene_matrix_t *m,
                            float x,
                            float y,
                            float z);

Initializes a graphene_matrix_t with the given scaling factors.

Since: 1.0

graphene_matrix_init_translate ()

graphene_matrix_t *
graphene_matrix_init_translate (graphene_matrix_t *m,
                                const graphene_point3d_t *p);

Initializes a graphene_matrix_t with a translation to the given coordinates.

Since: 1.0

graphene_matrix_init_rotate ()

graphene_matrix_t *
graphene_matrix_init_rotate (graphene_matrix_t *m,
                             float angle,
                             const graphene_vec3_t *axis);

Initializes m to represent a rotation of angle degrees on the axis represented by the axis vector.

Since: 1.0

graphene_matrix_init_skew ()

graphene_matrix_t *
graphene_matrix_init_skew (graphene_matrix_t *m,
                           float x_skew,
                           float y_skew);

Initializes a graphene_matrix_t with a skew transformation with the given factors.

Since: 1.0

graphene_matrix_is_identity ()

bool
graphene_matrix_is_identity (const graphene_matrix_t *m);

Checks whether the given graphene_matrix_t is the identity matrix.

Since: 1.0

graphene_matrix_is_2d ()

bool
graphene_matrix_is_2d (const graphene_matrix_t *m);

Checks whether the given graphene_matrix_t is compatible with an a 2D affine transformation matrix.

Since: 1.0

graphene_matrix_is_backface_visible ()

bool
graphene_matrix_is_backface_visible (const graphene_matrix_t *m);

Checks whether a graphene_matrix_t has a visible back face.

Since: 1.0

graphene_matrix_is_singular ()

bool
graphene_matrix_is_singular (const graphene_matrix_t *m);

Checks whether a matrix is singular.

Since: 1.0

graphene_matrix_to_float ()

void
graphene_matrix_to_float (const graphene_matrix_t *m,
                          float *v);

Converts a graphene_matrix_t to an array of floating point values.

Since: 1.0

graphene_matrix_to_2d ()

bool
graphene_matrix_to_2d (const graphene_matrix_t *m,
                       double *xx,
                       double *yx,
                       double *xy,
                       double *yy,
                       double *x_0,
                       double *y_0);

Converts a graphene_matrix_t to an affine transformation matrix, if the given matrix is compatible.

The returned values have the following layout:

1
2
3

| xx yx |   |  a  b  0 |
| xy yy | = |  c  d  0 |
| x0 y0 |   | tx ty  1 |

This function can be used to convert between a graphene_matrix_t and a matrix type from other libraries.

Since: 1.0

graphene_matrix_get_row ()

void
graphene_matrix_get_row (const graphene_matrix_t *m,
                         unsigned int index_,
                         graphene_vec4_t *res);

Retrieves the given row vector at index_ inside a matrix.

Since: 1.0

graphene_matrix_get_value ()

float
graphene_matrix_get_value (const graphene_matrix_t *m,
                           unsigned int row,
                           unsigned int col);

Retrieves the value at the given row and col index.

Since: 1.0

graphene_matrix_multiply ()

void
graphene_matrix_multiply (const graphene_matrix_t *a,
                          const graphene_matrix_t *b,
                          graphene_matrix_t *res);

Multiplies two graphene_matrix_t.

Remember: matrix multiplication is not commutative, except for the identity matrix; the product of this multiplication is (A * B).

Since: 1.0

graphene_matrix_determinant ()

float
graphene_matrix_determinant (const graphene_matrix_t *m);

Computes the determinant of the given matrix.

Since: 1.0

graphene_matrix_transform_vec4 ()

void
graphene_matrix_transform_vec4 (const graphene_matrix_t *m,
                                const graphene_vec4_t *v,
                                graphene_vec4_t *res);

Transforms the given graphene_vec4_t using the matrix m .

Since: 1.0

graphene_matrix_transform_vec3 ()

void
graphene_matrix_transform_vec3 (const graphene_matrix_t *m,
                                const graphene_vec3_t *v,
                                graphene_vec3_t *res);

Transforms the given graphene_vec3_t using the matrix m .

Since: 1.0

graphene_matrix_transform_point ()

void
graphene_matrix_transform_point (const graphene_matrix_t *m,
                                 const graphene_point_t *p,
                                 graphene_point_t *res);

Transforms the given graphene_point_t using the matrix m .

Since: 1.0

graphene_matrix_transform_point3d ()

void
graphene_matrix_transform_point3d (const graphene_matrix_t *m,
                                   const graphene_point3d_t *p,
                                   graphene_point3d_t *res);

Transforms the given graphene_point3d_t using the matrix m .

Unlike graphene_matrix_transform_vec3(), this function will take into account the fourth row vector of the graphene_matrix_t.

Since: 1.2

graphene_matrix_transform_rect ()

void
graphene_matrix_transform_rect (const graphene_matrix_t *m,
                                const graphene_rect_t *r,
                                graphene_quad_t *res);

Transforms a graphene_rect_t using the given matrix m . The result is a coplanar quad.

Since: 1.0

graphene_matrix_transform_bounds ()

void
graphene_matrix_transform_bounds (const graphene_matrix_t *m,
                                  const graphene_rect_t *r,
                                  graphene_rect_t *res);

Transforms a graphene_rect_t using the given matrix m . The result is the bounding box containing the coplanar quad.

Since: 1.0

graphene_matrix_transform_box ()

void
graphene_matrix_transform_box (const graphene_matrix_t *m,
                               const graphene_box_t *b,
                               graphene_box_t *res);

Transforms a graphene_box_t using the given matrix m . The result is the bounding box containing the transformed box.

Since: 1.2

graphene_matrix_transform_sphere ()

void
graphene_matrix_transform_sphere (const graphene_matrix_t *m,
                                  const graphene_sphere_t *s,
                                  graphene_sphere_t *res);

Transforms a graphene_sphere_t using the given matrix m . The result is the bounding sphere containing the transformed sphere.

Since: 1.2

graphene_matrix_transform_ray ()

void
graphene_matrix_transform_ray (const graphene_matrix_t *m,
                               const graphene_ray_t *r,
                               graphene_ray_t *res);

Transform a graphene_ray_t using the given matrix m .

Since: 1.4

graphene_matrix_project_point ()

void
graphene_matrix_project_point (const graphene_matrix_t *m,
                               const graphene_point_t *p,
                               graphene_point_t *res);

Projects a graphene_point_t using the matrix m .

Since: 1.0

graphene_matrix_project_rect_bounds ()

void
graphene_matrix_project_rect_bounds (const graphene_matrix_t *m,
                                     const graphene_rect_t *r,
                                     graphene_rect_t *res);

Projects a graphene_rect_t using the given matrix.

The resulting rectangle is the bounding box capable of containing fully the projected rectangle.

Since: 1.0

graphene_matrix_project_rect ()

void
graphene_matrix_project_rect (const graphene_matrix_t *m,
                              const graphene_rect_t *r,
                              graphene_quad_t *res);

Projects a graphene_rect_t using the given matrix.

Since: 1.2

graphene_matrix_untransform_point ()

bool
graphene_matrix_untransform_point (const graphene_matrix_t *m,
                                   const graphene_point_t *p,
                                   const graphene_rect_t *bounds,
                                   graphene_point_t *res);

Undoes the transformation of a graphene_point_t using the given matrix, within the given rectangular bounds .

Since: 1.0

graphene_matrix_untransform_bounds ()

void
graphene_matrix_untransform_bounds (const graphene_matrix_t *m,
                                    const graphene_rect_t *r,
                                    const graphene_rect_t *bounds,
                                    graphene_rect_t *res);

Undoes the transformation on the points of a graphene_rect_t using the given matrix, within the given rectangular bounds .

Since: 1.0

graphene_matrix_unproject_point3d ()

void
graphene_matrix_unproject_point3d (const graphene_matrix_t *projection,
                                   const graphene_matrix_t *modelview,
                                   const graphene_point3d_t *point,
                                   graphene_point3d_t *res);

Unprojects the given point using the projection matrix and a modelview matrix.

Since: 1.2

graphene_matrix_translate ()

void
graphene_matrix_translate (graphene_matrix_t *m,
                           const graphene_point3d_t *pos);

Adds a translation transformation to m using the coordinates of the given graphene_point3d_t.

Since: 1.0

graphene_matrix_rotate ()

void
graphene_matrix_rotate (graphene_matrix_t *m,
                        float angle,
                        const graphene_vec3_t *axis);

Adds a rotation transformation to m , using the given angle and axis vector.

Since: 1.0

graphene_matrix_rotate_x ()

void
graphene_matrix_rotate_x (graphene_matrix_t *m,
                          float angle);

Adds a rotation transformation around the X axis to m , using the given angle .

Since: 1.0

graphene_matrix_rotate_y ()

void
graphene_matrix_rotate_y (graphene_matrix_t *m,
                          float angle);

Adds a rotation transformation around the Y axis to m , using the given angle .

Since: 1.0

graphene_matrix_rotate_z ()

void
graphene_matrix_rotate_z (graphene_matrix_t *m,
                          float angle);

Adds a rotation transformation around the Z axis to m , using the given angle .

Since: 1.0

graphene_matrix_rotate_quaternion ()

void
graphene_matrix_rotate_quaternion (graphene_matrix_t *m,
                                   const graphene_quaternion_t *q);

Adds a rotation transformation to m , using the given graphene_quaternion_t.

Since: 1.2

graphene_matrix_rotate_euler ()

void
graphene_matrix_rotate_euler (graphene_matrix_t *m,
                              const graphene_euler_t *e);

Adds a rotation transformation to m , using the given graphene_euler_t.

Since: 1.2

graphene_matrix_scale ()

void
graphene_matrix_scale (graphene_matrix_t *m,
                       float factor_x,
                       float factor_y,
                       float factor_z);

Adds a scaling transformation to m , using the three given factors.

Since: 1.0

graphene_matrix_skew_xy ()

void
graphene_matrix_skew_xy (graphene_matrix_t *m,
                         float factor);

Adds a skew of factor on the X and Y axis to the given matrix.

Since: 1.0

graphene_matrix_skew_xz ()

void
graphene_matrix_skew_xz (graphene_matrix_t *m,
                         float factor);

Adds a skew of factor on the X and Z axis to the given matrix.

Since: 1.0

graphene_matrix_skew_yz ()

void
graphene_matrix_skew_yz (graphene_matrix_t *m,
                         float factor);

Adds a skew of factor on the Y and Z axis to the given matrix.

Since: 1.0

graphene_matrix_transpose ()

void
graphene_matrix_transpose (const graphene_matrix_t *m,
                           graphene_matrix_t *res);

Transposes the given matrix.

Since: 1.0

graphene_matrix_inverse ()

bool
graphene_matrix_inverse (const graphene_matrix_t *m,
                         graphene_matrix_t *res);

Inverts the given matrix.

Since: 1.0

graphene_matrix_perspective ()

void
graphene_matrix_perspective (const graphene_matrix_t *m,
                             float depth,
                             graphene_matrix_t *res);

Applies a perspective of depth to the matrix.

Since: 1.0

graphene_matrix_normalize ()

void
graphene_matrix_normalize (const graphene_matrix_t *m,
                           graphene_matrix_t *res);

Normalizes the given graphene_matrix_t.

Since: 1.0

graphene_matrix_get_x_scale ()

float
graphene_matrix_get_x_scale (const graphene_matrix_t *m);

Retrieves the scaling factor on the X axis in m .

Since: 1.0

graphene_matrix_get_y_scale ()

float
graphene_matrix_get_y_scale (const graphene_matrix_t *m);

Retrieves the scaling factor on the Y axis in m .

Since: 1.0

graphene_matrix_get_z_scale ()

float
graphene_matrix_get_z_scale (const graphene_matrix_t *m);

Retrieves the scaling factor on the Z axis in m .

Since: 1.0

graphene_matrix_interpolate ()

void
graphene_matrix_interpolate (const graphene_matrix_t *a,
                             const graphene_matrix_t *b,
                             double factor,
                             graphene_matrix_t *res);

Linearly interpolates the two given graphene_matrix_t by interpolating the decomposed transformations separately.

If either matrix cannot be reduced to their transformations then the interpolation cannot be performed, and this function will return an identity matrix.

Since: 1.0

graphene_matrix_print ()

void
graphene_matrix_print (const graphene_matrix_t *m);

Prints the contents of a matrix.

Since: 1.0

graphene_matrix_t

typedef struct {
} graphene_matrix_t;

A structure capable of holding a 4x4 matrix.

The contents of the graphene_matrix_t structure are private and should never be accessed directly.