IC4_DISPLAY Struct Reference
Represents a display that can be used to display images. More...
Detailed Description
Represents a display that can be used to display images.
This type is opaque, programs only use pointers of type IC4_DISPLAY*.
To create a display, use ic4_display_create() or ic4_display_create_external_opengl().
Display objects are generally used in two distinct ways:
- The display is connected to a data stream when calling ic4_grabber_stream_setup(), automatically displaying all images from the opened device.
- IC4_IMAGE_BUFFER objects are displayed manually by calling ic4_display_display_buffer().
Display objects are reference-counted. The initial reference count is one.
To share a display object between multiple parts of a program, use ic4_display_ref(). Call ic4_display_unref() when a reference is no longer required. If the reference count reaches zero, the display object is destroyed.
- Note
- Some functions, such as ic4_grabber_stream_setup(), share ownership of the display object passed as an argument. The display object is kept alive by the IC4_GRABBER instance even if no external references exist.
