~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gdk-pixbuf/html/gdk-pixbuf-refcounting.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2009-09-23 09:50:04 UTC
  • mfrom: (1.5.3 upstream)
  • mto: This revision was merged to the branch mainline in revision 129.
  • Revision ID: james.westby@ubuntu.com-20090923095004-e9xauadn4bjs5n7m
Tags: upstream-2.18.0
ImportĀ upstreamĀ versionĀ 2.18.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
71
71
    application can share a single pixbuf among many parts of the
72
72
    code.  When a piece of the program needs to keep a pointer to a
73
73
    pixbuf, it should add a reference to it by calling <a
74
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
 
74
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
75
75
><code class="function">g_object_ref()</code></a>.
76
76
    When it no longer needs the pixbuf, it should subtract a reference
77
77
    by calling <a
78
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"
 
78
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
79
79
><code class="function">g_object_unref()</code></a>.  The pixbuf will be destroyed when
80
80
    its reference count drops to zero.  Newly-created <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
81
81
    structures start with a reference count of one.
87
87
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
88
88
><span class="type">GObject</span></a> now, <a class="link" href="gdk-pixbuf-refcounting.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()"><code class="function">gdk_pixbuf_ref()</code></a> and
89
89
      <a class="link" href="gdk-pixbuf-refcounting.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()"><code class="function">gdk_pixbuf_unref()</code></a> are deprecated in favour of <a
90
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
 
90
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
91
91
><code class="function">g_object_ref()</code></a>
92
92
      and <a
93
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"
 
93
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
94
94
><code class="function">g_object_unref()</code></a> resp.
95
95
    </p>
96
96
</div>
117
117
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
118
118
<h3 class="title">Warning</h3>
119
119
<p><code class="literal">gdk_pixbuf_ref</code> is deprecated and should not be used in newly-written code. Use <a
120
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
 
120
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
121
121
><code class="function">g_object_ref()</code></a>.</p>
122
122
</div>
123
123
<p>
148
148
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
149
149
<h3 class="title">Warning</h3>
150
150
<p><code class="literal">gdk_pixbuf_unref</code> is deprecated and should not be used in newly-written code. Use <a
151
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"
 
151
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
152
152
><code class="function">g_object_unref()</code></a>.</p>
153
153
</div>
154
154
<p>