home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xquerybestsize.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XQueryBestSize(3X11)      XLIB FUNCTIONS     XQueryBestSize(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XQueryBestSize, XQueryBestTile, XQueryBestStipple - deter-
  9.        mine efficient sizes
  10.  
  11. SSYYNNTTAAXX
  12.        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,
  13.        _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)
  14.          Display *_d_i_s_p_l_a_y;
  15.          int _c_l_a_s_s;
  16.          Drawable _w_h_i_c_h___s_c_r_e_e_n;
  17.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  18.          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;
  19.  
  20.        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,
  21.        _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)
  22.          Display *_d_i_s_p_l_a_y;
  23.          Drawable _w_h_i_c_h___s_c_r_e_e_n;
  24.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  25.          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;
  26.  
  27.        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,
  28.        _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)
  29.          Display *_d_i_s_p_l_a_y;
  30.          Drawable _w_h_i_c_h___s_c_r_e_e_n;
  31.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  32.          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;
  33.  
  34. AARRGGUUMMEENNTTSS
  35.        _c_l_a_s_s     Specifies the class that you are interested in.
  36.          You can pass _T_i_l_e_S_h_a_p_e, _C_u_r_s_o_r_S_h_a_p_e, or
  37.          _S_t_i_p_p_l_e_S_h_a_p_e.
  38.  
  39.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  40.  
  41.        _w_i_d_t_h
  42.        _h_e_i_g_h_t     Specify the width and height.
  43.  
  44.        _w_h_i_c_h___s_c_r_e_e_n
  45.          Specifies any drawable on the screen.
  46.  
  47.        _w_i_d_t_h___r_e_t_u_r_n
  48.        _h_e_i_g_h_t___r_e_t_u_r_n
  49.          Return the width and height of the object best
  50.          supported by the display hardware.
  51.  
  52. DDEESSCCRRIIPPTTIIOONN
  53.        The _X_Q_u_e_r_y_B_e_s_t_S_i_z_e function returns the best or closest
  54.        size to the specified size.  For _C_u_r_s_o_r_S_h_a_p_e, this is the
  55.        largest size that can be fully displayed on the screen
  56.        specified by which_screen.  For _T_i_l_e_S_h_a_p_e, this is the
  57.        size that can be tiled fastest.    For _S_t_i_p_p_l_e_S_h_a_p_e, this is
  58.        the size that can be stippled fastest.  For _C_u_r_s_o_r_S_h_a_p_e,
  59.        the drawable indicates the desired screen.  For _T_i_l_e_S_h_a_p_e
  60.        and _S_t_i_p_p_l_e_S_h_a_p_e, the drawable indicates the screen and
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XQueryBestSize(3X11)      XLIB FUNCTIONS     XQueryBestSize(3X11)
  71.  
  72.  
  73.        possibly the window class and depth.  An _I_n_p_u_t_O_n_l_y window
  74.        cannot be used as the drawable for _T_i_l_e_S_h_a_p_e or
  75.        _S_t_i_p_p_l_e_S_h_a_p_e, or a _B_a_d_M_a_t_c_h error results.
  76.  
  77.        _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
  78.        _B_a_d_V_a_l_u_e errors.
  79.  
  80.        The _X_Q_u_e_r_y_B_e_s_t_T_i_l_e function returns the best or closest
  81.        size, that is, the size that can be tiled fastest on the
  82.        screen specified by which_screen.  The drawable indicates
  83.        the screen and possibly the window class and depth.  If an
  84.        _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
  85.        results.
  86.  
  87.        _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
  88.        errors.
  89.  
  90.        The _X_Q_u_e_r_y_B_e_s_t_S_t_i_p_p_l_e function returns the best or closest
  91.        size, that is, the size that can be stippled fastest on
  92.        the screen specified by which_screen.  The drawable indi-
  93.        cates the screen and possibly the window class and depth.
  94.        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
  95.        error results.
  96.  
  97.        _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
  98.        errors.
  99.  
  100. DDIIAAGGNNOOSSTTIICCSS
  101.        _B_a_d_M_a_t_c_h     An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  102.  
  103.        _B_a_d_D_r_a_w_a_b_l_e
  104.          A value for a Drawable argument does not name a
  105.          defined Window or Pixmap.
  106.  
  107.        _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.
  108.  
  109.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  110.          values accepted by the request.  Unless a spe-
  111.          cific range is specified for an argument, the
  112.          full range defined by the argument's type is
  113.          accepted.  Any argument defined as a set of
  114.          alternatives can generate this error.
  115.  
  116. SSEEEE AALLSSOO
  117.        XCreateGC(3X11), XSetArcMode(3X11), XSetClipOrigin(3X11),
  118.        XSetFillStyle(3X11), XSetFont(3X11), XSetLineAt-
  119.        tributes(3X11), XSetState(3X11), XSetTile(3X11)
  120.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.