home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xcreatepixmap.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XCreatePixmap(3X11)      XLIB FUNCTIONS      XCreatePixmap(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XCreatePixmap, XFreePixmap - create or destroy pixmaps
  9.  
  10. SSYYNNTTAAXX
  11.        Pixmap XCreatePixmap(_d_i_s_p_l_a_y, _d, _w_i_d_t_h, _h_e_i_g_h_t, _d_e_p_t_h)
  12.          Display *_d_i_s_p_l_a_y;
  13.          Drawable _d;
  14.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  15.          unsigned int _d_e_p_t_h;
  16.  
  17.        XFreePixmap(_d_i_s_p_l_a_y, _p_i_x_m_a_p)
  18.          Display *_d_i_s_p_l_a_y;
  19.          Pixmap _p_i_x_m_a_p;
  20.  
  21. AARRGGUUMMEENNTTSS
  22.        _d     Specifies which screen the pixmap is created on.
  23.  
  24.        _d_e_p_t_h     Specifies the depth of the pixmap.
  25.  
  26.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  27.  
  28.        _p_i_x_m_a_p     Specifies the pixmap.
  29.  
  30.        _w_i_d_t_h
  31.        _h_e_i_g_h_t     Specify the width and height, which define the
  32.          dimensions of the pixmap.
  33.  
  34. DDEESSCCRRIIPPTTIIOONN
  35.        The _X_C_r_e_a_t_e_P_i_x_m_a_p function creates a pixmap of the width,
  36.        height, and depth you specified and returns a pixmap ID
  37.        that identifies it.  It is valid to pass an _I_n_p_u_t_O_n_l_y win-
  38.        dow to the drawable argument.  The width and height argu-
  39.        ments must be nonzero, or a _B_a_d_V_a_l_u_e error results.  The
  40.        depth argument must be one of the depths supported by the
  41.        screen of the specified drawable, or a _B_a_d_V_a_l_u_e error
  42.        results.
  43.  
  44.        The server uses the specified drawable to determine on
  45.        which screen to create the pixmap.  The pixmap can be used
  46.        only on this screen and only with other drawables of the
  47.        same depth (see _X_C_o_p_y_P_l_a_n_e for an exception to this rule).
  48.        The initial contents of the pixmap are undefined.
  49.  
  50.        _X_C_r_e_a_t_e_P_i_x_m_a_p can generate _B_a_d_A_l_l_o_c, _B_a_d_D_r_a_w_a_b_l_e, and _B_a_d_-
  51.        _V_a_l_u_e errors.
  52.  
  53.        The _X_F_r_e_e_P_i_x_m_a_p function first deletes the association
  54.        between the pixmap ID and the pixmap.  Then, the X server
  55.        frees the pixmap storage when there are no references to
  56.        it.  The pixmap should never be referenced again.
  57.  
  58.        _X_F_r_e_e_P_i_x_m_a_p can generate a _B_a_d_P_i_x_m_a_p error.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XCreatePixmap(3X11)      XLIB FUNCTIONS      XCreatePixmap(3X11)
  71.  
  72.  
  73. DDIIAAGGNNOOSSTTIICCSS
  74.        _B_a_d_A_l_l_o_c     The server failed to allocate the requested
  75.          resource or server memory.
  76.  
  77.        _B_a_d_D_r_a_w_a_b_l_e
  78.          A value for a Drawable argument does not name a
  79.          defined Window or Pixmap.
  80.  
  81.        _B_a_d_P_i_x_m_a_p A value for a Pixmap argument does not name a
  82.          defined Pixmap.
  83.  
  84.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  85.          values accepted by the request.  Unless a spe-
  86.          cific range is specified for an argument, the
  87.          full range defined by the argument's type is
  88.          accepted.  Any argument defined as a set of
  89.          alternatives can generate this error.
  90.  
  91. SSEEEE AALLSSOO
  92.        XCopyArea(3X11)
  93.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.