home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XQueryBestSize.z / XQueryBestSize
Encoding:
Text File  |  1998-10-30  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXQQQQuuuueeeerrrryyyyBBBBeeeessssttttSSSSiiiizzzzeeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXQQQQuuuueeeerrrryyyyBBBBeeeessssttttSSSSiiiizzzzeeee((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XQueryBestSize, XQueryBestTile, XQueryBestStipple -
  10.           determine efficient sizes
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           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,
  14.           _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)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 int _c_l_a_s_s;
  17.                 Drawable _w_h_i_c_h__s_c_r_e_e_n;
  18.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  19.                 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;
  20.  
  21.           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,
  22.           _w_i_d_t_h__r_e_t_u_r_n, _h_e_i_g_h_t__r_e_t_u_r_n)
  23.                 Display *_d_i_s_p_l_a_y;
  24.                 Drawable _w_h_i_c_h__s_c_r_e_e_n;
  25.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  26.                 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;
  27.  
  28.           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,
  29.           _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)
  30.                 Display *_d_i_s_p_l_a_y;
  31.                 Drawable _w_h_i_c_h__s_c_r_e_e_n;
  32.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  33.                 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;
  34.  
  35.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  36.           _c_l_a_s_s     Specifies the class that you are interested in.
  37.                     You can pass _T_i_l_e_S_h_a_p_e, _C_u_r_s_o_r_S_h_a_p_e, or
  38.                     _S_t_i_p_p_l_e_S_h_a_p_e.
  39.  
  40.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  41.  
  42.           _w_i_d_t_h
  43.           _h_e_i_g_h_t    Specify the width and height.
  44.  
  45.           _w_h_i_c_h__s_c_r_e_e_n
  46.                     Specifies any drawable on the screen.
  47.  
  48.           _w_i_d_t_h__r_e_t_u_r_n
  49.           _h_e_i_g_h_t__r_e_t_u_r_n
  50.                     Return the width and height of the object best
  51.                     supported by the display hardware.
  52.  
  53.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  54.           The _X_Q_u_e_r_y_B_e_s_t_S_i_z_e function returns the best or closest size
  55.           to the specified size.  For _C_u_r_s_o_r_S_h_a_p_e, this is the largest
  56.           size that can be fully displayed on the screen specified by
  57.           which_screen.  For _T_i_l_e_S_h_a_p_e, this is the size that can be
  58.           tiled fastest.  For _S_t_i_p_p_l_e_S_h_a_p_e, this is the size that can
  59.           be stippled fastest.  For _C_u_r_s_o_r_S_h_a_p_e, the drawable
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXQQQQuuuueeeerrrryyyyBBBBeeeessssttttSSSSiiiizzzzeeee((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXQQQQuuuueeeerrrryyyyBBBBeeeessssttttSSSSiiiizzzzeeee((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           indicates the desired screen.  For _T_i_l_e_S_h_a_p_e and
  75.           _S_t_i_p_p_l_e_S_h_a_p_e, the drawable indicates the screen and possibly
  76.           the window class and depth.  An _I_n_p_u_t_O_n_l_y window cannot be
  77.           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
  78.           _B_a_d_M_a_t_c_h error results.
  79.  
  80.           _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
  81.           _B_a_d_V_a_l_u_e errors.
  82.  
  83.           The _X_Q_u_e_r_y_B_e_s_t_T_i_l_e function returns the best or closest
  84.           size, that is, the size that can be tiled fastest on the
  85.           screen specified by which_screen.  The drawable indicates
  86.           the screen and possibly the window class and depth.  If an
  87.           _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
  88.           results.
  89.  
  90.           _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.
  91.  
  92.           The _X_Q_u_e_r_y_B_e_s_t_S_t_i_p_p_l_e function returns the best or closest
  93.           size, that is, the size that can be stippled fastest on the
  94.           screen specified by which_screen.  The drawable indicates
  95.           the screen and possibly the window class and depth.  If an
  96.           _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
  97.           results.
  98.  
  99.           _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
  100.           errors.
  101.  
  102.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  103.           _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  104.  
  105.           _B_a_d_D_r_a_w_a_b_l_e
  106.                     A value for a Drawable argument does not name a
  107.                     defined Window or Pixmap.
  108.  
  109.           _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.
  110.  
  111.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  112.                     values accepted by the request.  Unless a specific
  113.                     range is specified for an argument, the full range
  114.                     defined by the argument's type is accepted.  Any
  115.                     argument defined as a set of alternatives can
  116.                     generate this error.
  117.  
  118.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  119.           XCreateGC(3X11), XSetArcMode(3X11), XSetClipOrigin(3X11),
  120.           XSetFillStyle(3X11), XSetFont(3X11),
  121.           XSetLineAttributes(3X11), XSetState(3X11), XSetTile(3X11)
  122.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.