Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

gf_vcap_set_input_viewport()

Set the video capture source viewport

Synopsis:

#include <gf/gf.h>

void gf_vcap_set_input_viewport (
        gf_vcap_t   vcap,
        int         x1,
        int         y1,
        int         x2,
        int         y2 );

Arguments:

vcap
The handle of the video capture unit, returned by gf_vcap_attach().
x1
Left x value of the source viewport.
y1
Top y value of the source viewport.
x2
Right x value of the source viewport.
y2
Bottom y value of the source viewport.

Library:

gf

Description:

This function sets a video capture unit's source cropping viewport. The source viewport specifies the area of the frames received by the capture unit, which can be optionally scaled, and stored in the video capture buffer.


Note:
  • The rectangle must be within the bounds of the target display.
  • Changes made to a capture unit via the gf_vcap_set_*() set of functions are enqueued and do not take effect until you explicitly call gf_vcap_update().

Classification:

QNX Graphics Framework

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_vcap_attach(), gf_vcap_update()