Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

which_screenSpecifies a drawable that tells the server which screen you want the best size for. 

width

heightSpecify the preferred width and height in pixels. 

width_return

height_returnReturn the width and height, in pixels, of the stipple best supported by the display hardware. 

Description

XQueryBestStipple() returns the closest stipple size that can be stippled fastest.  The drawable indicates the screen and possibly the visual class and depth.  An InputOnly window cannot be used as the drawable (else a BadMatch error occurs).  XQueryBestStipple() returns nonzero 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

BadMatchInputOnly window. 

See Also

XCreateBitmapFromData(), XCreatePixmap(), XCreatePixmapFromBitmapData(), XFreePixmap(), XQueryBestSize(), XQueryBestTile(), XReadBitmapFile(), XSetTile(), XSetWindowBackgroundPixmap(), XSetWindowBorderPixmap(), XWriteBitmapFile(). 

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026