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

gf_layer_update_multi()

Update parameters for multiple layers

Synopsis:

#include <gf/gf.h>

int gf_layer_update_multi( gf_layer_t  layer[],
                           unsigned    nlayers,
                           unsigned    flags );

Arguments:

layer

Array of layer handles to update.

nlayers

Number of items in the layer array.

flags

Flags to control the function's behavior. Valid flags are:

• GF_LAYER_UPDATE_NO_WAIT_VSYNC -- Perform the operation asynchronously; the default behavior is to block until the next vertical synchronization.
• GF_LAYER_UPDATE_NO_WAIT_IDLE -- Perform the operation immediately; the default behavior is to wait for the draw hardware to finish.

Library:

gf

Description:

This function updates the parameters for multiple layers as an atomic operation. Changes make to a layer with the gf_layer_*() set of functions are enqueued and don't take effect until you explicitly call this function.

Returns:

GF_ERR_OK

Success.

GF_ERR_IODISPLAY

Error communicating with io-display. Check to ensure io-display is still running. The sloginfo utility may provide more information.

GF_ERR_PARM

Specified layers span displays. All layers must belong to the same display. Ensure io-display is still running. The sloginfo utility may provide more information.

Classification:

QNX Graphics Framework

See also:

gf_layer_detach(), gf_layer_disable(), gf_layer_enable(), gf_layer_query(), gf_layer_update()