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 ofself
(orNULL
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 . |