disp_vcap_props_t

Configurable properties of a video capture unit

Synopsis:

typedef struct disp_vcap_props {
    unsigned    flags;
    int         input_source;
    int         src_width;
    int         src_height;
    int         src_x1, src_y1;
    int         src_x2, src_y2;
    int         dst_width;
    int         dst_height;
    int         h_offset;
    int         v_offset;
    int         h_total;
    int         v_total;
    intptr_t    reserved[6];
} disp_vcap_props_t;

Description:

The disp_vcap_props_t describes the configurable properties of a video capture unit. The members include:

flags

Defined flags are:

• DISP_VCAP_FLAG_WEAVE — De-interlacing should be performed by weaving an odd field and an even field together to produce full-sized frames.
• DISP_VCAP_FLAG_BOB — De-interlacing should be performed by alternately expanding and displaying odd and even fields.
• DISP_VCAP_FLAG_ODD_ONLY — De-interlacing should be performed by expanding and displaying odd fields. Even fields are ignored.

All the flags above are mutually exclusive.

input_source

A video capture unit is considered to have one or more input sources from which video can be captured. These sources are numbered, starting at zero. This value selects the input source to capture from.

src_width

Specifies the total number of pixels present per scanline in the incoming video data.

src_height

Specifies the total number of scanlines present in the incoming video data.

src_x1, src_y1

Sets the upper left (inclusive) co-ordinate of the cropping rectangle applied to the incoming video frames, prior to scaling.

src_x2, src_y2

Sets the lower right (inclusive) co-ordinate of the cropping rectangle applied to the incoming video frames, prior to scaling.

dst_width, dst_height

After cropping, the frame data is scaled. The dst_width and dst_height members specify the width and height, respectively, of the video frames after scaling.

h_offset, v_offset

Device-dependent values that may be needed to synchronized to the incoming video signal. For example, when capturing a VGA signal, these values could be used to specify the horizontal total pixel count, and total number of scanlines, of the incoming video signal. For ITU656 capture, these values would typically be ignored.

h_total, v_total

Device-dependent values that may be needed to centre the incoming video signal. For example, when capturing a VGA signal, these values could be used to specify the horizontal and vertical sync start positions of the incoming video signal. For ITU656 capture, these values would typically be ignored.

Classification:

Neutrino

See also:

disp_vcapfuncs_t