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

gf_layer_set_src_viewport()

Set a layer's source viewport

Synopsis:

#include <gf/gf.h>

void gf_layer_set_src_viewport( gf_layer_t layer,
                                int x1,
                                int y1,
                                int x2,
                                int y2 );

Arguments:

layer: A pointer to a gf_layer_t handle of the layer you want to set the source viewport for.
x1, y1, x2, y2: The coordinates of the bounding rectangle for the destination viewport. The x1,y1 coordinates define the upper-left corner of the rectangle, and the x2, y2 coordinates define the lower-right corner.

Library:

gf

Description:

This function sets a layer's source viewport. The source viewport specifies the area of the target surface which the layer displays in the destination viewport.

There may be hardware limitations on viewports. Check these flag bits in gf_layer_info_t.caps filled in by gf_layer_query():

GF_LAYER_CAP_PAN_SOURCE — the source viewport position can be adjusted.
GF_LAYER_CAP_SIZE_DEST — the size of the destination viewport can be different from the size of the source viewport.
GF_LAYER_CAP_PAN_DEST — the position of the destination viewport can be adjusted

Changes to the layer's paramters are enqueued. You need to call gf_layer_update() to make them take effect.

Classification:

QNX Graphics Framework