make_writable


Description:

[ DestroysInstance ]
[ ReturnsModifiedPointer ]
public OverlayComposition make_writable ()

Takes ownership of this and returns a version of this that is writable (i.

e. can be modified). Will either return this right away, or create a new writable copy of this and unref this itself. All the contained rectangles will also be copied, but the actual overlay pixel data buffers contained in the rectangles are not copied.

This should be avoided unless rectangles need to be modified because it invalidates caching in sinks and compositor elements. To add extra rectangles it is rather recommended to add an extra composition meta using buffer_add_video_overlay_composition_meta.

Parameters:

this

a OverlayComposition to copy

Returns:

a writable OverlayComposition equivalent to this.