gf_draw_end()

Finish rendering

Synopsis:

#include <gf/gf.h>

void gf_draw_end( gf_context_t context );

Arguments:

context
The draw context handle.

Library:

gf

Description:

This function ends a GF draw operation for the given context. All gf_draw_*() functions must be within a block begun with gf_draw_begin() and ended with gf_draw_end().

This function finishes rendering with the specified context. It relinquishes access to the rendering hardware, permitting other threads to acquire it. As with all the other drawing functions, you should call this function only following a successful call to gf_draw_begin(). Conversely, it's very important to balance each successful call to gf_draw_begin() with a corresponding call to gf_draw_end(), otherwise no other threads are able to render and your thread could eventually end up deadlocking itself.


Note: Because a successful call to gf_draw_begin() locks the hardware for exclusive access by the calling thread, you should call gf_draw_end() as soon as you are done rendering, to ensure hardware access by other threads or applications that are ready to render. Don't confuse this function with gf_draw_finish().

Classification:

QNX Graphics Framework

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_draw_begin(), gf_draw_finish()

Multi-threaded applications in the Basic Drawing chapter