Clutter.Actor.get_transformed_paint_volume

### Method

# Clutter Actorget_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` | `ClutterActor`
| A `ClutterActor` that is an ancestor of `self` (or `NULL` for the stage)
| The data is owned by the caller of the function.

#### Return value

Returns: | `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`.