gdk-pixbuf-animation.h 9.46 KB
Newer Older
1
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*- */
2
/* GdkPixbuf library - Animation support
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
 *
 * Copyright (C) 1999 The Free Software Foundation
 *
 * Authors: Mark Crichton <crichton@gimp.org>
 *          Miguel de Icaza <miguel@gnu.org>
 *          Federico Mena-Quintero <federico@gimp.org>
 *          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
22
 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
23
24
 */

25
26
27
#ifndef GDK_PIXBUF_ANIMATION_H
#define GDK_PIXBUF_ANIMATION_H

Matthias Clasen's avatar
Matthias Clasen committed
28
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
29
30
31
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif

32
33
#include <glib-object.h>
#include <gdk-pixbuf/gdk-pixbuf-core.h>
34
35
36

G_BEGIN_DECLS

37
38
39
/* Animation support */

typedef struct _GdkPixbufAnimation GdkPixbufAnimation;
40
41


42
43
44
45
46
47
48
49
50
51
typedef struct _GdkPixbufAnimationIter GdkPixbufAnimationIter;

#define GDK_TYPE_PIXBUF_ANIMATION              (gdk_pixbuf_animation_get_type ())
#define GDK_PIXBUF_ANIMATION(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_PIXBUF_ANIMATION, GdkPixbufAnimation))
#define GDK_IS_PIXBUF_ANIMATION(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_PIXBUF_ANIMATION))

#define GDK_TYPE_PIXBUF_ANIMATION_ITER              (gdk_pixbuf_animation_iter_get_type ())
#define GDK_PIXBUF_ANIMATION_ITER(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_PIXBUF_ANIMATION_ITER, GdkPixbufAnimationIter))
#define GDK_IS_PIXBUF_ANIMATION_ITER(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_PIXBUF_ANIMATION_ITER))

Chun-wei Fan's avatar
Chun-wei Fan committed
52
GDK_PIXBUF_AVAILABLE_IN_ALL
53
54
GType               gdk_pixbuf_animation_get_type        (void) G_GNUC_CONST;

55
#ifdef G_OS_WIN32
56
57
58
59
/* API/ABI compat, see gdk-pixbuf-core.h for details */
GDK_PIXBUF_AVAILABLE_IN_ALL
GdkPixbufAnimation *gdk_pixbuf_animation_new_from_file_utf8   (const char         *filename,
                                                               GError            **error);
60
#endif
61

Chun-wei Fan's avatar
Chun-wei Fan committed
62
GDK_PIXBUF_AVAILABLE_IN_ALL
63
64
GdkPixbufAnimation *gdk_pixbuf_animation_new_from_file   (const char         *filename,
                                                          GError            **error);
Chun-wei Fan's avatar
Chun-wei Fan committed
65
GDK_PIXBUF_AVAILABLE_IN_2_28
66
67
68
GdkPixbufAnimation *gdk_pixbuf_animation_new_from_stream (GInputStream       *stream,
                                                          GCancellable       *cancellable,
                                                          GError            **error);
Chun-wei Fan's avatar
Chun-wei Fan committed
69
GDK_PIXBUF_AVAILABLE_IN_2_28
70
71
72
73
void                gdk_pixbuf_animation_new_from_stream_async (GInputStream *stream,
                                                          GCancellable       *cancellable,
                                                          GAsyncReadyCallback callback,
                                                          gpointer            user_data);
Chun-wei Fan's avatar
Chun-wei Fan committed
74
GDK_PIXBUF_AVAILABLE_IN_2_28
75
76
GdkPixbufAnimation *gdk_pixbuf_animation_new_from_stream_finish (GAsyncResult*async_result,
                                                          GError            **error);
Chun-wei Fan's avatar
Chun-wei Fan committed
77
GDK_PIXBUF_AVAILABLE_IN_2_28
78
79
GdkPixbufAnimation *gdk_pixbuf_animation_new_from_resource(const char        *resource_path,
                                                          GError            **error);
80

Matthias Clasen's avatar
Matthias Clasen committed
81
#ifndef GDK_PIXBUF_DISABLE_DEPRECATED
Chun-wei Fan's avatar
Chun-wei Fan committed
82
83

GDK_PIXBUF_DEPRECATED_IN_2_0_FOR(g_object_ref)
Matthias Clasen's avatar
Matthias Clasen committed
84
GdkPixbufAnimation *gdk_pixbuf_animation_ref             (GdkPixbufAnimation *animation);
Chun-wei Fan's avatar
Chun-wei Fan committed
85
GDK_PIXBUF_DEPRECATED_IN_2_0_FOR(g_object_unref)
Matthias Clasen's avatar
Matthias Clasen committed
86
87
88
void                gdk_pixbuf_animation_unref           (GdkPixbufAnimation *animation);
#endif

Chun-wei Fan's avatar
Chun-wei Fan committed
89
GDK_PIXBUF_AVAILABLE_IN_ALL
90
int                 gdk_pixbuf_animation_get_width       (GdkPixbufAnimation *animation);
Chun-wei Fan's avatar
Chun-wei Fan committed
91
GDK_PIXBUF_AVAILABLE_IN_ALL
92
int                 gdk_pixbuf_animation_get_height      (GdkPixbufAnimation *animation);
Chun-wei Fan's avatar
Chun-wei Fan committed
93
GDK_PIXBUF_AVAILABLE_IN_ALL
94
gboolean            gdk_pixbuf_animation_is_static_image  (GdkPixbufAnimation *animation);
Chun-wei Fan's avatar
Chun-wei Fan committed
95
GDK_PIXBUF_AVAILABLE_IN_ALL
96
97
GdkPixbuf          *gdk_pixbuf_animation_get_static_image (GdkPixbufAnimation *animation);

98
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
Chun-wei Fan's avatar
Chun-wei Fan committed
99
GDK_PIXBUF_AVAILABLE_IN_ALL
100
101
GdkPixbufAnimationIter *gdk_pixbuf_animation_get_iter                        (GdkPixbufAnimation     *animation,
                                                                              const GTimeVal         *start_time);
102
103
G_GNUC_END_IGNORE_DEPRECATIONS

Chun-wei Fan's avatar
Chun-wei Fan committed
104
GDK_PIXBUF_AVAILABLE_IN_ALL
105
GType                   gdk_pixbuf_animation_iter_get_type                   (void) G_GNUC_CONST;
Chun-wei Fan's avatar
Chun-wei Fan committed
106
GDK_PIXBUF_AVAILABLE_IN_ALL
107
int                     gdk_pixbuf_animation_iter_get_delay_time             (GdkPixbufAnimationIter *iter);
Chun-wei Fan's avatar
Chun-wei Fan committed
108
GDK_PIXBUF_AVAILABLE_IN_ALL
109
GdkPixbuf              *gdk_pixbuf_animation_iter_get_pixbuf                 (GdkPixbufAnimationIter *iter);
Chun-wei Fan's avatar
Chun-wei Fan committed
110
GDK_PIXBUF_AVAILABLE_IN_ALL
111
gboolean                gdk_pixbuf_animation_iter_on_currently_loading_frame (GdkPixbufAnimationIter *iter);
112
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
Chun-wei Fan's avatar
Chun-wei Fan committed
113
GDK_PIXBUF_AVAILABLE_IN_ALL
114
115
gboolean                gdk_pixbuf_animation_iter_advance                    (GdkPixbufAnimationIter *iter,
                                                                              const GTimeVal         *current_time);
116
G_GNUC_END_IGNORE_DEPRECATIONS
117
118


119
120
121
122
#ifdef GDK_PIXBUF_ENABLE_BACKEND



123
124
125
126
127
128
129
130
131
132
133
134
/**
 * GdkPixbufAnimationClass:
 * @parent_class: the parent class
 * @is_static_image: returns whether the given animation is just a static image.
 * @get_static_image: returns a static image representing the given animation.
 * @get_size: fills @width and @height with the frame size of the animation.
 * @get_iter: returns an iterator for the given animation.
 * 
 * Modules supporting animations must derive a type from 
 * #GdkPixbufAnimation, providing suitable implementations of the 
 * virtual functions.
 */
135
136
137
138
139
140
141
142
143
144
145
146
typedef struct _GdkPixbufAnimationClass GdkPixbufAnimationClass;

#define GDK_PIXBUF_ANIMATION_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_PIXBUF_ANIMATION, GdkPixbufAnimationClass))
#define GDK_IS_PIXBUF_ANIMATION_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_PIXBUF_ANIMATION))
#define GDK_PIXBUF_ANIMATION_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_PIXBUF_ANIMATION, GdkPixbufAnimationClass))

/* Private part of the GdkPixbufAnimation structure */
struct _GdkPixbufAnimation {
        GObject parent_instance;

};

147
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
148
149
150
struct _GdkPixbufAnimationClass {
        GObjectClass parent_class;

Matthias Clasen's avatar
Matthias Clasen committed
151
152
        /*< public >*/

153
        gboolean                (*is_static_image)  (GdkPixbufAnimation *animation);
154

155
156
157
        GdkPixbuf*              (*get_static_image) (GdkPixbufAnimation *animation);

        void                    (*get_size) (GdkPixbufAnimation *animation,
158
159
160
                                             int                 *width,
                                             int                 *height);

161
162
        GdkPixbufAnimationIter* (*get_iter) (GdkPixbufAnimation *animation,
                                             const GTimeVal     *start_time);
163
};
164
G_GNUC_END_IGNORE_DEPRECATIONS
165
166
167



168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
/**
 * GdkPixbufAnimationIterClass:
 * @parent_class: the parent class
 * @get_delay_time: returns the time in milliseconds that the current frame 
 *  should be shown.
 * @get_pixbuf: returns the current frame.
 * @on_currently_loading_frame: returns whether the current frame of @iter is 
 *  being loaded.
 * @advance: advances the iterator to @current_time, possibly changing the 
 *  current frame.
 * 
 * Modules supporting animations must derive a type from 
 * #GdkPixbufAnimationIter, providing suitable implementations of the 
 * virtual functions.
 */
183
184
185
186
187
188
189
190
191
192
193
typedef struct _GdkPixbufAnimationIterClass GdkPixbufAnimationIterClass;

#define GDK_PIXBUF_ANIMATION_ITER_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_PIXBUF_ANIMATION_ITER, GdkPixbufAnimationIterClass))
#define GDK_IS_PIXBUF_ANIMATION_ITER_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_PIXBUF_ANIMATION_ITER))
#define GDK_PIXBUF_ANIMATION_ITER_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_PIXBUF_ANIMATION_ITER, GdkPixbufAnimationIterClass))

struct _GdkPixbufAnimationIter {
        GObject parent_instance;

};

194
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
195
196
197
struct _GdkPixbufAnimationIterClass {
        GObjectClass parent_class;

Matthias Clasen's avatar
Matthias Clasen committed
198
199
        /*< public >*/

200
201
202
203
        int        (*get_delay_time)   (GdkPixbufAnimationIter *iter);

        GdkPixbuf* (*get_pixbuf)       (GdkPixbufAnimationIter *iter);

204
        gboolean   (*on_currently_loading_frame) (GdkPixbufAnimationIter *iter);
205

206
        gboolean   (*advance)          (GdkPixbufAnimationIter *iter,
207
208
                                        const GTimeVal         *current_time);
};
209
G_GNUC_END_IGNORE_DEPRECATIONS
210
211
      

Chun-wei Fan's avatar
Chun-wei Fan committed
212
GDK_PIXBUF_AVAILABLE_IN_ALL
213
GType               gdk_pixbuf_non_anim_get_type (void) G_GNUC_CONST;
Chun-wei Fan's avatar
Chun-wei Fan committed
214
GDK_PIXBUF_AVAILABLE_IN_ALL
215
216
217
218
219
220
221
GdkPixbufAnimation* gdk_pixbuf_non_anim_new (GdkPixbuf *pixbuf);

#endif /* GDK_PIXBUF_ENABLE_BACKEND */

G_END_DECLS

#endif /* GDK_PIXBUF_ANIMATION_H */