screen_create_pixmap()

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 the composition manager. 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 a new pixmap was created,or -1 if an error occurred (errno is set; refer to /usr/include/errno.h for more details).