summaryrefslogtreecommitdiff
path: root/docs/reference/gdk-pixbuf/tmpl/creating.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/gdk-pixbuf/tmpl/creating.sgml')
-rw-r--r--docs/reference/gdk-pixbuf/tmpl/creating.sgml64
1 files changed, 34 insertions, 30 deletions
diff --git a/docs/reference/gdk-pixbuf/tmpl/creating.sgml b/docs/reference/gdk-pixbuf/tmpl/creating.sgml
index 3c06008c9..c8c3f7581 100644
--- a/docs/reference/gdk-pixbuf/tmpl/creating.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/creating.sgml
@@ -6,21 +6,15 @@ Creating a pixbuf from image data that is already in memory.
<!-- ##### SECTION Long_Description ##### -->
<para>
- The most basic way to create a pixbuf is to wrap an existing
- #ArtPixBuf structure with a #GdkPixbuf to add reference counting
- capabilities to it. The gdk_pixbuf_new_from_art_pixbuf() performs
- this operation.
- </para>
-
- <para>
- As a convenience, you can use the gdk_pixbuf_new_from_data()
- function to wrap an existing data buffer with a #GdkPixbuf. You
- need to specify the destroy notification function that will be
- called when the data buffer needs to be freed; this will happen
- when the pixbuf's reference count drops to zero and thus the
- #ArtPixBuf needs to be destroyed. If you have a chunk of static
- data compiled into your application, you can pass in #NULL as the
- destroy notification function so that the data will not be freed.
+ The most basic way to create a pixbuf is to wrap an existing pixel
+ buffer with a #GdkPixbuf structure. You can use the
+ gdk_pixbuf_new_from_data() function to do this You need to specify
+ the destroy notification function that will be called when the
+ data buffer needs to be freed; this will happen when a #GdkPixbuf
+ is finalized by the reference counting functions If you have a
+ chunk of static data compiled into your application, you can pass
+ in #NULL as the destroy notification function so that the data
+ will not be freed.
</para>
<para>
@@ -37,26 +31,24 @@ Creating a pixbuf from image data that is already in memory.
function to create a pixbuf from inline XPM image data.
</para>
-<!-- ##### SECTION See_Also ##### -->
<para>
- #ArtPixBuf
+ You can also copy an existing pixbuf with the gdk_pixbuf_copy()
+ function. This is not the same as just doing a gdk_pixbuf_ref()
+ on the old pixbuf; the copy function will actually duplicate the
+ pixel data in memory and create a new #GdkPixbuf structure for it.
</para>
-<!-- ##### FUNCTION gdk_pixbuf_new_from_art_pixbuf ##### -->
-<para>
-
-</para>
-
-@art_pixbuf:
-@Returns:
-
+<!-- ##### SECTION See_Also ##### -->
+ <para>
+ gdk_pixbuf_finalize().
+ </para>
<!-- ##### FUNCTION gdk_pixbuf_new ##### -->
<para>
</para>
-@format:
+@colorspace:
@has_alpha:
@bits_per_sample:
@width:
@@ -70,13 +62,14 @@ Creating a pixbuf from image data that is already in memory.
</para>
@data:
-@format:
+@colorspace:
@has_alpha:
+@bits_per_sample:
@width:
@height:
@rowstride:
-@dfunc:
-@dfunc_data:
+@destroy_fn:
+@destroy_fn_data:
@Returns:
@@ -86,7 +79,18 @@ Creating a pixbuf from image data that is already in memory.
</para>
@data:
-@Returns: <!--
+@Returns:
+
+
+<!-- ##### FUNCTION gdk_pixbuf_copy ##### -->
+<para>
+
+</para>
+
+@pixbuf:
+@Returns:
+
+<!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")