Method
CoglMatrixStackget
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_tThe 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. |