hpux man page for xquerybestcursor

XQueryBestCursor()														XQueryBestCursor()

Name
  XQueryBestCursor - get the closest supported cursor sizes.

Synopsis
  Status XQueryBestCursor(display, d, width, height,
	    width_return, height_return)
	Display *display;
	Drawable d;
	unsigned int width, height;
	unsigned int *width_return, *height_return;

Arguments
  display	 Specifies a connection to an X server; returned from XOpenDisplay().

  d		 Specifies a drawable that indicates which screen the cursor is to be used on.	The best cursor may be different on different
		 screens.

  width 	 Specify the preferred width and height, in pixels.
  height

  width_return	 Returns the closest supported cursor dimensions, in pixels, on the display hardware.
  height_return
Returns
  Zero on failure, non-zero on success.

Description
  XQueryBestCursor() returns the closest cursor dimensions actually supported by the display hardware to the dimensions you specify.

  Call this function if you wish to use a cursor size other than 16 by 16.  XQueryBestCursor() provides a way to find out what	size  cursors
  are actually possible on the display.  Applications should be prepared to use smaller cursors on displays which cannot support large ones.

  XQueryBestCursor()  returns  non-zero if the call succeeded in getting a supported size (which may be the same or different from the speci-
  fied size), or zero if the call failed.

Errors
  BadDrawable

See Also
  XCreateFontCursor(), XCreateGlyphCursor(), XCreatePixmapCursor(), XDefineCursor(), XFreeCursor(), XQueryBestSize(), XRecolorCursor(),  XUn-
  defineCursor().

Xlib - Cursors															XQueryBestCursor()