Cogl.MatrixStack.get

### Method

# Cogl MatrixStackget

#### Declaration [src]

    graphene_matrix_t*
    cogl_matrix_stack_get (
      CoglMatrixStack* stack,
      graphene_matrix_t* matrix
    )

#### Description [src]

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

There are two possible ways that this function may return its result depending on whether the stack is able to directly point to an internal #graphene_matrix_t or whether the result needs to be composed of multiple operations.

If an internal matrix contains the required result then this function will directly return a pointer to that matrix, otherwise if the function returns `NULL` then `matrix` will be initialized to match the current transform of `stack`.

`matrix` will be left untouched if a direct pointer is returned.

#### Parameters

`matrix`

  Type: `graphene_matrix_t`

  The potential destination for the current matrix.

  The argument will be set by the function.
  The returned data is owned by the instance.

#### Return value

Type: `graphene_matrix_t`

A direct pointer to the current transform or `NULL` and in that case `matrix` will be initialized with the value of the current transform.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.