gdk-pixbuf:pixbuf-animation-iter-pixbuf (iter)

iter -- a gdk-pixbuf:pixbuf-animation-iter iterator

The gdk-pixbuf:pixbuf object to be displayed.

Gets the current pixbuf which should be displayed. The pixbuf might not be the same size as the animation itself which can be get with the gdk-pixbuf:pixbuf-animation-width and the gdk-pixbuf:pixbuf-animation-height functions. This pixbuf should be displayed for a delay time equal to the return value of the gdk-pixbuf:pixbuf-animation-iter-delay-time function.

The caller of this function does not own a reference to the returned pixbuf. The returned pixbuf will become invalid when the iterator advances to the next frame, which may happen anytime you call the gdk-pixbuf:pixbuf-animation-iter-advance function. Copy the pixbuf to keep it, do not just add a reference, as it may get recycled as you advance the iterator.