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.

See also

ic4_display_create

ic4_display_ref

ic4_display_unref