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

gf_draw_finish()

Wait for the rendering hardware to finish

Synopsis:

#include <gf/gf.h>

int gf_draw_finish( gf_context_t context );

Arguments:

context: The handle for the draw context to wait on.

Library:

gf

Description:

This function waits until all draw operations have actually been carried out. It's blocking and will not return until the hardware becomes idle.

This function flushes out buffered commands prior to waiting for them to be processed. Therefore, you do not need to call gf_draw_flush() explicitly prior to calling gf_draw_finish().

Don't confuse this function with gf_draw_end(). If you want to call it, call it between gf_draw_begin() and gf_draw_end().

Returns:

GF_ERR_OK: Success.
GF_ERR_NOLOCK: The hardware isn't locked; check to ensure gf_draw_begin() was called successfully.

Classification:

QNX Graphics Framework

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes