Pileus Git - ~andy/gtk/blob - docs/reference/gdk-pixbuf/tmpl/file-saving.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 File saving
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Saving a pixbuf to a file.
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 These functions allow to save a #GdkPixbuf in a number of
  10 file formats. The formatted data can be written to a file
  11 or to a memory buffer. &gdk-pixbuf; can also call a user-defined
  12 callback on the data, which allows to e.g. write the image
  13 to a socket or store it in a database.
  14 </para>
  15
  16 <!-- ##### SECTION See_Also ##### -->
  17 <para>
  18
  19 </para>
  20
  21 <!-- ##### SECTION Stability_Level ##### -->
  22
  23
  24 <!-- ##### FUNCTION gdk_pixbuf_savev ##### -->
  25 <para>
  26
  27 </para>
  28
  29 @pixbuf:
  30 @filename:
  31 @type:
  32 @option_keys:
  33 @option_values:
  34 @error:
  35 @Returns:
  36
  37
  38 <!-- ##### FUNCTION gdk_pixbuf_save ##### -->
  39 <para>
  40
  41 </para>
  42
  43 @pixbuf:
  44 @filename:
  45 @type:
  46 @error:
  47 @Varargs:
  48 @Returns:
  49
  50
  51 <!-- ##### USER_FUNCTION GdkPixbufSaveFunc ##### -->
  52 <para>
  53 Specifies the type of the function passed to
  54 gdk_pixbuf_save_to_callback().  It is called once for each block of
  55 bytes that is "written" by gdk_pixbuf_save_to_callback().  If
  56 successful it should return %TRUE.  If an error occurs it should set
  57 @error and return %FALSE, in which case gdk_pixbuf_save_to_callback()
  58 will fail with the same error.
  59 </para>
  60
  61 @buf: bytes to be written.
  62 @count: number of bytes in @buf.
  63 @error: A location to return an error.
  64 @data: user data passed to gdk_pixbuf_save_to_callback().
  65 @Returns: %TRUE if successful, %FALSE (with @error set) if failed.
  66 @Since: 2.4
  67
  68
  69 <!-- ##### FUNCTION gdk_pixbuf_save_to_callback ##### -->
  70 <para>
  71
  72 </para>
  73
  74 @pixbuf:
  75 @save_func:
  76 @user_data:
  77 @type:
  78 @error:
  79 @Varargs:
  80 @Returns:
  81
  82
  83 <!-- ##### FUNCTION gdk_pixbuf_save_to_callbackv ##### -->
  84 <para>
  85
  86 </para>
  87
  88 @pixbuf:
  89 @save_func:
  90 @user_data:
  91 @type:
  92 @option_keys:
  93 @option_values:
  94 @error:
  95 @Returns:
  96
  97
  98 <!-- ##### FUNCTION gdk_pixbuf_save_to_buffer ##### -->
  99 <para>
 100
 101 </para>
 102
 103 @pixbuf:
 104 @buffer:
 105 @buffer_size:
 106 @type:
 107 @error:
 108 @Varargs:
 109 @Returns:
 110
 111
 112 <!-- ##### FUNCTION gdk_pixbuf_save_to_bufferv ##### -->
 113 <para>
 114
 115 </para>
 116
 117 @pixbuf:
 118 @buffer:
 119 @buffer_size:
 120 @type:
 121 @option_keys:
 122 @option_values:
 123 @error:
 124 @Returns:
 125
 126
 127 <!-- ##### FUNCTION gdk_pixbuf_save_to_stream ##### -->
 128 <para>
 129
 130 </para>
 131
 132 @pixbuf:
 133 @stream:
 134 @type:
 135 @cancellable:
 136 @error:
 137 @Varargs:
 138 @Returns:
 139
 140