~ubuntu-branches/ubuntu/precise/gdk-pixbuf/precise

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new" title="gdk_pixbuf_new ()">gdk_pixbuf_new</a> (<code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace">GdkColorspace</a> colorspace</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> has_alpha</code>,

<code>gboolean has_alpha</code>,

<code>int bits_per_sample</code>,

<code>int width</code>,

<code>int height</code>);

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()">gdk_pixbuf_new_from_data</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar">guchar</a> *data</code>,

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()">gdk_pixbuf_new_from_data</a> (<code>const guchar *data</code>,

<code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace">GdkColorspace</a> colorspace</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> has_alpha</code>,

<code>gboolean has_alpha</code>,

<code>int bits_per_sample</code>,

<code>int width</code>,

<code>int height</code>,

<code>int rowstride</code>,

<code><a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()">GdkPixbufDestroyNotify</a> destroy_fn</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> destroy_fn_data</code>);

<code>gpointer destroy_fn_data</code>);

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-xpm-data" title="gdk_pixbuf_new_from_xpm_data ()">gdk_pixbuf_new_from_xpm_data</a> (<code>const char **data</code>);

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline" title="gdk_pixbuf_new_from_inline ()">gdk_pixbuf_new_from_inline</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> data_length</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8">guint8</a> *data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> copy_pixels</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline" title="gdk_pixbuf_new_from_inline ()">gdk_pixbuf_new_from_inline</a> (<code>gint data_length</code>,

<code>const guint8 *data</code>,

<code>gboolean copy_pixels</code>,

<code>GError **error</code>);

<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()">gdk_pixbuf_new_subpixbuf</a> (<code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> *src_pixbuf</code>,

<code>int src_x</code>,

<code>int src_y</code>,

data buffer needs to be freed; this will happen when a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a>

is finalized by the reference counting functions If you have a

chunk of static data compiled into your application, you can pass

in <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as the destroy notification function so that the data

in <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> as the destroy notification function so that the data

will not be freed.

You can also copy an existing pixbuf with the <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy" title="gdk_pixbuf_copy ()"><code class="function">gdk_pixbuf_copy()</code></a>

function. This is not the same as just doing a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>

function. This is not the same as just doing a <code class="function">g_object_ref()</code>

on the old pixbuf; the copy function will actually duplicate the

pixel data in memory and create a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> structure for it.

100

104

105

<a name="gdk-pixbuf-new"></a><h3>gdk_pixbuf_new ()</h3>

106

<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gdk_pixbuf_new (<code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace">GdkColorspace</a> colorspace</code>,

107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> has_alpha</code>,

107

<code>gboolean has_alpha</code>,

108

<code>int bits_per_sample</code>,

109

<code>int width</code>,

110

<code>int height</code>);</pre>

139

<tr>

140

<td>Returns :</td>

141

<td>A newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> with a reference count of 1, or

142

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be allocated for the image buffer.</td>

142

<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if not enough memory could be allocated for the image buffer.</td>

143

</tr>

144

</tbody>

145

</table></div>

147

<hr>

148

149

<a name="gdk-pixbuf-new-from-data"></a><h3>gdk_pixbuf_new_from_data ()</h3>

150

<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gdk_pixbuf_new_from_data (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar">guchar</a> *data</code>,

150

<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gdk_pixbuf_new_from_data (<code>const guchar *data</code>,

151

<code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace">GdkColorspace</a> colorspace</code>,

152

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> has_alpha</code>,

152

<code>gboolean has_alpha</code>,

153

<code>int bits_per_sample</code>,

154

<code>int width</code>,

155

<code>int height</code>,

156

<code>int rowstride</code>,

157

158

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> destroy_fn_data</code>);</pre>

158

<code>gpointer destroy_fn_data</code>);</pre>

159

160

Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> out of in-memory image data. Currently only RGB

161

images with 8 bits per sample are supported.

195

<tr>

196

<td><code>destroy_fn</code> :</td>

197

<td>Function used to free the data when the pixbuf's reference count

198

drops to zero, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the data should not be freed. [<acronym title="The callback is valid until first called.">scope async</acronym>]

198

drops to zero, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if the data should not be freed. [<acronym title="The callback is valid until first called.">scope async</acronym>]

199

</td>

200

</tr>

201

<tr>

236

<hr>

237

238

<a name="gdk-pixbuf-new-from-inline"></a><h3>gdk_pixbuf_new_from_inline ()</h3>

239

<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gdk_pixbuf_new_from_inline (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> data_length</code>,

240

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8">guint8</a> *data</code>,

241

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> copy_pixels</code>,

242

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

239

<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> * gdk_pixbuf_new_from_inline (<code>gint data_length</code>,

240

<code>const guint8 *data</code>,

241

<code>gboolean copy_pixels</code>,

242

<code>GError **error</code>);</pre>

243

244

Create a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> from a flat representation that is suitable for

245

storing as inline data in a program. This is useful if you want to

270

271

For the typical case where the inline pixbuf is read-only static data,

272

you don't need to copy the pixel data unless you intend to write to

273

it, so you can pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for <code>copy_pixels</code>. (If you pass

273

it, so you can pass <code class="literal">FALSE</code> for <code>copy_pixels</code>. (If you pass

274

<code class="option">--rle</code> to gdk-pixbuf-csource, a copy

275

will be made even if <code>copy_pixels</code> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, so using this option is

275

will be made even if <code>copy_pixels</code> is <code class="literal">FALSE</code>, so using this option is

276

generally a bad idea.)

277

278

285

<tbody>

286

<tr>

287

288

<td class="listing_code"><pre class="programlisting">pixbuf = <a href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline">gdk_pixbuf_new_from_inline</a> (-1, myimage_inline, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);</pre></td>

288

<td class="listing_code"><pre class="programlisting">pixbuf = <a href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline">gdk_pixbuf_new_from_inline</a> (-1, myimage_inline, FALSE, <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a>);</pre></td>

289

</tr>

290

</tbody>

291

</table>

318

<tr>

319

<td><code>error</code> :</td>

320

<td>

321

<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> return location, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors</td>

321

GError return location, may be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to ignore errors</td>

322

</tr>

323

<tr>

324

<td>Returns :</td>

325

<td>A newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> structure with a reference,

326

count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred.</td>

326

count of 1, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if an error occurred.</td>

327

</tr>

328

</tbody>

329

</table></div>

397

</tr>

398

<tr>

399

<td>Returns :</td>

400

<td>A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

400

<td>A newly-created pixbuf with a reference count of 1, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if

401

not enough memory could be allocated. [<acronym title="Free data after the code is done.">transfer full</acronym>]

402

</td>

403

</tr>

Older »