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:

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.


WARNING: This function will fail, if an unsupported attribute is supplied to the layer.

Returns:

GF_ERR_OK
Success.
GF_ERR_NOSUPPORT
Unsupported attribute.
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

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

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