home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xdbegetvisualinfo.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XdbeGetVisualInfo(3X11)       X FUNCTIONS      XdbeGetVisualInfo(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XdbeGetVisualInfo
  9.  
  10. SSYYNNOOPPSSIISS
  11.        #include <X11/extensions/Xdbe.h>
  12.  
  13.        XdbeScreenVisualInfo *XdbeGetVisualInfo(
  14.        Display  *dpy,
  15.        Drawable *screen_specifiers,
  16.        int        *num_screens)
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.        This function returns information about which visuals sup-
  20.        port double buffering.  The argument _n_u_m___s_c_r_e_e_n_s specifies
  21.        how many elements there are in the _s_c_r_e_e_n___s_p_e_c_i_f_i_e_r_s list.
  22.        Each drawable in _s_c_r_e_e_n___s_p_e_c_i_f_i_e_r_s designates a screen for
  23.        which  the  supported  visuals  are  being  requested.  If
  24.        _n_u_m___s_c_r_e_e_n_s  is    zero,  information  for     all  screens  is
  25.        requested.   In this case, upon return from this function,
  26.        _n_u_m___s_c_r_e_e_n_s will be set to the number of screens that were
  27.        found.    If  an    error occurs, this function returns NULL,
  28.        else it returns a pointer to a list  of    _X_d_b_e_S_c_r_e_e_n_V_i_s_u_a_l_-
  29.        _I_n_f_o structures of length _n_u_m___s_c_r_e_e_n_s_.  The nth element in
  30.        the returned list corresponds to the nth drawable  in  the
  31.        _s_c_r_e_e_n___s_p_e_c_i_f_i_e_r_s  list,     unless _n_u_m___s_c_r_e_e_n_s was passed in
  32.        with the value zero, in which case the nth element in  the
  33.        returned list corresponds to the nth screen of the server,
  34.        starting     with  screen  zero.   The   _X_d_b_e_S_c_r_e_e_n_V_i_s_u_a_l_I_n_f_o
  35.        structure has the following fields:
  36.  
  37.         int           count
  38.         XdbeVisualInfo *visinfo
  39.  
  40.        _c_o_u_n_t  specifies     the number of items in _v_i_s_i_n_f_o_.  _v_i_s_i_n_f_o
  41.        specifies a list of visuals, depths, and performance hints
  42.        for this screen.
  43.  
  44.        The _X_d_b_e_V_i_s_u_a_l_I_n_f_o structure has the following fields:
  45.  
  46.         VisualID visual
  47.         int         depth
  48.         int         perflevel
  49.  
  50.        _v_i_s_u_a_l  specifies  one  visual  ID  that     supports double-
  51.        buffering.  _d_e_p_t_h specifies the depth of the visual.  _p_e_r_-
  52.        _f_l_e_v_e_l is a performance hint.
  53.  
  54.        The only operation defined on a _p_e_r_f_l_e_v_e_l is comparison to
  55.        a _p_e_r_f_l_e_v_e_l of another visual on     the  same  screen.   The
  56.        visual  having the higher _p_e_r_f_l_e_v_e_l is likely to have bet-
  57.        ter double-buffering graphics performance than the  visual
  58.        having  the  lower _p_e_r_f_l_e_v_e_l_.  Nothing can be deduced from
  59.        the following: the magnitude of the difference of two _p_e_r_-
  60.        _f_l_e_v_e_l_s_,     a  _p_e_r_f_l_e_v_e_l  value  in  isolation, or comparing
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XdbeGetVisualInfo(3X11)       X FUNCTIONS      XdbeGetVisualInfo(3X11)
  71.  
  72.  
  73.        _p_e_r_f_l_e_v_e_l_s from different servers.
  74.  
  75.  
  76. EERRRROORRSS
  77.        BadDrawable
  78.           One or more values passed in  _s_c_r_e_e_n___s_p_e_c_i_f_i_e_r_s  is
  79.           not a valid drawable.
  80.  
  81. SSEEEE AALLSSOO
  82.        DBE, _X_d_b_e_A_l_l_o_c_a_t_e_B_a_c_k_B_u_f_f_e_r_N_a_m_e_(_)_, _X_d_b_e_B_e_g_i_n_I_d_i_o_m_(_)_, _X_d_b_e_-
  83.        _D_e_a_l_l_o_c_a_t_e_B_a_c_k_B_u_f_f_e_r_N_a_m_e_(_)_, _X_d_b_e_E_n_d_I_d_i_o_m_(_)_,  _X_d_b_e_F_r_e_e_V_i_s_u_-
  84.        _a_l_I_n_f_o_(_)_,  _X_d_b_e_G_e_t_B_a_c_k_B_u_f_f_e_r_A_t_t_r_i_b_u_t_e_s_(_)_,  _X_d_b_e_Q_u_e_r_y_E_x_t_e_n_-
  85.        _s_i_o_n_(_)_, _X_d_b_e_S_w_a_p_B_u_f_f_e_r_s_(_)_.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.