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():

• 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 parameters are enqueued. You need to call gf_layer_update() to make them take effect.

---

Classification:

QNX Graphics Framework

See also:

gf_layer_set_src_viewport(), gf_layer_query()

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