Method

ClutterActorget_transformed_paint_volume

Declaration [src]

const ClutterPaintVolume*
clutter_actor_get_transformed_paint_volume (
  ClutterActor* self,
  ClutterActor* relative_to_ancestor
)

Description [src]

Retrieves the 3D paint volume of an actor like clutter_actor_get_paint_volume() does (Please refer to the documentation of clutter_actor_get_paint_volume() for more details.) and it additionally transforms the paint volume into the coordinate space of relative_to_ancestor. (Or the stage if NULL is passed for relative_to_ancestor)

This can be used by containers that base their paint volume on the volume of their children. Such containers can query the transformed paint volume of all of its children and union them together using clutter_paint_volume_union().

Parameters

relative_to_ancestor

Type: ClutterActor

A ClutterActor that is an ancestor of self (or NULL for the stage)

The data is owned by the caller of the method.

Return value

Type: ClutterPaintVolume

A pointer to a ClutterPaintVolume, or NULL if no volume could be determined. The returned pointer is not guaranteed to be valid across multiple frames; if you wish to keep it, you will have to copy it using clutter_paint_volume_copy().

The data is owned by the instance.
The return value can be NULL.