XQueryBestStipple() XQueryBestStipple()
Name
XQueryBestStipple - obtain the fastest supported stipple shape.
Synopsis
Status XQueryBestStipple(display, which_screen, width, height,
width_return, height_return)
Display *display;
Drawable which_screen;
unsigned int width, height;
unsigned int *width_return, *height_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
which_screen Specifies a drawable that tells the server which screen you want the best size for.
width Specify the preferred width and height in pixels.
height
width_return Return the width and height, in pixels, of the stipple best supported by the display hardware.
height_return
Returns
Zero on failure, non-zero on success.
Description
XQueryBestStipple() returns the closest stipple size that can be stippled fastest. The drawable indicates the screen and possibly the vis-
ual class and depth. An InputOnly window cannot be used as the drawable (else a BadMatch error occurs).
XQueryBestStipple() returns non-zero if the call succeeded in getting a supported size (may be the same or different from the specified
size), or zero if the call failed.
For more information on stipples, see Volume One, Chapter 5, The Graphics Context.
Errors
BadDrawable
BadMatch InputOnly window.
See Also
XCreateBitmapFromData(), XCreatePixmap(), XCreatePixmapFromBitmapData(), XFreePixmap(), XQueryBestSize(), XQueryBestTile(), XReadBitmap-
File(), XSetTile(), XSetWindowBackgroundPixmap(), XSetWindowBorderPixmap(), XWriteBitmapFile().
Xlib - Pixmaps and Tiles XQueryBestStipple()
