screen_destroy_pixmap_buffer()

Send a request to the composition manager to destory the buffer of the specified pixmap.

Synopsis:

#include <screen/screen.h>
 
int screen_destroy_pixmap_buffer(screen_pixmap_t pix)

Arguments:

pix

The handle of the pixmap whose buffer is to be destroyed.

Library:

libscreen

Description:

Function Type: Flushing Execution

This function releases the buffer that was allocated for a pixmap, without destroying the pixmap. If the buffer was created with screen_create_pixmap_buffer(), the memory is released and can be used for other window or pixmap buffers. If the buffer was attached using screen_attach_pixmap_buffer(), the buffer is destroyed but no memory is actually released. In this case the application is responsible for freeing the memory after calling screen_destroy_pixmap_buffer(). Once a pixmap buffer has been destroyed, you can change the format, usage and buffer size before creating a new buffer again. The memory that is released by this call is not reserved and can be used for any subsequent buffer allocation by the windowing system.

Returns:

0 if the memory used by the pixmap buffer was freed, or -1 if an error occurred (errno is set).