mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-26 05:31:07 +00:00
3aabcd2891
* gtk/gtklabel.c (gtk_label_new_with_mnemonic),
gtk/gtkbutton.c (gtk_button_new_with_mnemonic): More precise
documentation about underscores and mnemonics. (#66380)
* gtk/gtktextiter.c (gtk_text_iter_backward_word_starts): Fix
cyclic reference in docs.
* gtk/gtklabel.c (gtk_label_set_justify): Correct documentation
of default value. (#65402)
* gtk/gtkmain.c (gtk_set_locale, gtk_disable_set_locale):
Markup fixes.
* gdk-pixbuf-io.c, gdk-pixbuf-animation.c, gdk-pixbuf-data.c,
gdk-pixbuf-loader.c, gdk-pixbuf-scale.c, gdk-pixbuf-util.c,
gdk-pixdata.c: Markup fixes.
* gtk/text_widget.sgml: More precise wording. (#63388)
* gtk/tmpl/gtksignal.sgml (GTK_SIGNAL_OFFSET): Add docs.
* gtk/resources.sgml: Fix markup of mail URLs.
* gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkobject.sgml: Markup fixes.
* gtk/tmpl/gtktoolbar.sgml (gtk_toolbar_{prepend,append}_element):
Expand documentation. (#60471)
* gtk/tmpl/gtkmain.sgml: Remove misleading information about
gtk_set_locale(). (#65758)
786 lines
27 KiB
C
786 lines
27 KiB
C
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*- */
|
||
/* GdkPixbuf library - Simple animation support
|
||
*
|
||
* Copyright (C) 1999 The Free Software Foundation
|
||
*
|
||
* Authors: Jonathan Blandford <jrb@redhat.com>
|
||
* Havoc Pennington <hp@redhat.com>
|
||
*
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU Lesser General Public
|
||
* License as published by the Free Software Foundation; either
|
||
* version 2 of the License, or (at your option) any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public
|
||
* License along with this library; if not, write to the
|
||
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
||
* Boston, MA 02111-1307, USA.
|
||
*/
|
||
|
||
#include <config.h>
|
||
#include <errno.h>
|
||
#include "gdk-pixbuf-io.h"
|
||
#include "gdk-pixbuf-private.h"
|
||
|
||
typedef struct _GdkPixbufNonAnim GdkPixbufNonAnim;
|
||
typedef struct _GdkPixbufNonAnimClass GdkPixbufNonAnimClass;
|
||
|
||
#define GDK_TYPE_PIXBUF_NON_ANIM (gdk_pixbuf_non_anim_get_type ())
|
||
#define GDK_PIXBUF_NON_ANIM(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_PIXBUF_NON_ANIM, GdkPixbufNonAnim))
|
||
#define GDK_IS_PIXBUF_NON_ANIM(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_PIXBUF_NON_ANIM))
|
||
|
||
#define GDK_PIXBUF_NON_ANIM_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_PIXBUF_NON_ANIM, GdkPixbufNonAnimClass))
|
||
#define GDK_IS_PIXBUF_NON_ANIM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_PIXBUF_NON_ANIM))
|
||
#define GDK_PIXBUF_NON_ANIM_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_PIXBUF_NON_ANIM, GdkPixbufNonAnimClass))
|
||
|
||
/* Private part of the GdkPixbufNonAnim structure */
|
||
struct _GdkPixbufNonAnim {
|
||
GdkPixbufAnimation parent_instance;
|
||
|
||
GdkPixbuf *pixbuf;
|
||
};
|
||
|
||
struct _GdkPixbufNonAnimClass {
|
||
GdkPixbufAnimationClass parent_class;
|
||
|
||
};
|
||
|
||
static GType gdk_pixbuf_non_anim_get_type (void) G_GNUC_CONST;
|
||
|
||
|
||
|
||
typedef struct _GdkPixbufNonAnimIter GdkPixbufNonAnimIter;
|
||
typedef struct _GdkPixbufNonAnimIterClass GdkPixbufNonAnimIterClass;
|
||
|
||
|
||
#define GDK_TYPE_PIXBUF_NON_ANIM_ITER (gdk_pixbuf_non_anim_iter_get_type ())
|
||
#define GDK_PIXBUF_NON_ANIM_ITER(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_PIXBUF_NON_ANIM_ITER, GdkPixbufNonAnimIter))
|
||
#define GDK_IS_PIXBUF_NON_ANIM_ITER(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_PIXBUF_NON_ANIM_ITER))
|
||
|
||
#define GDK_PIXBUF_NON_ANIM_ITER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_PIXBUF_NON_ANIM_ITER, GdkPixbufNonAnimIterClass))
|
||
#define GDK_IS_PIXBUF_NON_ANIM_ITER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_PIXBUF_NON_ANIM_ITER))
|
||
#define GDK_PIXBUF_NON_ANIM_ITER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_PIXBUF_NON_ANIM_ITER, GdkPixbufNonAnimIterClass))
|
||
|
||
struct _GdkPixbufNonAnimIter {
|
||
GdkPixbufAnimationIter parent_instance;
|
||
|
||
GdkPixbufNonAnim *non_anim;
|
||
};
|
||
|
||
struct _GdkPixbufNonAnimIterClass {
|
||
GdkPixbufAnimationIterClass parent_class;
|
||
|
||
};
|
||
|
||
static GType gdk_pixbuf_non_anim_iter_get_type (void) G_GNUC_CONST;
|
||
|
||
|
||
|
||
GType
|
||
gdk_pixbuf_animation_get_type (void)
|
||
{
|
||
static GType object_type = 0;
|
||
|
||
if (!object_type) {
|
||
static const GTypeInfo object_info = {
|
||
sizeof (GdkPixbufAnimationClass),
|
||
(GBaseInitFunc) NULL,
|
||
(GBaseFinalizeFunc) NULL,
|
||
(GClassInitFunc) NULL,
|
||
NULL, /* class_finalize */
|
||
NULL, /* class_data */
|
||
sizeof (GdkPixbufAnimation),
|
||
0, /* n_preallocs */
|
||
(GInstanceInitFunc) NULL,
|
||
};
|
||
|
||
object_type = g_type_register_static (G_TYPE_OBJECT,
|
||
"GdkPixbufAnimation",
|
||
&object_info, 0);
|
||
}
|
||
|
||
return object_type;
|
||
}
|
||
|
||
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_new_from_file:
|
||
* @filename: Name of file to load.
|
||
* @error: return location for error
|
||
*
|
||
* Creates a new animation by loading it from a file. The file format is
|
||
* detected automatically. If the file's format does not support multi-frame
|
||
* images, then an animation with a single frame will be created. Possible errors
|
||
* are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains.
|
||
*
|
||
* Return value: A newly-created animation with a reference count of 1, or %NULL
|
||
* if any of several error conditions ocurred: the file could not be opened,
|
||
* there was no loader for the file's format, there was not enough memory to
|
||
* allocate the image buffer, or the image file contained invalid data.
|
||
**/
|
||
GdkPixbufAnimation *
|
||
gdk_pixbuf_animation_new_from_file (const char *filename,
|
||
GError **error)
|
||
{
|
||
GdkPixbufAnimation *animation;
|
||
int size;
|
||
FILE *f;
|
||
guchar buffer [128];
|
||
GdkPixbufModule *image_module;
|
||
|
||
g_return_val_if_fail (filename != NULL, NULL);
|
||
|
||
f = fopen (filename, "rb");
|
||
if (!f) {
|
||
g_set_error (error,
|
||
G_FILE_ERROR,
|
||
g_file_error_from_errno (errno),
|
||
_("Failed to open file '%s': %s"),
|
||
filename, g_strerror (errno));
|
||
return NULL;
|
||
}
|
||
|
||
size = fread (&buffer, 1, sizeof (buffer), f);
|
||
|
||
if (size == 0) {
|
||
g_set_error (error,
|
||
GDK_PIXBUF_ERROR,
|
||
GDK_PIXBUF_ERROR_CORRUPT_IMAGE,
|
||
_("Image file '%s' contains no data"),
|
||
filename);
|
||
|
||
fclose (f);
|
||
return NULL;
|
||
}
|
||
|
||
image_module = _gdk_pixbuf_get_module (buffer, size, filename, error);
|
||
if (!image_module) {
|
||
fclose (f);
|
||
return NULL;
|
||
}
|
||
|
||
if (image_module->module == NULL)
|
||
if (!_gdk_pixbuf_load_module (image_module, error)) {
|
||
fclose (f);
|
||
return NULL;
|
||
}
|
||
|
||
if (image_module->load_animation == NULL) {
|
||
GdkPixbuf *pixbuf;
|
||
|
||
/* Keep this logic in sync with gdk_pixbuf_new_from_file() */
|
||
|
||
if (image_module->load == NULL) {
|
||
g_set_error (error,
|
||
GDK_PIXBUF_ERROR,
|
||
GDK_PIXBUF_ERROR_UNSUPPORTED_OPERATION,
|
||
_("Don't know how to load the animation in file '%s'"),
|
||
filename);
|
||
fclose (f);
|
||
return NULL;
|
||
}
|
||
|
||
fseek (f, 0, SEEK_SET);
|
||
pixbuf = (* image_module->load) (f, error);
|
||
fclose (f);
|
||
|
||
if (pixbuf == NULL && error != NULL && *error == NULL) {
|
||
/* I don't trust these crufty longjmp()'ing image libs
|
||
* to maintain proper error invariants, and I don't
|
||
* want user code to segfault as a result. We need to maintain
|
||
* the invariant that error gets set if NULL is returned.
|
||
*/
|
||
|
||
g_warning ("Bug! gdk-pixbuf loader '%s' didn't set an error on failure.",
|
||
image_module->module_name);
|
||
g_set_error (error,
|
||
GDK_PIXBUF_ERROR,
|
||
GDK_PIXBUF_ERROR_FAILED,
|
||
_("Failed to load image '%s': reason not known, probably a corrupt image file"),
|
||
filename);
|
||
}
|
||
|
||
if (pixbuf == NULL)
|
||
return NULL;
|
||
|
||
animation = gdk_pixbuf_non_anim_new (pixbuf);
|
||
|
||
g_object_unref (pixbuf);
|
||
} else {
|
||
fseek (f, 0, SEEK_SET);
|
||
animation = (* image_module->load_animation) (f, error);
|
||
|
||
if (animation == NULL && error != NULL && *error == NULL) {
|
||
/* I don't trust these crufty longjmp()'ing
|
||
* image libs to maintain proper error
|
||
* invariants, and I don't want user code to
|
||
* segfault as a result. We need to maintain
|
||
* the invariant that error gets set if NULL
|
||
* is returned.
|
||
*/
|
||
|
||
g_warning ("Bug! gdk-pixbuf loader '%s' didn't set an error on failure.",
|
||
image_module->module_name);
|
||
g_set_error (error,
|
||
GDK_PIXBUF_ERROR,
|
||
GDK_PIXBUF_ERROR_FAILED,
|
||
_("Failed to load animation '%s': reason not known, probably a corrupt animation file"),
|
||
filename);
|
||
}
|
||
|
||
fclose (f);
|
||
}
|
||
|
||
return animation;
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_ref:
|
||
* @animation: An animation.
|
||
*
|
||
* Adds a reference to an animation. Deprecated; use
|
||
* g_object_ref(). The reference must be released afterwards using
|
||
* g_object_unref().
|
||
*
|
||
* Return value: The same as the @animation argument.
|
||
**/
|
||
GdkPixbufAnimation *
|
||
gdk_pixbuf_animation_ref (GdkPixbufAnimation *animation)
|
||
{
|
||
return (GdkPixbufAnimation*) g_object_ref (G_OBJECT (animation));
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_unref:
|
||
* @animation: An animation.
|
||
*
|
||
* Removes a reference from an animation. Deprecated; use g_object_unref().
|
||
**/
|
||
void
|
||
gdk_pixbuf_animation_unref (GdkPixbufAnimation *animation)
|
||
{
|
||
g_object_unref (G_OBJECT (animation));
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_is_static_image:
|
||
* @animation: a #GdkPixbufAnimation
|
||
*
|
||
* If you load a file with gdk_pixbuf_animation_new_from_file() and it turns
|
||
* out to be a plain, unanimated image, then this function will return
|
||
* %TRUE. Use gdk_pixbuf_animation_get_static_image() to retrieve
|
||
* the image.
|
||
*
|
||
* Return value: %TRUE if the "animation" was really just an image
|
||
**/
|
||
gboolean
|
||
gdk_pixbuf_animation_is_static_image (GdkPixbufAnimation *animation)
|
||
{
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION (animation), FALSE);
|
||
|
||
return GDK_PIXBUF_ANIMATION_GET_CLASS (animation)->is_static_image (animation);
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_get_static_image:
|
||
* @animation: a #GdkPixbufAnimation
|
||
*
|
||
* If an animation is really just a plain image (has only one frame),
|
||
* this function returns that image. If the animation is an animation,
|
||
* this function returns a reasonable thing to display as a static
|
||
* unanimated image, which might be the first frame, or something more
|
||
* sophisticated. If an animation hasn't loaded any frames yet, this
|
||
* function will return %NULL.
|
||
*
|
||
* Return value: unanimated image representing the animation
|
||
**/
|
||
GdkPixbuf*
|
||
gdk_pixbuf_animation_get_static_image (GdkPixbufAnimation *animation)
|
||
{
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION (animation), NULL);
|
||
|
||
return GDK_PIXBUF_ANIMATION_GET_CLASS (animation)->get_static_image (animation);
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_get_width:
|
||
* @animation: An animation.
|
||
*
|
||
* Queries the width of the bounding box of a pixbuf animation.
|
||
*
|
||
* Return value: Width of the bounding box of the animation.
|
||
**/
|
||
int
|
||
gdk_pixbuf_animation_get_width (GdkPixbufAnimation *animation)
|
||
{
|
||
int width;
|
||
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION (animation), 0);
|
||
|
||
width = 0;
|
||
GDK_PIXBUF_ANIMATION_GET_CLASS (animation)->get_size (animation,
|
||
&width, NULL);
|
||
|
||
|
||
return width;
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_get_height:
|
||
* @animation: An animation.
|
||
*
|
||
* Queries the height of the bounding box of a pixbuf animation.
|
||
*
|
||
* Return value: Height of the bounding box of the animation.
|
||
**/
|
||
int
|
||
gdk_pixbuf_animation_get_height (GdkPixbufAnimation *animation)
|
||
{
|
||
int height;
|
||
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION (animation), 0);
|
||
|
||
height = 0;
|
||
GDK_PIXBUF_ANIMATION_GET_CLASS (animation)->get_size (animation,
|
||
NULL, &height);
|
||
|
||
|
||
return height;
|
||
}
|
||
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_get_iter:
|
||
* @animation: a #GdkPixbufAnimation
|
||
* @start_time: time when the animation starts playing
|
||
*
|
||
* Get an iterator for displaying an animation. The iterator provides
|
||
* the frames that should be displayed at a given time.
|
||
* It should be freed after use with g_object_unref().
|
||
*
|
||
* @start_time would normally come from g_get_current_time(), and
|
||
* marks the beginning of animation playback. After creating an
|
||
* iterator, you should immediately display the pixbuf returned by
|
||
* gdk_pixbuf_animation_iter_get_pixbuf(). Then, you should install a
|
||
* timeout (with g_timeout_add()) or by some other mechanism ensure
|
||
* that you'll update the image after
|
||
* gdk_pixbuf_animation_iter_get_delay_time() milliseconds. Each time
|
||
* the image is updated, you should reinstall the timeout with the new,
|
||
* possibly-changed delay time.
|
||
*
|
||
* As a shortcut, if @start_time is %NULL, the result of
|
||
* g_get_current_time() will be used automatically.
|
||
*
|
||
* To update the image (i.e. possibly change the result of
|
||
* gdk_pixbuf_animation_iter_get_pixbuf() to a new frame of the animation),
|
||
* call gdk_pixbuf_animation_iter_advance().
|
||
*
|
||
* If you're using #GdkPixbufLoader, in addition to updating the image
|
||
* after the delay time, you should also update it whenever you
|
||
* receive the area_updated signal and
|
||
* gdk_pixbuf_animation_iter_on_currently_loading_frame() returns
|
||
* %TRUE. In this case, the frame currently being fed into the loader
|
||
* has received new data, so needs to be refreshed. The delay time for
|
||
* a frame may also be modified after an area_updated signal, for
|
||
* example if the delay time for a frame is encoded in the data after
|
||
* the frame itself. So your timeout should be reinstalled after any
|
||
* area_updated signal.
|
||
*
|
||
* A delay time of -1 is possible, indicating "infinite."
|
||
*
|
||
* Return value: an iterator to move over the animation
|
||
**/
|
||
GdkPixbufAnimationIter*
|
||
gdk_pixbuf_animation_get_iter (GdkPixbufAnimation *animation,
|
||
const GTimeVal *start_time)
|
||
{
|
||
GTimeVal val;
|
||
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION (animation), NULL);
|
||
|
||
|
||
if (start_time)
|
||
val = *start_time;
|
||
else
|
||
g_get_current_time (&val);
|
||
|
||
return GDK_PIXBUF_ANIMATION_GET_CLASS (animation)->get_iter (animation, &val);
|
||
}
|
||
|
||
|
||
|
||
GType
|
||
gdk_pixbuf_animation_iter_get_type (void)
|
||
{
|
||
static GType object_type = 0;
|
||
|
||
if (!object_type) {
|
||
static const GTypeInfo object_info = {
|
||
sizeof (GdkPixbufAnimationIterClass),
|
||
(GBaseInitFunc) NULL,
|
||
(GBaseFinalizeFunc) NULL,
|
||
(GClassInitFunc) NULL,
|
||
NULL, /* class_finalize */
|
||
NULL, /* class_data */
|
||
sizeof (GdkPixbufAnimationIter),
|
||
0, /* n_preallocs */
|
||
(GInstanceInitFunc) NULL,
|
||
};
|
||
|
||
object_type = g_type_register_static (G_TYPE_OBJECT,
|
||
"GdkPixbufAnimationIter",
|
||
&object_info, 0);
|
||
}
|
||
|
||
return object_type;
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_iter_get_delay_time:
|
||
* @iter: an animation iterator
|
||
*
|
||
* Gets the number of milliseconds the current pixbuf should be displayed,
|
||
* or -1 if the current pixbuf should be displayed forever. g_timeout_add()
|
||
* conveniently takes a timeout in milliseconds, so you can use a timeout
|
||
* to schedule the next update.
|
||
*
|
||
* Return value: delay time in milliseconds (thousandths of a second)
|
||
**/
|
||
int
|
||
gdk_pixbuf_animation_iter_get_delay_time (GdkPixbufAnimationIter *iter)
|
||
{
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION_ITER (iter), -1);
|
||
|
||
return GDK_PIXBUF_ANIMATION_ITER_GET_CLASS (iter)->get_delay_time (iter);
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_iter_get_pixbuf:
|
||
* @iter: an animation iterator
|
||
*
|
||
* Gets the current pixbuf which should be displayed; the pixbuf will
|
||
* be the same size as the animation itself
|
||
* (gdk_pixbuf_animation_get_width(),
|
||
* gdk_pixbuf_animation_get_height()). This pixbuf should be displayed
|
||
* for gdk_pixbuf_animation_get_delay_time() milliseconds. 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
|
||
* gdk_pixbuf_animation_iter_advance(). Copy the pixbuf to keep it
|
||
* (don't just add a reference), as it may get recycled as you advance
|
||
* the iterator.
|
||
*
|
||
* Return value: the pixbuf to be displayed
|
||
**/
|
||
GdkPixbuf*
|
||
gdk_pixbuf_animation_iter_get_pixbuf (GdkPixbufAnimationIter *iter)
|
||
{
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION_ITER (iter), NULL);
|
||
|
||
return GDK_PIXBUF_ANIMATION_ITER_GET_CLASS (iter)->get_pixbuf (iter);
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_iter_on_currently_loading_frame:
|
||
* @iter: a #GdkPixbufAnimationIter
|
||
*
|
||
* Used to determine how to respond to the area_updated signal on
|
||
* #GdkPixbufLoader when loading an animation. area_updated is emitted
|
||
* for an area of the frame currently streaming in to the loader. So if
|
||
* you're on the currently loading frame, you need to redraw the screen for
|
||
* the updated area.
|
||
*
|
||
* Return value: %TRUE if the frame we're on is partially loaded, or the last frame
|
||
**/
|
||
gboolean
|
||
gdk_pixbuf_animation_iter_on_currently_loading_frame (GdkPixbufAnimationIter *iter)
|
||
{
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION_ITER (iter), FALSE);
|
||
|
||
return GDK_PIXBUF_ANIMATION_ITER_GET_CLASS (iter)->on_currently_loading_frame (iter);
|
||
}
|
||
|
||
/**
|
||
* gdk_pixbuf_animation_iter_advance:
|
||
* @iter: a #GdkPixbufAnimationIter
|
||
* @current_time: current time
|
||
*
|
||
* Possibly advances an animation to a new frame. Chooses the frame based
|
||
* on the start time passed to gdk_pixbuf_animation_get_iter().
|
||
*
|
||
* @current_time would normally come from g_get_current_time(), and
|
||
* must be greater than or equal to the time passed to
|
||
* gdk_pixbuf_animation_get_iter(), and must increase or remain
|
||
* unchanged each time gdk_pixbuf_animation_iter_get_pixbuf() is
|
||
* called. That is, you can't go backward in time; animations only
|
||
* play forward.
|
||
*
|
||
* As a shortcut, pass %NULL for the current time and g_get_current_time()
|
||
* will be invoked on your behalf. So you only need to explicitly pass
|
||
* @current_time if you're doing something odd like playing the animation
|
||
* at double speed.
|
||
*
|
||
* If this function returns %FALSE, there's no need to update the animation
|
||
* display, assuming the display had been rendered prior to advancing;
|
||
* if %TRUE, you need to call gdk_animation_iter_get_pixbuf() and update the
|
||
* display with the new pixbuf.
|
||
*
|
||
* Returns: %TRUE if the image may need updating
|
||
*
|
||
**/
|
||
gboolean
|
||
gdk_pixbuf_animation_iter_advance (GdkPixbufAnimationIter *iter,
|
||
const GTimeVal *current_time)
|
||
{
|
||
GTimeVal val;
|
||
|
||
g_return_val_if_fail (GDK_IS_PIXBUF_ANIMATION_ITER (iter), FALSE);
|
||
|
||
if (current_time)
|
||
val = *current_time;
|
||
else
|
||
g_get_current_time (&val);
|
||
|
||
return GDK_PIXBUF_ANIMATION_ITER_GET_CLASS (iter)->advance (iter, &val);
|
||
}
|
||
|
||
|
||
|
||
static void gdk_pixbuf_non_anim_class_init (GdkPixbufNonAnimClass *klass);
|
||
static void gdk_pixbuf_non_anim_finalize (GObject *object);
|
||
|
||
static gboolean gdk_pixbuf_non_anim_is_static_image (GdkPixbufAnimation *animation);
|
||
static GdkPixbuf* gdk_pixbuf_non_anim_get_static_image (GdkPixbufAnimation *animation);
|
||
static void gdk_pixbuf_non_anim_get_size (GdkPixbufAnimation *anim,
|
||
int *width,
|
||
int *height);
|
||
static GdkPixbufAnimationIter* gdk_pixbuf_non_anim_get_iter (GdkPixbufAnimation *anim,
|
||
const GTimeVal *start_time);
|
||
|
||
|
||
|
||
|
||
|
||
static gpointer non_parent_class;
|
||
|
||
GType
|
||
gdk_pixbuf_non_anim_get_type (void)
|
||
{
|
||
static GType object_type = 0;
|
||
|
||
if (!object_type) {
|
||
static const GTypeInfo object_info = {
|
||
sizeof (GdkPixbufNonAnimClass),
|
||
(GBaseInitFunc) NULL,
|
||
(GBaseFinalizeFunc) NULL,
|
||
(GClassInitFunc) gdk_pixbuf_non_anim_class_init,
|
||
NULL, /* class_finalize */
|
||
NULL, /* class_data */
|
||
sizeof (GdkPixbufNonAnim),
|
||
0, /* n_preallocs */
|
||
(GInstanceInitFunc) NULL,
|
||
};
|
||
|
||
object_type = g_type_register_static (GDK_TYPE_PIXBUF_ANIMATION,
|
||
"GdkPixbufNonAnim",
|
||
&object_info, 0);
|
||
}
|
||
|
||
return object_type;
|
||
}
|
||
|
||
static void
|
||
gdk_pixbuf_non_anim_class_init (GdkPixbufNonAnimClass *klass)
|
||
{
|
||
GObjectClass *object_class = G_OBJECT_CLASS (klass);
|
||
GdkPixbufAnimationClass *anim_class = GDK_PIXBUF_ANIMATION_CLASS (klass);
|
||
|
||
non_parent_class = g_type_class_peek_parent (klass);
|
||
|
||
object_class->finalize = gdk_pixbuf_non_anim_finalize;
|
||
|
||
anim_class->is_static_image = gdk_pixbuf_non_anim_is_static_image;
|
||
anim_class->get_static_image = gdk_pixbuf_non_anim_get_static_image;
|
||
anim_class->get_size = gdk_pixbuf_non_anim_get_size;
|
||
anim_class->get_iter = gdk_pixbuf_non_anim_get_iter;
|
||
}
|
||
|
||
static void
|
||
gdk_pixbuf_non_anim_finalize (GObject *object)
|
||
{
|
||
GdkPixbufNonAnim *non_anim = GDK_PIXBUF_NON_ANIM (object);
|
||
|
||
if (non_anim->pixbuf)
|
||
g_object_unref (non_anim->pixbuf);
|
||
|
||
G_OBJECT_CLASS (non_parent_class)->finalize (object);
|
||
}
|
||
|
||
GdkPixbufAnimation*
|
||
gdk_pixbuf_non_anim_new (GdkPixbuf *pixbuf)
|
||
{
|
||
GdkPixbufNonAnim *non_anim;
|
||
|
||
non_anim = g_object_new (GDK_TYPE_PIXBUF_NON_ANIM, NULL);
|
||
|
||
non_anim->pixbuf = pixbuf;
|
||
|
||
if (pixbuf)
|
||
g_object_ref (pixbuf);
|
||
|
||
return GDK_PIXBUF_ANIMATION (non_anim);
|
||
}
|
||
|
||
static gboolean
|
||
gdk_pixbuf_non_anim_is_static_image (GdkPixbufAnimation *animation)
|
||
{
|
||
|
||
return TRUE;
|
||
}
|
||
|
||
static GdkPixbuf*
|
||
gdk_pixbuf_non_anim_get_static_image (GdkPixbufAnimation *animation)
|
||
{
|
||
GdkPixbufNonAnim *non_anim;
|
||
|
||
non_anim = GDK_PIXBUF_NON_ANIM (animation);
|
||
|
||
return non_anim->pixbuf;
|
||
}
|
||
|
||
static void
|
||
gdk_pixbuf_non_anim_get_size (GdkPixbufAnimation *anim,
|
||
int *width,
|
||
int *height)
|
||
{
|
||
GdkPixbufNonAnim *non_anim;
|
||
|
||
non_anim = GDK_PIXBUF_NON_ANIM (anim);
|
||
|
||
if (width)
|
||
*width = gdk_pixbuf_get_width (non_anim->pixbuf);
|
||
|
||
if (height)
|
||
*height = gdk_pixbuf_get_height (non_anim->pixbuf);
|
||
}
|
||
|
||
|
||
static GdkPixbufAnimationIter*
|
||
gdk_pixbuf_non_anim_get_iter (GdkPixbufAnimation *anim,
|
||
const GTimeVal *start_time)
|
||
{
|
||
GdkPixbufNonAnimIter *iter;
|
||
|
||
iter = g_object_new (GDK_TYPE_PIXBUF_NON_ANIM_ITER, NULL);
|
||
|
||
iter->non_anim = GDK_PIXBUF_NON_ANIM (anim);
|
||
|
||
g_object_ref (iter->non_anim);
|
||
|
||
return GDK_PIXBUF_ANIMATION_ITER (iter);
|
||
}
|
||
|
||
|
||
|
||
static void gdk_pixbuf_non_anim_iter_class_init (GdkPixbufNonAnimIterClass *klass);
|
||
static void gdk_pixbuf_non_anim_iter_finalize (GObject *object);
|
||
static int gdk_pixbuf_non_anim_iter_get_delay_time (GdkPixbufAnimationIter *iter);
|
||
static GdkPixbuf* gdk_pixbuf_non_anim_iter_get_pixbuf (GdkPixbufAnimationIter *iter);
|
||
static gboolean gdk_pixbuf_non_anim_iter_on_currently_loading_frame (GdkPixbufAnimationIter *iter);
|
||
static gboolean gdk_pixbuf_non_anim_iter_advance (GdkPixbufAnimationIter *iter,
|
||
const GTimeVal *current_time);
|
||
|
||
|
||
|
||
|
||
|
||
static gpointer non_iter_parent_class;
|
||
|
||
GType
|
||
gdk_pixbuf_non_anim_iter_get_type (void)
|
||
{
|
||
static GType object_type = 0;
|
||
|
||
if (!object_type) {
|
||
static const GTypeInfo object_info = {
|
||
sizeof (GdkPixbufNonAnimIterClass),
|
||
(GBaseInitFunc) NULL,
|
||
(GBaseFinalizeFunc) NULL,
|
||
(GClassInitFunc) gdk_pixbuf_non_anim_iter_class_init,
|
||
NULL, /* class_finalize */
|
||
NULL, /* class_data */
|
||
sizeof (GdkPixbufNonAnimIter),
|
||
0, /* n_preallocs */
|
||
(GInstanceInitFunc) NULL,
|
||
};
|
||
|
||
object_type = g_type_register_static (GDK_TYPE_PIXBUF_ANIMATION_ITER,
|
||
"GdkPixbufNonAnimIter",
|
||
&object_info, 0);
|
||
}
|
||
|
||
return object_type;
|
||
}
|
||
|
||
static void
|
||
gdk_pixbuf_non_anim_iter_class_init (GdkPixbufNonAnimIterClass *klass)
|
||
{
|
||
GObjectClass *object_class = G_OBJECT_CLASS (klass);
|
||
GdkPixbufAnimationIterClass *anim_iter_class =
|
||
GDK_PIXBUF_ANIMATION_ITER_CLASS (klass);
|
||
|
||
non_iter_parent_class = g_type_class_peek_parent (klass);
|
||
|
||
object_class->finalize = gdk_pixbuf_non_anim_iter_finalize;
|
||
|
||
anim_iter_class->get_delay_time = gdk_pixbuf_non_anim_iter_get_delay_time;
|
||
anim_iter_class->get_pixbuf = gdk_pixbuf_non_anim_iter_get_pixbuf;
|
||
anim_iter_class->on_currently_loading_frame = gdk_pixbuf_non_anim_iter_on_currently_loading_frame;
|
||
anim_iter_class->advance = gdk_pixbuf_non_anim_iter_advance;
|
||
}
|
||
|
||
static void
|
||
gdk_pixbuf_non_anim_iter_finalize (GObject *object)
|
||
{
|
||
GdkPixbufNonAnimIter *iter = GDK_PIXBUF_NON_ANIM_ITER (object);
|
||
|
||
g_object_unref (iter->non_anim);
|
||
|
||
G_OBJECT_CLASS (non_iter_parent_class)->finalize (object);
|
||
}
|
||
|
||
static int
|
||
gdk_pixbuf_non_anim_iter_get_delay_time (GdkPixbufAnimationIter *iter)
|
||
{
|
||
return -1; /* show only frame forever */
|
||
}
|
||
|
||
static GdkPixbuf*
|
||
gdk_pixbuf_non_anim_iter_get_pixbuf (GdkPixbufAnimationIter *iter)
|
||
{
|
||
return GDK_PIXBUF_NON_ANIM_ITER (iter)->non_anim->pixbuf;
|
||
}
|
||
|
||
|
||
static gboolean
|
||
gdk_pixbuf_non_anim_iter_on_currently_loading_frame (GdkPixbufAnimationIter *iter)
|
||
{
|
||
return TRUE;
|
||
}
|
||
|
||
static gboolean
|
||
gdk_pixbuf_non_anim_iter_advance (GdkPixbufAnimationIter *iter,
|
||
const GTimeVal *current_time)
|
||
{
|
||
|
||
/* Advancing never requires a refresh */
|
||
return FALSE;
|
||
}
|
||
|