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 / XCreatePixmap.z / XCreatePixmap
Encoding:
Text File  |  1998-10-30  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXCCCCrrrreeeeaaaatttteeeePPPPiiiixxxxmmmmaaaapppp((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXCCCCrrrreeeeaaaatttteeeePPPPiiiixxxxmmmmaaaapppp((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XCreatePixmap, XFreePixmap - create or destroy pixmaps
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           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)
  13.                 Display *_d_i_s_p_l_a_y;
  14.                 Drawable _d;
  15.                 unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  16.                 unsigned int _d_e_p_t_h;
  17.  
  18.           XFreePixmap(_d_i_s_p_l_a_y, _p_i_x_m_a_p)
  19.                 Display *_d_i_s_p_l_a_y;
  20.                 Pixmap _p_i_x_m_a_p;
  21.  
  22.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  23.           _d         Specifies which screen the pixmap is created on.
  24.  
  25.           _d_e_p_t_h     Specifies the depth of the pixmap.
  26.  
  27.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  28.  
  29.           _p_i_x_m_a_p    Specifies the pixmap.
  30.  
  31.           _w_i_d_t_h
  32.           _h_e_i_g_h_t    Specify the width and height, which define the
  33.                     dimensions of the pixmap.
  34.  
  35.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  36.           The _X_C_r_e_a_t_e_P_i_x_m_a_p function creates a pixmap of the width,
  37.           height, and depth you specified and returns a pixmap ID that
  38.           identifies it.  It is valid to pass an _I_n_p_u_t_O_n_l_y window to
  39.           the drawable argument.  The width and height arguments must
  40.           be nonzero, or a _B_a_d_V_a_l_u_e error results.  The depth argument
  41.           must be one of the depths supported by the screen of the
  42.           specified drawable, or a _B_a_d_V_a_l_u_e error results.
  43.  
  44.           The server uses the specified drawable to determine on which
  45.           screen to create the pixmap.  The pixmap can be used only on
  46.           this screen and only with other drawables of the same depth
  47.           (see _X_C_o_p_y_P_l_a_n_e for an exception to this rule).  The initial
  48.           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
  51.           _B_a_d_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 it.
  56.           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.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXCCCCrrrreeeeaaaatttteeeePPPPiiiixxxxmmmmaaaapppp((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXCCCCrrrreeeeaaaatttteeeePPPPiiiixxxxmmmmaaaapppp((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.           _B_a_d_A_l_l_o_c  The server failed to allocate the requested
  76.                     resource or server memory.
  77.  
  78.           _B_a_d_D_r_a_w_a_b_l_e
  79.                     A value for a Drawable argument does not name a
  80.                     defined Window or Pixmap.
  81.  
  82.           _B_a_d_P_i_x_m_a_p A value for a Pixmap argument does not name a
  83.                     defined Pixmap.
  84.  
  85.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  86.                     values accepted by the request.  Unless a specific
  87.                     range is specified for an argument, the full range
  88.                     defined by the argument's type is accepted.  Any
  89.                     argument defined as a set of alternatives can
  90.                     generate this error.
  91.  
  92.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.           XCopyArea(3X11)
  94.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.