screen_flush_blits()

Flush all the blits issued since the last call to screen_flush_blits() or screen_post_window()

Function type:

Flushing execution

Synopsis:

#include <screen/screen.h>

int screen_flush_blits( screen_context_t ctx, 
                        int flags )

Arguments:

ctx
A connection to screen (acquired with screen_create_context()).
flags
A flag used by the mutex. Specify SCREEN_WAIT_IDLE if the function should block until all the blits have been completed.

Library:

screen

Description:

Calling screen_flush_blits() flushes all delayed blits and fills since the last screen_post_window() or screen_flush_blits(). The blits will start executing shortly after you call the function. The blits may not be complete when the function returns, unless the SCREEN_WAIT_IDLE flag is set. This function has no effect on other non-blit delayed calls. The screen_post_window() function does an implicit flush of any pending blits. The content that wishes to be presented via the call to screen_post_window() is most likely the result of any pending blit operations completing.

Returns:

If the function succeeds, it returns 0 and the blit buffer is flushed. Otherwise, the function returns -1 and errno is set.

Classification:

Windowing API

Safety  Value  
Interrupt handler No
Signal handler No
Thread Yes