Remove a reference from a specified pixmap.
#include <screen/screen.h>
int screen_unref_pixmap(screen_pixmap_t pix)
The handle of the pixmap for which the reference is to be removed.
Function Type: Immediate Execution
This function removes a reference to a pixmap. If the pixmap and its buffer haven't been destroyed yet, the effect of screen_unref_pixmap() is simply to decrease a reference count. If the pixmap or the pixmap buffer was destroyed while still being referenced, screen_unref_pixmap() will cause the pixmap and/or its buffer to be destroyed when the reference count reaches zero.
0 if the reference to the specified pixmap was removed, or -1 if an error occurred (errno is set; refer to /usr/include/errno.h for more details).