copy

Copies this frame.

Copied instance and its data are completely separate from the source and MUST be released independently when not used anymore, otherwise its memory will be leaked.

Note however that the copy is guaranteed to be backed by native heap memory, and not by hardware/decoder buffers (as may be the case with Frame instances that are delivered directly to the sink). Thus, a frame copy can be kept unreleased for as long as needed by the client and will never cause a video pipeline stall/crash.

Throws