home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xinstallcolormap.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XInstallColormap(3X11)      XLIB FUNCTIONS   XInstallColormap(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XInstallColormap, XUninstallColormap, XListInstalledCol-
  9.        ormaps - control colormaps
  10.  
  11. SSYYNNTTAAXX
  12.        XInstallColormap(_d_i_s_p_l_a_y, _c_o_l_o_r_m_a_p)
  13.          Display *_d_i_s_p_l_a_y;
  14.          Colormap _c_o_l_o_r_m_a_p;
  15.  
  16.        XUninstallColormap(_d_i_s_p_l_a_y, _c_o_l_o_r_m_a_p)
  17.          Display *_d_i_s_p_l_a_y;
  18.          Colormap _c_o_l_o_r_m_a_p;
  19.  
  20.        Colormap *XListInstalledColormaps(_d_i_s_p_l_a_y, _w, _n_u_m___r_e_t_u_r_n)
  21.          Display *_d_i_s_p_l_a_y;
  22.          Window _w;
  23.          int *_n_u_m___r_e_t_u_r_n;
  24.  
  25. AARRGGUUMMEENNTTSS
  26.        _c_o_l_o_r_m_a_p     Specifies the colormap.
  27.  
  28.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  29.  
  30.        _n_u_m___r_e_t_u_r_n
  31.          Returns the number of currently installed col-
  32.          ormaps.
  33.  
  34.        _w     Specifies the window that determines the screen.
  35.  
  36. DDEESSCCRRIIPPTTIIOONN
  37.        The _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p function installs the specified col-
  38.        ormap for its associated screen.     All windows associated
  39.        with this colormap immediately display with true colors.
  40.        You associated the windows with this colormap when you
  41.        created them by calling _X_C_r_e_a_t_e_W_i_n_d_o_w,
  42.        _X_C_r_e_a_t_e_S_i_m_p_l_e_W_i_n_d_o_w, _X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s, or
  43.        _X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p.
  44.  
  45.        If the specified colormap is not already an installed col-
  46.        ormap, the X server generates a _C_o_l_o_r_m_a_p_N_o_t_i_f_y event on
  47.        each window that has that colormap.  In addition, for
  48.        every other colormap that is installed as a result of a
  49.        call to _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p, the X server generates a _C_o_l_-
  50.        _o_r_m_a_p_N_o_t_i_f_y event on each window that has that colormap.
  51.  
  52.        _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p can generate a _B_a_d_C_o_l_o_r error.
  53.  
  54.        The _X_U_n_i_n_s_t_a_l_l_C_o_l_o_r_m_a_p function removes the specified col-
  55.        ormap from the required list for its screen.  As a result,
  56.        the specified colormap might be uninstalled, and the X
  57.        server might implicitly install or uninstall additional
  58.        colormaps.  Which colormaps get installed or uninstalled
  59.        is server dependent except that the required list must
  60.        remain installed.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XInstallColormap(3X11)      XLIB FUNCTIONS   XInstallColormap(3X11)
  71.  
  72.  
  73.        If the specified colormap becomes uninstalled, the X
  74.        server generates a _C_o_l_o_r_m_a_p_N_o_t_i_f_y event on each window
  75.        that has that colormap.    In addition, for every other col-
  76.        ormap that is installed or uninstalled as a result of a
  77.        call to _X_U_n_i_n_s_t_a_l_l_C_o_l_o_r_m_a_p, the X server generates a _C_o_l_-
  78.        _o_r_m_a_p_N_o_t_i_f_y event on each window that has that colormap.
  79.  
  80.        _X_U_n_i_n_s_t_a_l_l_C_o_l_o_r_m_a_p can generate a _B_a_d_C_o_l_o_r error.
  81.  
  82.        The _X_L_i_s_t_I_n_s_t_a_l_l_e_d_C_o_l_o_r_m_a_p_s function returns a list of the
  83.        currently installed colormaps for the screen of the speci-
  84.        fied window.  The order of the colormaps in the list is
  85.        not significant and is no explicit indication of the
  86.        required list.  When the allocated list is no longer
  87.        needed, free it by using _X_F_r_e_e.
  88.  
  89.        _X_L_i_s_t_I_n_s_t_a_l_l_e_d_C_o_l_o_r_m_a_p_s can generate a _B_a_d_W_i_n_d_o_w error.
  90.  
  91. DDIIAAGGNNOOSSTTIICCSS
  92.        _B_a_d_C_o_l_o_r     A value for a Colormap argument does not name a
  93.          defined Colormap.
  94.  
  95.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  96.          defined Window.
  97.  
  98. SSEEEE AALLSSOO
  99.        XChangeWindowAtrributes(3X11), XCreateColormap(3X11),
  100.        XCreateWindow(3X11), XFree(3X11)
  101.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.