screen_attach_pixmap_buffer()

Updated: April 19, 2023

Associate a buffer with a pixmap

Synopsis:

#include <screen/screen.h>
int screen_attach_pixmap_buffer(screen_pixmap_t pix,
                                screen_buffer_t buf)

Arguments:

pix
The handle of a pixmap that the buffer is being attached to.
buf
A buffer that's to be attached to pix.

Library:

libscreen

Description:

Function Type: Flushing Execution

You must be working within a SCREEN_BUFFER_PROVIDER_CONTEXT in order to call this function successfully. This function allows a pixmap to use a buffer that was allocated by the application or Screen. Note that each pixmap can have only one buffer. For more information, see the "Buffers" chapter of the Screen Developer's Guide.

Returns:

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