XQueryBestSize(3X11) AIX (XLIB FUNCTIONS) XQueryBestSize(3X11) NAME XQueryBestSize, XQueryBestTile, XQueryBestStipple - deter- mine 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 specified 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 indi- cates 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, Rev. Release 5 Page 1 XQueryBestSize(3X11) AIX (XLIB FUNCTIONS) XQueryBestSize(3X11) 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 argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can gen- erate 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 Rev. Release 5 Page 2