Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/api/gf_display_set_layer_order.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/api/gf_display_set_layer_order.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/api/gf_display_set_layer_order.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/api/gf_display_set_layer_order.html on line 8

gf_display_set_layer_order()

Set the ordering of the layers for a display

Synopsis:

#include <gf/gf.h>

int gf_display_set_layer_order( gf_display_t display,
                                const unsigned order[],
                                unsigned flags );

Arguments:

display
The handle for the display to set the layer order for. This handle is returned by gf_display_attach().
order
An array of type unsigned specifying the new order of the layers, with the first element in the array specifying the layer furthest to the back. Therefore, there must be the correct number of elements in the array, which is the number of available layers for that display. If there aren't enough elements in the array, the results aren't defined.
flags
Flags controlling additional options. Valid flags are:

Library:

gf

Description:

This function sets the ordering of the layers for a display. Each display is always equipped with at least one layer (known as the main display layer), but some hardware is equipped with additional layers that can provide advanced visual effects without incurring additional CPU overhead.


WARNING: Threads should not call this function between calls to gf_draw_begin() and gf_draw_end(), or a deadlock will occur.

Layers are stacked and therefore have an implicit z-order. Some hardware allows the reordering of these layers. The default ordering is numerical by layer index, with layer 0 being the furthest away from the user.

For example, to reverse the default order of the layers on a 2-layer display, you would specify an order array of { 1, 0 }. If there were six layers, and you wanted to move layer 2 to the back, you'd specify an order array of { 2, 0, 1, 3, 4, 5 }.

Returns:

GF_ERR_OK
Success.
GF_ERR_NOSUPPORT
Layer ordering is not supported on the specified display.
GF_ERR_PARM
Invalid layer order. Check to ensure there are no duplicate entries in your order array. Check the order_caps member of gf_layer_info_t (see gf_layer_query()) to ensure that all layers are being ordered to a supported slot.
GF_ERR_IODISPLAY
Error communicating with io-display. Check to ensure that io-display is running. The sloginfo utility may provide more information.

Classification:

QNX Graphics Framework

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_display_attach(), gf_display_detach()


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/api/gf_display_set_layer_order.html on line 155

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/api/gf_display_set_layer_order.html on line 155