


XQueryBestSize(3X11)					 XQueryBestSize(3X11)
X11R5									X11R5



NAME
  XQueryBestSize, XQueryBestTile, XQueryBestStipple - determine	efficient
  sizes

SYNTAX
  Status XQueryBestSize(_d_i_s_p_l_a_y, _c_l_a_s_s,	_w_h_i_c_h__s_c_r_e_e_n, _w_i_d_t_h, _h_e_i_g_h_t,
  _w_i_d_t_h__r_e_t_u_r_n,	_h_e_i_g_h_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	int _c_l_a_s_s;
	Drawable _w_h_i_c_h__s_c_r_e_e_n;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
	unsigned int *_w_i_d_t_h__r_e_t_u_r_n, *_h_e_i_g_h_t__r_e_t_u_r_n;

  Status XQueryBestTile(_d_i_s_p_l_a_y, _w_h_i_c_h__s_c_r_e_e_n, _w_i_d_t_h, _h_e_i_g_h_t, _w_i_d_t_h__r_e_t_u_r_n,
  _h_e_i_g_h_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Drawable _w_h_i_c_h__s_c_r_e_e_n;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
	unsigned int *_w_i_d_t_h__r_e_t_u_r_n, *_h_e_i_g_h_t__r_e_t_u_r_n;

  Status XQueryBestStipple(_d_i_s_p_l_a_y, _w_h_i_c_h__s_c_r_e_e_n, _w_i_d_t_h, _h_e_i_g_h_t,
  _w_i_d_t_h__r_e_t_u_r_n,	_h_e_i_g_h_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Drawable _w_h_i_c_h__s_c_r_e_e_n;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
	unsigned int *_w_i_d_t_h__r_e_t_u_r_n, *_h_e_i_g_h_t__r_e_t_u_r_n;

ARGUMENTS

  _c_l_a_s_s	    Specifies the class	that you are interested	in.  You can pass
	    _T_i_l_e_S_h_a_p_e, _C_u_r_s_o_r_S_h_a_p_e, or _S_t_i_p_p_l_e_S_h_a_p_e.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _w_i_d_t_h
  _h_e_i_g_h_t    Specify the	width and height.

  _w_h_i_c_h__s_c_r_e_e_n
	    Specifies any drawable on the screen.

  _w_i_d_t_h__r_e_t_u_r_n
  _h_e_i_g_h_t__r_e_t_u_r_n
	    Return the width and height	of the object best supported by	the
	    display hardware.

DESCRIPTION
  The _X_Q_u_e_r_y_B_e_s_t_S_i_z_e function returns the best or closest size to the speci-
  fied size.  For _C_u_r_s_o_r_S_h_a_p_e, this is the largest size	that can be fully
  displayed on the screen specified by which_screen.  For _T_i_l_e_S_h_a_p_e, this is
  the size that	can be tiled fastest.  For _S_t_i_p_p_l_e_S_h_a_p_e, this is the size
  that can be stippled fastest.	 For _C_u_r_s_o_r_S_h_a_p_e, the drawable indicates the
  desired screen.  For _T_i_l_e_S_h_a_p_e and _S_t_i_p_p_l_e_S_h_a_p_e, the drawable	indicates the
  screen and possibly the window class and depth.  An _I_n_p_u_t_O_n_l_y	window cannot
  be used as the drawable for _T_i_l_e_S_h_a_p_e	or _S_t_i_p_p_l_e_S_h_a_p_e, or a _B_a_d_M_a_t_c_h error
  results.

  _X_Q_u_e_r_y_B_e_s_t_S_i_z_e can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_M_a_t_c_h, and _B_a_d_V_a_l_u_e errors.

  The _X_Q_u_e_r_y_B_e_s_t_T_i_l_e function returns the best or closest size,	that is, the
  size that can	be tiled fastest on the	screen specified by which_screen.
  The drawable indicates the screen and	possibly the window class and depth.
  If an	_I_n_p_u_t_O_n_l_y window is used as the	drawable, a _B_a_d_M_a_t_c_h error results.

  _X_Q_u_e_r_y_B_e_s_t_T_i_l_e can generate _B_a_d_D_r_a_w_a_b_l_e and _B_a_d_M_a_t_c_h errors.

  The _X_Q_u_e_r_y_B_e_s_t_S_t_i_p_p_l_e	function returns the best or closest size, that	is,
  the size that	can be stippled	fastest	on the screen specified	by
  which_screen.	 The drawable indicates	the screen and possibly	the window
  class	and depth.  If an _I_n_p_u_t_O_n_l_y window is used as the drawable, a _B_a_d_-
  _M_a_t_c_h	error results.

  _X_Q_u_e_r_y_B_e_s_t_S_t_i_p_p_l_e can	generate _B_a_d_D_r_a_w_a_b_l_e and _B_a_d_M_a_t_c_h errors.

DIAGNOSTICS

  _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window	is used	as a Drawable.

  _B_a_d_D_r_a_w_a_b_l_e
	    A value for	a Drawable argument does not name a defined Window or
	    Pixmap.

  _B_a_d_M_a_t_c_h  The	values do not exist for	an _I_n_p_u_t_O_n_l_y window.

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

SEE ALSO
  XCreateGC(3X11), XSetArcMode(3X11), XSetClipOrigin(3X11),
  XSetFillStyle(3X11), XSetFont(3X11), XSetLineAttributes(3X11),
  XSetState(3X11), XSetTile(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off






























