Source

The video capture API includes constants that specify the video capture source properties.

Definitions:

#define CAPTURE_PROPERTY_SRC_COLOR_SPACE CAPTURE_PROPERTY( 'Q', 'N', 'C', 'S' )

A bit field that indicates the color space supported by the capture device.

Set this property according to the valid color space types as defined by Color space types. The color space types may be used with bitwise operators and the following flags to define CAPTURE_PROPERTY_SRC_COLOR_SPACE:

Read/Write uint32_t

#define CAPTURE_FLAG_COLOR_SPACE_LIMITED (0x00000000)

Use the following ranges for the specified color spaces:

RGB: 16..235 RGB range
YUV: 16..235 range for Y and 16..240 range for U and V

#define CAPTURE_FLAG_COLOR_SPACE_YEXTEND (0x01000000)

Use the following ranges for the specified color spaces:

RGB: 16..235 RGB range, works as CAPTURE_FLAG_COLOR_SPACE_LIMITED for RGB space.
YUV: 0..255 range for Y and 16..240 range for U and V

#define CAPTURE_FLAG_COLOR_SPACE_FULL (0x80000000)

Use the following ranges for the specified color spaces:

RGB: 0..255 extended RGB range
YUV: 0..255 extended YUV range for all components

For a 10/12 bits per color component, use full range of 0..1023/0..4095.

#define CAPTURE_FLAG_COLOR_SPACE_MASK (0xFF000000)

Mask to extract flags from color space data.

#define CAPTURE_PROPERTY_SRC_FORMAT CAPTURE_PROPERTY( 'Q', 'S', 'F', 'O' )

Source format; a the format of the stream of pixels from the video source.

When setting CAPTURE_PROPERTY_SRC_FORMAT, some valid values for this property are defined by Screen pixel format types in screen.h. If CAPTURE_PROPERTY_SRC_FORMAT needs additional formats beyond those in screen.h, then they must be defined in such a way that they do not conflict with the definitions of the Screen pixel format types.

Read/Write uint32_t

#define CAPTURE_PROPERTY_SRC_STRIDE CAPTURE_PROPERTY( 'Q', 'S', 'F', 'S' )

Source buffer stride, in bytes.

Read/Write uint32_t

#define CAPTURE_PROPERTY_SRC_WIDTH CAPTURE_PROPERTY( 'Q', 'S', 'W', 'I' )

Width of the source, in pixels.

Read/Write uint32_t

#define CAPTURE_PROPERTY_SRC_HEIGHT CAPTURE_PROPERTY( 'Q', 'S', 'H', 'E' )

Height of the source, in pixels.

Read/Write uint32_t

#define CAPTURE_PROPERTY_CROP_WIDTH CAPTURE_PROPERTY( 'Q', 'C', 'W', 'I' )

Width of source viewport, in pixels.

Read/Write uint32_t

#define CAPTURE_PROPERTY_CROP_HEIGHT CAPTURE_PROPERTY( 'Q', 'C', 'H', 'E' )

Height of source viewport, in pixels.

Read/Write uint32_t

#define CAPTURE_PROPERTY_CROP_X CAPTURE_PROPERTY( 'Q', 'C', 'X', 'P' )

Source viewport x offset.

Read/Write uint32_t

#define CAPTURE_PROPERTY_CROP_Y CAPTURE_PROPERTY( 'Q', 'C', 'Y', 'P' )

Source viewport y offset.

Read/Write uint32_t