NAME

XQueryBestSize, XQueryBestTile, XQueryBestStipple - determine efficient sizes

SYNTAX

Status XQueryBestSize(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, unsigned int _h_e_i_g_h_t, unsigned int *_w_i_d_t_h___r_e_t_u_r_n, unsigned int *_h_e_i_g_h_t___r_e_t_u_r_n); Status XQueryBestTile(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, unsigned int _h_e_i_g_h_t, unsigned int *_w_i_d_t_h___r_e_t_u_r_n, unsigned int *_h_e_i_g_h_t___r_e_t_u_r_n); Status XQueryBestStipple(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, unsigned int _h_e_i_g_h_t, unsigned int *_w_i_d_t_h___r_e_t_u_r_n, unsigned int *_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 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 argument, 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