IC4_IMAGE_BUFFER Struct Reference

Represents an image buffer.

This type is opaque, programs only use pointers of type IC4_IMAGE_BUFFER*.

Image buffer objects are created automatically by the various Sinks types, on request by a IC4_BUFFER_POOL, or by calling ic4_imagebuffer_wrap_memory().

Image buffer objects are reference-counted. To share an image buffer object between multiple parts of a program, use ic4_imagebuffer_ref(). Call ic4_imagebuffer_unref() when a reference is no longer required.

If the reference count reaches zero, the image buffer is returned to its source to be reused. For example, an image buffer retrieved from ic4_queuesink_pop_output_buffer() will be re-queued.