### Class

# CoglMatrixStack

#### Description [src]

```
final class Cogl.MatrixStack : GObject.Object
{
/* No available fields */
}
```

Efficiently tracking many related transformations.

Tracks your current position within a hierarchy and lets you build up a graph of transformations as you traverse through a hierarchy such as a scenegraph.

A `CoglMatrixStack`

always maintains a reference to a single
transformation at any point in time, representing the
transformation at the current position in the hierarchy. You can
get a reference to the current transformation by calling cogl_matrix_stack_get_entry().

When a `CoglMatrixStack`

is first created with
`cogl_matrix_stack_new()`

then it is conceptually positioned at the
root of your hierarchy and the current transformation simply
represents an identity transformation.

As you traverse your object hierarchy (your scenegraph) then you
should call `cogl_matrix_stack_push()`

whenever you move down one
level and call `cogl_matrix_stack_pop()`

whenever you move back up
one level towards the root.

At any time you can apply a set of operations, such as “rotate”,
“scale”, “translate” on top of the current transformation of a
`CoglMatrixStack`

using functions such as
cogl_matrix_stack_rotate(), `cogl_matrix_stack_scale()`

and
cogl_matrix_stack_translate(). These operations will derive a new
current transformation and will never affect a transformation
that you have referenced using cogl_matrix_stack_get_entry().

Internally applying operations to a `CoglMatrixStack`

builds up a
graph of `CoglMatrixEntry`

structures which each represent a single
immutable transform.

#### Constructors

###### cogl_matrix_stack_new

Allocates a new `CoglMatrixStack`

that can be used to build up
transformations relating to objects in a scenegraph like hierarchy.
(See the description of `CoglMatrixStack`

and `CoglMatrixEntry`

for
more details of what a matrix stack is best suited for)

#### Instance methods

###### cogl_matrix_stack_frustum

Replaces the current matrix with a perspective matrix for a given viewing frustum defined by 4 side clip planes that all cross through the origin and 2 near and far clip planes.

###### cogl_matrix_stack_get

Resolves the current `stack`

transform into a #graphene_matrix_t by
combining the operations that have been applied to build up the
current transform.

###### cogl_matrix_stack_get_entry

Gets a reference to the current transform represented by a
`CoglMatrixEntry`

pointer.

###### cogl_matrix_stack_get_inverse

Gets the inverse transform of the current matrix and uses it to initialize a new #graphene_matrix_t.

###### cogl_matrix_stack_perspective

Replaces the current matrix with a perspective matrix based on the provided values.

###### cogl_matrix_stack_pop

Restores the previous transform that was last saved by calling cogl_matrix_stack_push().

###### cogl_matrix_stack_push

Saves the current transform and starts a new transform that derives from the current transform.

###### cogl_matrix_stack_rotate

Multiplies the current matrix by one that rotates the around the
axis-vector specified by `x`

, `y`

and `z`

. The rotation follows the
right-hand thumb rule so for example rotating by 10 degrees about
the axis-vector (0, 0, 1) causes a small counter-clockwise rotation.

###### cogl_matrix_stack_rotate_euler

Multiplies the current matrix by one that rotates according to the
rotation described by `euler`

.

###### cogl_matrix_stack_scale

Multiplies the current matrix by one that scales the x, y and z axes by the given values.

###### cogl_matrix_stack_set

Replaces the current `stack`

matrix value with the value of `matrix`

.
This effectively discards any other operations that were applied
since the last time `cogl_matrix_stack_push()`

was called or since
the stack was initialized.

###### cogl_matrix_stack_translate

Multiplies the current matrix by one that translates along all three axes according to the given values.

#### Signals

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.