NAME

XovListInvisiblePixels − get list of pixel values that produce invisible overlay pixel

SYNOPSIS

#include <X11/XOverlay.h>
unsigned int ∗XovListInvisiblePixels(display, visual, return_numbers_of_pixels)
Display∗display;
Visual∗visual;
int∗return_numbers_of_pixels;

ARGUMENTS

display Specifies the connection to the X server. 

visual Specifies the visual record of an overlay visual class. 

return_numbers_of_pixels
Return value: the length of the array of invisible pixels.

DESCRIPTION

If an overlay visual class window is at the top of the window stacking order, regions of that window that directly obscure windows of a non-overlay visual classes are transparent at each pixel that contains an "invisible pixel" value.  XovListInvisiblePixels returns an array of such invisible pixel values for a particular overlay visual class. 

visual must be a pointer to a visual record corresponding to an overlay visual class.  Such pointer values can be obtained with the function XGetVisualInfo(3X11), given an overlay visual class value obtained with XovListClasses(3X11). 

The return array is automatically allocated by XovListInvisiblePixels.  After it is used, it, and the indirect return value return_numbers_of_pixels, must be freed with routine XFree(3X11). 

SEE ALSO

XovIntro(3X11), XGetVisualInfo(3X11), XovListInvisiblePixels(3X11), XFree(3X11)

March 13, 1992