screen_create_pixmap()

Updated: April 19, 2023

Create a pixmap that can be used to do off-screen rendering

Synopsis:

#include <screen/screen.h>
int screen_create_pixmap(screen_pixmap_t *ppix,
                         screen_context_t ctx)

Arguments:

ppix
An address where the function can store the handle to the newly created native pixmap.
ctx
The connection to Screen. This context must have been created with screen_create_context().

Library:

libscreen

Description:

Function Type: Immediate Execution

This function creates a pixmap object, which is an off-screen rendering target. The results of this rendering can later be copied to a window object. Applications must use screen_destroy_pixmap() when a pixmap is no longer used.

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).