gf_layer_update()

Update layer parameters

Synopsis:

#include <gf/gf.h>

int gf_layer_update( gf_layer_t layer,
                     unsigned flags );

Arguments:

layer

The handle for the layer to update.

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 a layer's parameters. Changes made to a layer with the gf_layer_*() set of functions are enqueued and don't take effect until you explicitly call this function.

---

Threads should not call this function between calls to gf_draw_begin() and gf_draw_end(), or a deadlock will occur. This function will fail, if an unsupported attribute is supplied to the layer.

---

---

To update the parameters of several layers at once, use gf_layer_update_multi().

---

Returns:

GF_ERR_OK

Success.

GF_ERR_NOSUPPORT

Unsupported attribute.

Classification:

QNX Graphics Framework

See also:

gf_layer_detach(), gf_layer_disable(), gf_layer_enable(), gf_layer_query(), gf_layer_update_multi()