cairoImageSurfaceCreateForData     package:RGtk2     R Documentation

_c_a_i_r_o_I_m_a_g_e_S_u_r_f_a_c_e_C_r_e_a_t_e_F_o_r_D_a_t_a

_D_e_s_c_r_i_p_t_i_o_n:

     Creates an image surface for the provided pixel data. The output
     buffer must be kept around until the 'CairoSurface' is destroyed
     or 'cairoSurfaceFinish' is called on the surface.  The initial
     contents of 'buffer' will be used as the inital image contents;
     you must explicitely clear the buffer, using, for example,
     'cairoRectangle' and 'cairoFill' if you want it cleared.

_U_s_a_g_e:

     cairoImageSurfaceCreateForData(data, format, width, height, stride)

_A_r_g_u_m_e_n_t_s:

  'data': [char]  a pointer to a buffer supplied by the application in
          which to write contents.

'format': ['CairoFormat']  the format of pixels in the buffer

 'width': [integer]  the width of the image to be stored in the buffer

'height': [integer]  the height of the image to be stored in the buffer

'stride': [integer]  the number of bytes between the start of rows in
          the buffer. Having this be specified separate from 'width'
          allows for padding at the end of rows, or for writing to a
          subportion of a larger image.

_V_a_l_u_e:

     ['CairoSurface']  a pointer to the newly created surface. The
     caller owns the surface and should call cairo_surface_destroy when
     done with it.

     This function always returns a valid pointer, but it will return a
     pointer to a "nil" surface if an error such as out of memory
     occurs. You can use 'cairoSurfaceStatus' to check for this.

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

