get_transformed_paint_volume

Description:

[ Version ( since = "1.6" ) ]
public unowned PaintVolume? get_transformed_paint_volume (Actor relative_to_ancestor)

Retrieves the 3D paint volume of an actor like get_paint_volume does (Please refer to the documentation of 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 union.

Parameters:

this	a Actor
relative_to_ancestor	A Actor that is an ancestor of this (or `null` for the stage)

Returns:

a pointer to a PaintVolume, 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 copy.