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

gf_layer_set_dst_viewport()

Set a layer's destination viewport

Synopsis:

#include <gf/gf.h>

void gf_layer_set_dst_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 destination 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.

The rectangle's coordinates must be within the bounds of the target display.

Library:

gf

Description:

This function sets a layer's desination viewport.

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


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

Classification:

QNX Graphics Framework

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_layer_set_src_viewport(), gf_layer_query()

“Viewports” in the Working with Layers, Surfaces and Contexts chapter