« back to all changes in this revision
Viewing changes to doc/html/gdkpixbufloader.html
- browse files at revision 1
- compare with another revision
- download diff
- download tarball
- view history from revision 1
- Committer: Bazaar Package Importer
- Author(s): Sebastien Bacher
- Date: 2004-10-06 22:10:04 UTC
- Revision ID: james.westby@ubuntu.com-20041006221004-rma9deknj8qctu67
Tags: upstream-0.22.0
Import upstream version 0.22.0
- files added:
- demo
- doc
- doc/html
- doc/sgml
- doc/tmpl
- gdk-pixbuf
- gdk-pixbuf/pixops
added
removed
doc/html/gdkpixbufloader.html
1
<HTML
2
><HEAD
3
><TITLE
4
>GdkPixbufLoader</TITLE
5
><META
6
NAME="GENERATOR"
7
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8
"><LINK
9
REL="HOME"
10
TITLE="The gdk-pixbuf Library"
11
HREF="index.html"><LINK
12
REL="UP"
13
TITLE="API Reference"
14
HREF="r27.html"><LINK
15
REL="PREVIOUS"
16
TITLE="Animations"
17
HREF="gdk-pixbuf-animation.html"><LINK
18
REL="NEXT"
19
TITLE="GnomeCanvasPixbuf"
20
HREF="gnomecanvaspixbuf.html"></HEAD
21
><BODY
22
CLASS="REFENTRY"
23
BGCOLOR="#FFFFFF"
24
TEXT="#000000"
25
LINK="#0000FF"
26
VLINK="#840084"
27
ALINK="#0000FF"
28
><DIV
29
CLASS="NAVHEADER"
30
><TABLE
31
WIDTH="100%"
32
BORDER="0"
33
BGCOLOR="#000000"
34
CELLPADDING="1"
35
CELLSPACING="0"
36
><TR
37
><TH
38
COLSPAN="4"
39
ALIGN="center"
40
><FONT
41
COLOR="#FFFFFF"
42
SIZE="5"
43
>The <SPAN
44
CLASS="APPLICATION"
45
>gdk-pixbuf</SPAN
46
> Library</FONT
47
></TH
48
></TR
49
><TR
50
><TD
51
WIDTH="25%"
52
BGCOLOR="#C00000"
53
ALIGN="left"
54
><A
55
HREF="gdk-pixbuf-animation.html"
56
><FONT
57
COLOR="#FFFFFF"
58
SIZE="3"
59
><B
60
><<< Previous Page</B
61
></FONT
62
></A
63
></TD
64
><TD
65
WIDTH="25%"
66
BGCOLOR="#0000C0"
67
ALIGN="center"
68
><FONT
69
COLOR="#FFFFFF"
70
SIZE="3"
71
><B
72
><A
73
HREF="index.html"
74
><FONT
75
COLOR="#FFFFFF"
76
SIZE="3"
77
><B
78
>Home</B
79
></FONT
80
></A
81
></B
82
></FONT
83
></TD
84
><TD
85
WIDTH="25%"
86
BGCOLOR="#00C000"
87
ALIGN="center"
88
><FONT
89
COLOR="#FFFFFF"
90
SIZE="3"
91
><B
92
><A
93
HREF="r27.html"
94
><FONT
95
COLOR="#FFFFFF"
96
SIZE="3"
97
><B
98
>Up</B
99
></FONT
100
></A
101
></B
102
></FONT
103
></TD
104
><TD
105
WIDTH="25%"
106
BGCOLOR="#C00000"
107
ALIGN="right"
108
><A
109
HREF="gnomecanvaspixbuf.html"
110
><FONT
111
COLOR="#FFFFFF"
112
SIZE="3"
113
><B
114
>Next Page >>></B
115
></FONT
116
></A
117
></TD
118
></TR
119
></TABLE
120
></DIV
121
><H1
122
><A
123
NAME="GDKPIXBUFLOADER">GdkPixbufLoader</H1
124
><DIV
125
CLASS="REFNAMEDIV"
126
><A
127
NAME="AEN1992"
128
></A
129
><H2
130
>Name</H2
131
>GdkPixbufLoader -- Application-driven progressive image loading.</DIV
132
><DIV
133
CLASS="REFSYNOPSISDIV"
134
><A
135
NAME="AEN1995"><H2
136
>Synopsis</H2
137
><TABLE
138
BORDER="0"
139
BGCOLOR="#D6E8FF"
140
WIDTH="100%"
141
CELLPADDING="6"
142
><TR
143
><TD
144
><PRE
145
CLASS="SYNOPSIS"
146
> #include <gdk-pixbuf/gdk-pixbuf.h>
147
148
149
#define <A
150
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-CAPS"
151
>GDK_PIXBUF_LOADER</A
152
> (obj)
153
<A
154
HREF="gdkpixbufloader.html"
155
>GdkPixbufLoader</A
156
>* <A
157
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-NEW"
158
>gdk_pixbuf_loader_new</A
159
> (void);
160
gboolean <A
161
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-WRITE"
162
>gdk_pixbuf_loader_write</A
163
> (<A
164
HREF="gdkpixbufloader.html"
165
>GdkPixbufLoader</A
166
> *loader,
167
const guchar *buf,
168
size_t count);
169
GdkPixbuf* <A
170
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-GET-PIXBUF"
171
>gdk_pixbuf_loader_get_pixbuf</A
172
> (<A
173
HREF="gdkpixbufloader.html"
174
>GdkPixbufLoader</A
175
> *loader);
176
GdkPixbufAnimation* <A
177
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-GET-ANIMATION"
178
>gdk_pixbuf_loader_get_animation</A
179
>
180
(<A
181
HREF="gdkpixbufloader.html"
182
>GdkPixbufLoader</A
183
> *loader);
184
void <A
185
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-CLOSE"
186
>gdk_pixbuf_loader_close</A
187
> (<A
188
HREF="gdkpixbufloader.html"
189
>GdkPixbufLoader</A
190
> *loader);
191
</PRE
192
></TD
193
></TR
194
></TABLE
195
></DIV
196
><DIV
197
CLASS="REFSECT1"
198
><A
199
NAME="AEN2014"
200
></A
201
><H2
202
>Object Hierarchy</H2
203
><TABLE
204
BORDER="0"
205
BGCOLOR="#D6E8FF"
206
WIDTH="100%"
207
CELLPADDING="6"
208
><TR
209
><TD
210
><PRE
211
CLASS="SYNOPSIS"
212
> GtkObject
213
+----GdkPixbufLoader</PRE
214
></TD
215
></TR
216
></TABLE
217
></DIV
218
><DIV
219
CLASS="REFSECT1"
220
><A
221
NAME="AEN2018"
222
></A
223
><H2
224
>Signal Prototypes</H2
225
><TABLE
226
BORDER="0"
227
BGCOLOR="#D6E8FF"
228
WIDTH="100%"
229
CELLPADDING="6"
230
><TR
231
><TD
232
><PRE
233
CLASS="SYNOPSIS"
234
> "<A
235
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-AREA-UPDATED"
236
>area-updated</A
237
>"
238
void user_function (<A
239
HREF="gdkpixbufloader.html"
240
>GdkPixbufLoader</A
241
> *gdkpixbufloader,
242
gint arg1,
243
gint arg2,
244
gint arg3,
245
gint arg4,
246
gpointer user_data);
247
"<A
248
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-AREA-PREPARED"
249
>area-prepared</A
250
>"
251
void user_function (<A
252
HREF="gdkpixbufloader.html"
253
>GdkPixbufLoader</A
254
> *gdkpixbufloader,
255
gpointer user_data);
256
"<A
257
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-FRAME-DONE"
258
>frame-done</A
259
>"
260
void user_function (<A
261
HREF="gdkpixbufloader.html"
262
>GdkPixbufLoader</A
263
> *gdkpixbufloader,
264
gpointer arg1,
265
gpointer user_data);
266
"<A
267
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-ANIMATION-DONE"
268
>animation-done</A
269
>"
270
void user_function (<A
271
HREF="gdkpixbufloader.html"
272
>GdkPixbufLoader</A
273
> *gdkpixbufloader,
274
gpointer user_data);
275
"<A
276
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-CLOSED"
277
>closed</A
278
>" void user_function (<A
279
HREF="gdkpixbufloader.html"
280
>GdkPixbufLoader</A
281
> *gdkpixbufloader,
282
gpointer user_data);</PRE
283
></TD
284
></TR
285
></TABLE
286
></DIV
287
><DIV
288
CLASS="REFSECT1"
289
><A
290
NAME="AEN2041"
291
></A
292
><H2
293
>Description</H2
294
><P
295
> <A
296
HREF="gdkpixbufloader.html"
297
>GdkPixbufLoader</A
298
> provides a way for applications to drive the
299
process of loading an image, by letting them send the image data
300
directly to the loader instead of having the loader read the data
301
from a file. Applications can use this functionality instead of
302
<A
303
HREF="gdk-pixbuf-file-loading.html#GDK-PIXBUF-NEW-FROM-FILE"
304
>gdk_pixbuf_new_from_file</A
305
>() when they need to parse image data in
306
small chunks. For example, it should be used when reading an
307
image from a (potentially) slow network connection, or when
308
loading an extremely large file.
309
</P
310
><P
311
> To use <A
312
HREF="gdkpixbufloader.html"
313
>GdkPixbufLoader</A
314
> to load an image, just create a new one,
315
and call <A
316
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-WRITE"
317
>gdk_pixbuf_loader_write</A
318
>() to send the data to it. When
319
done, <A
320
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-CLOSE"
321
>gdk_pixbuf_loader_close</A
322
>() should be called to end the stream
323
and finalize everything. The loader will emit two important
324
signals throughout the process. The first, "<A
325
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-AREA-PREPARED"
326
>area_prepared</A
327
>",
328
will be called as soon as the image has enough information to
329
determine the size of the image to be used. It will pass a
330
<TT
331
CLASS="PARAMETER"
332
><I
333
>GdkPixbuf</I
334
></TT
335
> in. If you want to use it, you can simply ref it. In
336
addition, no actual information will be passed in yet, so the
337
pixbuf can be safely filled with any temporary graphics (or an
338
initial color) as needed. You can also call the
339
<A
340
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-GET-PIXBUF"
341
>gdk_pixbuf_loader_get_pixbuf</A
342
>() once this signal has been emitted
343
and get the same pixbuf.
344
</P
345
><P
346
> The other signal, "<A
347
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-AREA-UPDATED"
348
>area_updated</A
349
>" gets
350
called every time a region is updated. This way you can update a
351
partially completed image. Note that you do not know anything
352
about the completeness of an image from the area updated. For
353
example, in an interlaced image, you need to make several passes
354
before the image is done loading.
355
</P
356
><DIV
357
CLASS="REFSECT2"
358
><A
359
NAME="AEN2055"
360
></A
361
><H3
362
>Loading an animation</H3
363
><P
364
> Loading an animation is a little more complex then loading an
365
image. In addition to the above signals, there is also a "<A
366
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-FRAME-DONE"
367
>frame_done</A
368
>" signal,
369
as well as an "<A
370
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-ANIMATION-DONE"
371
>animation_done</A
372
>"
373
signal. The first lets the application know that it is dealing
374
with an animation, instead of a static image. It also passes a
375
GdkPixbufFrame in the signal. As before, if you want to keep
376
the frame, you need to ref it. Once the first "<A
377
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-FRAME-DONE"
378
>frame_done</A
379
>" signal
380
has been emitted, you can call <A
381
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-GET-ANIMATION"
382
>gdk_pixbuf_loader_get_animation</A
383
>()
384
to get the GdkPixbufAnimation struct. Each subsequent frame
385
goes through a similar lifecycle. For example "<A
386
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-AREA-PREPARED"
387
>area_prepared</A
388
>" is
389
re-emitted. Then "<A
390
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-AREA-UPDATED"
391
>area_updated</A
392
>" is
393
emitted as many times as necessary. Finally, "<A
394
HREF="gdkpixbufloader.html#GDKPIXBUFLOADER-ANIMATION-DONE"
395
>animation_done</A
396
>"
397
is emitted as soon as all frames are done.
398
</P
399
></DIV
400
></DIV
401
><DIV
402
CLASS="REFSECT1"
403
><A
404
NAME="AEN2067"
405
></A
406
><H2
407
>Details</H2
408
><DIV
409
CLASS="REFSECT2"
410
><A
411
NAME="AEN2069"
412
></A
413
><H3
414
><A
415
NAME="GDK-PIXBUF-LOADER-CAPS"
416
></A
417
>GDK_PIXBUF_LOADER()</H3
418
><TABLE
419
BORDER="0"
420
BGCOLOR="#D6E8FF"
421
WIDTH="100%"
422
CELLPADDING="6"
423
><TR
424
><TD
425
><PRE
426
CLASS="PROGRAMLISTING"
427
>#define GDK_PIXBUF_LOADER(obj) (GTK_CHECK_CAST ((obj), GDK_TYPE_PIXBUF_LOADER, GdkPixbufLoader))</PRE
428
></TD
429
></TR
430
></TABLE
431
><P
432
> Casts a GtkObject to a <A
433
HREF="gdkpixbufloader.html"
434
>GdkPixbufLoader</A
435
>.
436
</P
437
><DIV
438
CLASS="INFORMALTABLE"
439
><A
440
NAME="AEN2076"><P
441
></P
442
><TABLE
443
BORDER="0"
444
WIDTH="100%"
445
BGCOLOR="#FFD0D0"
446
CELLSPACING="0"
447
CELLPADDING="4"
448
CLASS="CALSTABLE"
449
><TBODY
450
><TR
451
><TD
452
WIDTH="20%"
453
ALIGN="RIGHT"
454
VALIGN="TOP"
455
><TT
456
CLASS="PARAMETER"
457
><I
458
>obj</I
459
></TT
460
> :</TD
461
><TD
462
WIDTH="80%"
463
ALIGN="LEFT"
464
VALIGN="TOP"
465
>A GTK+ object.
466
</TD
467
></TR
468
></TBODY
469
></TABLE
470
><P
471
></P
472
></DIV
473
></DIV
474
><HR><DIV
475
CLASS="REFSECT2"
476
><A
477
NAME="AEN2085"
478
></A
479
><H3
480
><A
481
NAME="GDK-PIXBUF-LOADER-NEW"
482
></A
483
>gdk_pixbuf_loader_new ()</H3
484
><TABLE
485
BORDER="0"
486
BGCOLOR="#D6E8FF"
487
WIDTH="100%"
488
CELLPADDING="6"
489
><TR
490
><TD
491
><PRE
492
CLASS="PROGRAMLISTING"
493
><A
494
HREF="gdkpixbufloader.html"
495
>GdkPixbufLoader</A
496
>* gdk_pixbuf_loader_new (void);</PRE
497
></TD
498
></TR
499
></TABLE
500
><P
501
>Creates a new pixbuf loader object.</P
502
><P
503
></P
504
><DIV
505
CLASS="INFORMALTABLE"
506
><A
507
NAME="AEN2092"><P
508
></P
509
><TABLE
510
BORDER="0"
511
WIDTH="100%"
512
BGCOLOR="#FFD0D0"
513
CELLSPACING="0"
514
CELLPADDING="4"
515
CLASS="CALSTABLE"
516
><TBODY
517
><TR
518
><TD
519
WIDTH="20%"
520
ALIGN="RIGHT"
521
VALIGN="TOP"
522
><SPAN
523
CLASS="emphasis"
524
><I
525
CLASS="EMPHASIS"
526
>Returns</I
527
></SPAN
528
> :</TD
529
><TD
530
WIDTH="80%"
531
ALIGN="LEFT"
532
VALIGN="TOP"
533
> A newly-created pixbuf loader.</TD
534
></TR
535
></TBODY
536
></TABLE
537
><P
538
></P
539
></DIV
540
></DIV
541
><HR><DIV
542
CLASS="REFSECT2"
543
><A
544
NAME="AEN2101"
545
></A
546
><H3
547
><A
548
NAME="GDK-PIXBUF-LOADER-WRITE"
549
></A
550
>gdk_pixbuf_loader_write ()</H3
551
><TABLE
552
BORDER="0"
553
BGCOLOR="#D6E8FF"
554
WIDTH="100%"
555
CELLPADDING="6"
556
><TR
557
><TD
558
><PRE
559
CLASS="PROGRAMLISTING"
560
>gboolean gdk_pixbuf_loader_write (<A
561
HREF="gdkpixbufloader.html"
562
>GdkPixbufLoader</A
563
> *loader,
564
const guchar *buf,
565
size_t count);</PRE
566
></TD
567
></TR
568
></TABLE
569
><P
570
>This will cause a pixbuf loader to parse the next <TT
571
CLASS="PARAMETER"
572
><I
573
>count</I
574
></TT
575
> bytes of an image.
576
It will return TRUE if the data was loaded successfully, and FALSE if an
577
error occurred. In the latter case, the loader will be closed, and will not
578
accept further writes.</P
579
><P
580
></P
581
><DIV
582
CLASS="INFORMALTABLE"
583
><A
584
NAME="AEN2112"><P
585
></P
586
><TABLE
587
BORDER="0"
588
WIDTH="100%"
589
BGCOLOR="#FFD0D0"
590
CELLSPACING="0"
591
CELLPADDING="4"
592
CLASS="CALSTABLE"
593
><TBODY
594
><TR
595
><TD
596
WIDTH="20%"
597
ALIGN="RIGHT"
598
VALIGN="TOP"
599
><TT
600
CLASS="PARAMETER"
601
><I
602
>loader</I
603
></TT
604
> :</TD
605
><TD
606
WIDTH="80%"
607
ALIGN="LEFT"
608
VALIGN="TOP"
609
> A pixbuf loader.</TD
610
></TR
611
><TR
612
><TD
613
WIDTH="20%"
614
ALIGN="RIGHT"
615
VALIGN="TOP"
616
><TT
617
CLASS="PARAMETER"
618
><I
619
>buf</I
620
></TT
621
> :</TD
622
><TD
623
WIDTH="80%"
624
ALIGN="LEFT"
625
VALIGN="TOP"
626
> Pointer to image data.</TD
627
></TR
628
><TR
629
><TD
630
WIDTH="20%"
631
ALIGN="RIGHT"
632
VALIGN="TOP"
633
><TT
634
CLASS="PARAMETER"
635
><I
636
>count</I
637
></TT
638
> :</TD
639
><TD
640
WIDTH="80%"
641
ALIGN="LEFT"
642
VALIGN="TOP"
643
> Length of the <TT
644
CLASS="PARAMETER"
645
><I
646
>buf</I
647
></TT
648
> buffer in bytes.</TD
649
></TR
650
><TR
651
><TD
652
WIDTH="20%"
653
ALIGN="RIGHT"
654
VALIGN="TOP"
655
><SPAN
656
CLASS="emphasis"
657
><I
658
CLASS="EMPHASIS"
659
>Returns</I
660
></SPAN
661
> :</TD
662
><TD
663
WIDTH="80%"
664
ALIGN="LEFT"
665
VALIGN="TOP"
666
> TRUE if the write was successful, or FALSE if the loader
667
cannot parse the buffer.</TD
668
></TR
669
></TBODY
670
></TABLE
671
><P
672
></P
673
></DIV
674
></DIV
675
><HR><DIV
676
CLASS="REFSECT2"
677
><A
678
NAME="AEN2136"
679
></A
680
><H3
681
><A
682
NAME="GDK-PIXBUF-LOADER-GET-PIXBUF"
683
></A
684
>gdk_pixbuf_loader_get_pixbuf ()</H3
685
><TABLE
686
BORDER="0"
687
BGCOLOR="#D6E8FF"
688
WIDTH="100%"
689
CELLPADDING="6"
690
><TR
691
><TD
692
><PRE
693
CLASS="PROGRAMLISTING"
694
>GdkPixbuf* gdk_pixbuf_loader_get_pixbuf (<A
695
HREF="gdkpixbufloader.html"
696
>GdkPixbufLoader</A
697
> *loader);</PRE
698
></TD
699
></TR
700
></TABLE
701
><P
702
>Queries the GdkPixbuf that a pixbuf loader is currently creating. In general
703
it only makes sense to call this function afer the "area_prepared" signal has
704
been emitted by the loader; this means that enough data has been read to know
705
the size of the image that will be allocated. If the loader has not received
706
enough data via <A
707
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-WRITE"
708
>gdk_pixbuf_loader_write</A
709
>(), then this function returns <TT
710
CLASS="LITERAL"
711
>NULL</TT
712
>.
713
The returned pixbuf will be the same in all future calls to the loader, so
714
simply calling <A
715
HREF="gdk-pixbuf-refcounting.html#GDK-PIXBUF-REF"
716
>gdk_pixbuf_ref</A
717
>() should be sufficient to continue using it. Additionally,
718
if the loader is an animation, it will return the first frame of the animation.</P
719
><P
720
></P
721
><DIV
722
CLASS="INFORMALTABLE"
723
><A
724
NAME="AEN2147"><P
725
></P
726
><TABLE
727
BORDER="0"
728
WIDTH="100%"
729
BGCOLOR="#FFD0D0"
730
CELLSPACING="0"
731
CELLPADDING="4"
732
CLASS="CALSTABLE"
733
><TBODY
734
><TR
735
><TD
736
WIDTH="20%"
737
ALIGN="RIGHT"
738
VALIGN="TOP"
739
><TT
740
CLASS="PARAMETER"
741
><I
742
>loader</I
743
></TT
744
> :</TD
745
><TD
746
WIDTH="80%"
747
ALIGN="LEFT"
748
VALIGN="TOP"
749
> A pixbuf loader.</TD
750
></TR
751
><TR
752
><TD
753
WIDTH="20%"
754
ALIGN="RIGHT"
755
VALIGN="TOP"
756
><SPAN
757
CLASS="emphasis"
758
><I
759
CLASS="EMPHASIS"
760
>Returns</I
761
></SPAN
762
> :</TD
763
><TD
764
WIDTH="80%"
765
ALIGN="LEFT"
766
VALIGN="TOP"
767
> The GdkPixbuf that the loader is creating, or <TT
768
CLASS="LITERAL"
769
>NULL</TT
770
> if not
771
enough data has been read to determine how to create the image buffer.</TD
772
></TR
773
></TBODY
774
></TABLE
775
><P
776
></P
777
></DIV
778
></DIV
779
><HR><DIV
780
CLASS="REFSECT2"
781
><A
782
NAME="AEN2161"
783
></A
784
><H3
785
><A
786
NAME="GDK-PIXBUF-LOADER-GET-ANIMATION"
787
></A
788
>gdk_pixbuf_loader_get_animation ()</H3
789
><TABLE
790
BORDER="0"
791
BGCOLOR="#D6E8FF"
792
WIDTH="100%"
793
CELLPADDING="6"
794
><TR
795
><TD
796
><PRE
797
CLASS="PROGRAMLISTING"
798
>GdkPixbufAnimation* gdk_pixbuf_loader_get_animation
799
(<A
800
HREF="gdkpixbufloader.html"
801
>GdkPixbufLoader</A
802
> *loader);</PRE
803
></TD
804
></TR
805
></TABLE
806
><P
807
>Queries the GdkPixbufAnimation that a pixbuf loader is currently creating.
808
In general it only makes sense to call this function afer the "area_prepared"
809
signal has been emitted by the loader. If the image is not an animation,
810
then it will return <TT
811
CLASS="LITERAL"
812
>NULL</TT
813
>.</P
814
><P
815
></P
816
><DIV
817
CLASS="INFORMALTABLE"
818
><A
819
NAME="AEN2170"><P
820
></P
821
><TABLE
822
BORDER="0"
823
WIDTH="100%"
824
BGCOLOR="#FFD0D0"
825
CELLSPACING="0"
826
CELLPADDING="4"
827
CLASS="CALSTABLE"
828
><TBODY
829
><TR
830
><TD
831
WIDTH="20%"
832
ALIGN="RIGHT"
833
VALIGN="TOP"
834
><TT
835
CLASS="PARAMETER"
836
><I
837
>loader</I
838
></TT
839
> :</TD
840
><TD
841
WIDTH="80%"
842
ALIGN="LEFT"
843
VALIGN="TOP"
844
> A pixbuf loader</TD
845
></TR
846
><TR
847
><TD
848
WIDTH="20%"
849
ALIGN="RIGHT"
850
VALIGN="TOP"
851
><SPAN
852
CLASS="emphasis"
853
><I
854
CLASS="EMPHASIS"
855
>Returns</I
856
></SPAN
857
> :</TD
858
><TD
859
WIDTH="80%"
860
ALIGN="LEFT"
861
VALIGN="TOP"
862
> The GdkPixbufAnimation that the loader is loading, or <TT
863
CLASS="LITERAL"
864
>NULL</TT
865
> if
866
not enough data has been read to determine the information.</TD
867
></TR
868
></TBODY
869
></TABLE
870
><P
871
></P
872
></DIV
873
></DIV
874
><HR><DIV
875
CLASS="REFSECT2"
876
><A
877
NAME="AEN2184"
878
></A
879
><H3
880
><A
881
NAME="GDK-PIXBUF-LOADER-CLOSE"
882
></A
883
>gdk_pixbuf_loader_close ()</H3
884
><TABLE
885
BORDER="0"
886
BGCOLOR="#D6E8FF"
887
WIDTH="100%"
888
CELLPADDING="6"
889
><TR
890
><TD
891
><PRE
892
CLASS="PROGRAMLISTING"
893
>void gdk_pixbuf_loader_close (<A
894
HREF="gdkpixbufloader.html"
895
>GdkPixbufLoader</A
896
> *loader);</PRE
897
></TD
898
></TR
899
></TABLE
900
><P
901
>Informs a pixbuf loader that no further writes with gdk_pixbuf_load_write()
902
will occur, so that it can free its internal loading structures.</P
903
><P
904
></P
905
><DIV
906
CLASS="INFORMALTABLE"
907
><A
908
NAME="AEN2192"><P
909
></P
910
><TABLE
911
BORDER="0"
912
WIDTH="100%"
913
BGCOLOR="#FFD0D0"
914
CELLSPACING="0"
915
CELLPADDING="4"
916
CLASS="CALSTABLE"
917
><TBODY
918
><TR
919
><TD
920
WIDTH="20%"
921
ALIGN="RIGHT"
922
VALIGN="TOP"
923
><TT
924
CLASS="PARAMETER"
925
><I
926
>loader</I
927
></TT
928
> :</TD
929
><TD
930
WIDTH="80%"
931
ALIGN="LEFT"
932
VALIGN="TOP"
933
> A pixbuf loader.</TD
934
></TR
935
></TBODY
936
></TABLE
937
><P
938
></P
939
></DIV
940
></DIV
941
></DIV
942
><DIV
943
CLASS="REFSECT1"
944
><A
945
NAME="AEN2201"
946
></A
947
><H2
948
>Signals</H2
949
><DIV
950
CLASS="REFSECT2"
951
><A
952
NAME="AEN2203"
953
></A
954
><H3
955
><A
956
NAME="GDKPIXBUFLOADER-AREA-UPDATED"
957
></A
958
>The "area-updated" signal</H3
959
><TABLE
960
BORDER="0"
961
BGCOLOR="#D6E8FF"
962
WIDTH="100%"
963
CELLPADDING="6"
964
><TR
965
><TD
966
><PRE
967
CLASS="PROGRAMLISTING"
968
>void user_function (<A
969
HREF="gdkpixbufloader.html"
970
>GdkPixbufLoader</A
971
> *gdkpixbufloader,
972
gint arg1,
973
gint arg2,
974
gint arg3,
975
gint arg4,
976
gpointer user_data);</PRE
977
></TD
978
></TR
979
></TABLE
980
><P
981
> This signal is emitted when a significant area of the image being
982
loaded has been updated. Normally it means that a complete
983
scanline has been read in, but it could be a different area as
984
well. Applications can use this signal to know when to repaint
985
areas of an image that is being loaded.
986
</P
987
><DIV
988
CLASS="INFORMALTABLE"
989
><A
990
NAME="AEN2214"><P
991
></P
992
><TABLE
993
BORDER="0"
994
WIDTH="100%"
995
BGCOLOR="#FFD0D0"
996
CELLSPACING="0"
997
CELLPADDING="4"
998
CLASS="CALSTABLE"
999
><TBODY
1000
><TR
1001
><TD
1002
WIDTH="20%"
1003
ALIGN="RIGHT"
1004
VALIGN="TOP"
1005
><TT
1006
CLASS="PARAMETER"
1007
><I
1008
>gdkpixbufloader</I
1009
></TT
1010
> :</TD
1011
><TD
1012
WIDTH="80%"
1013
ALIGN="LEFT"
1014
VALIGN="TOP"
1015
>the object which received the signal.</TD
1016
></TR
1017
><TR
1018
><TD
1019
WIDTH="20%"
1020
ALIGN="RIGHT"
1021
VALIGN="TOP"
1022
><TT
1023
CLASS="PARAMETER"
1024
><I
1025
>arg1</I
1026
></TT
1027
> :</TD
1028
><TD
1029
WIDTH="80%"
1030
ALIGN="LEFT"
1031
VALIGN="TOP"
1032
> </TD
1033
></TR
1034
><TR
1035
><TD
1036
WIDTH="20%"
1037
ALIGN="RIGHT"
1038
VALIGN="TOP"
1039
><TT
1040
CLASS="PARAMETER"
1041
><I
1042
>arg2</I
1043
></TT
1044
> :</TD
1045
><TD
1046
WIDTH="80%"
1047
ALIGN="LEFT"
1048
VALIGN="TOP"
1049
> </TD
1050
></TR
1051
><TR
1052
><TD
1053
WIDTH="20%"
1054
ALIGN="RIGHT"
1055
VALIGN="TOP"
1056
><TT
1057
CLASS="PARAMETER"
1058
><I
1059
>arg3</I
1060
></TT
1061
> :</TD
1062
><TD
1063
WIDTH="80%"
1064
ALIGN="LEFT"
1065
VALIGN="TOP"
1066
> </TD
1067
></TR
1068
><TR
1069
><TD
1070
WIDTH="20%"
1071
ALIGN="RIGHT"
1072
VALIGN="TOP"
1073
><TT
1074
CLASS="PARAMETER"
1075
><I
1076
>arg4</I
1077
></TT
1078
> :</TD
1079
><TD
1080
WIDTH="80%"
1081
ALIGN="LEFT"
1082
VALIGN="TOP"
1083
> </TD
1084
></TR
1085
><TR
1086
><TD
1087
WIDTH="20%"
1088
ALIGN="RIGHT"
1089
VALIGN="TOP"
1090
><TT
1091
CLASS="PARAMETER"
1092
><I
1093
>user_data</I
1094
></TT
1095
> :</TD
1096
><TD
1097
WIDTH="80%"
1098
ALIGN="LEFT"
1099
VALIGN="TOP"
1100
>user data set when the signal handler was connected.</TD
1101
></TR
1102
></TBODY
1103
></TABLE
1104
><P
1105
></P
1106
></DIV
1107
></DIV
1108
><HR><DIV
1109
CLASS="REFSECT2"
1110
><A
1111
NAME="AEN2243"
1112
></A
1113
><H3
1114
><A
1115
NAME="GDKPIXBUFLOADER-AREA-PREPARED"
1116
></A
1117
>The "area-prepared" signal</H3
1118
><TABLE
1119
BORDER="0"
1120
BGCOLOR="#D6E8FF"
1121
WIDTH="100%"
1122
CELLPADDING="6"
1123
><TR
1124
><TD
1125
><PRE
1126
CLASS="PROGRAMLISTING"
1127
>void user_function (<A
1128
HREF="gdkpixbufloader.html"
1129
>GdkPixbufLoader</A
1130
> *gdkpixbufloader,
1131
gpointer user_data);</PRE
1132
></TD
1133
></TR
1134
></TABLE
1135
><P
1136
> This signal is emitted when the pixbuf loader has been fed the
1137
initial amount of data that is required to figure out the size and
1138
format of the image that it will create. After this signal is
1139
emitted, applications can call <A
1140
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-GET-PIXBUF"
1141
>gdk_pixbuf_loader_get_pixbuf</A
1142
>() to
1143
fetch the partially-loaded pixbuf.
1144
</P
1145
><DIV
1146
CLASS="INFORMALTABLE"
1147
><A
1148
NAME="AEN2251"><P
1149
></P
1150
><TABLE
1151
BORDER="0"
1152
WIDTH="100%"
1153
BGCOLOR="#FFD0D0"
1154
CELLSPACING="0"
1155
CELLPADDING="4"
1156
CLASS="CALSTABLE"
1157
><TBODY
1158
><TR
1159
><TD
1160
WIDTH="20%"
1161
ALIGN="RIGHT"
1162
VALIGN="TOP"
1163
><TT
1164
CLASS="PARAMETER"
1165
><I
1166
>gdkpixbufloader</I
1167
></TT
1168
> :</TD
1169
><TD
1170
WIDTH="80%"
1171
ALIGN="LEFT"
1172
VALIGN="TOP"
1173
>the object which received the signal.</TD
1174
></TR
1175
><TR
1176
><TD
1177
WIDTH="20%"
1178
ALIGN="RIGHT"
1179
VALIGN="TOP"
1180
><TT
1181
CLASS="PARAMETER"
1182
><I
1183
>user_data</I
1184
></TT
1185
> :</TD
1186
><TD
1187
WIDTH="80%"
1188
ALIGN="LEFT"
1189
VALIGN="TOP"
1190
>user data set when the signal handler was connected.</TD
1191
></TR
1192
></TBODY
1193
></TABLE
1194
><P
1195
></P
1196
></DIV
1197
></DIV
1198
><HR><DIV
1199
CLASS="REFSECT2"
1200
><A
1201
NAME="AEN2264"
1202
></A
1203
><H3
1204
><A
1205
NAME="GDKPIXBUFLOADER-FRAME-DONE"
1206
></A
1207
>The "frame-done" signal</H3
1208
><TABLE
1209
BORDER="0"
1210
BGCOLOR="#D6E8FF"
1211
WIDTH="100%"
1212
CELLPADDING="6"
1213
><TR
1214
><TD
1215
><PRE
1216
CLASS="PROGRAMLISTING"
1217
>void user_function (<A
1218
HREF="gdkpixbufloader.html"
1219
>GdkPixbufLoader</A
1220
> *gdkpixbufloader,
1221
gpointer arg1,
1222
gpointer user_data);</PRE
1223
></TD
1224
></TR
1225
></TABLE
1226
><P
1227
> This signal is emitted when a frame is done loading. It will be
1228
emitted for each frame in an animation data stream.
1229
</P
1230
><DIV
1231
CLASS="INFORMALTABLE"
1232
><A
1233
NAME="AEN2272"><P
1234
></P
1235
><TABLE
1236
BORDER="0"
1237
WIDTH="100%"
1238
BGCOLOR="#FFD0D0"
1239
CELLSPACING="0"
1240
CELLPADDING="4"
1241
CLASS="CALSTABLE"
1242
><TBODY
1243
><TR
1244
><TD
1245
WIDTH="20%"
1246
ALIGN="RIGHT"
1247
VALIGN="TOP"
1248
><TT
1249
CLASS="PARAMETER"
1250
><I
1251
>gdkpixbufloader</I
1252
></TT
1253
> :</TD
1254
><TD
1255
WIDTH="80%"
1256
ALIGN="LEFT"
1257
VALIGN="TOP"
1258
>the object which received the signal.</TD
1259
></TR
1260
><TR
1261
><TD
1262
WIDTH="20%"
1263
ALIGN="RIGHT"
1264
VALIGN="TOP"
1265
><TT
1266
CLASS="PARAMETER"
1267
><I
1268
>arg1</I
1269
></TT
1270
> :</TD
1271
><TD
1272
WIDTH="80%"
1273
ALIGN="LEFT"
1274
VALIGN="TOP"
1275
> </TD
1276
></TR
1277
><TR
1278
><TD
1279
WIDTH="20%"
1280
ALIGN="RIGHT"
1281
VALIGN="TOP"
1282
><TT
1283
CLASS="PARAMETER"
1284
><I
1285
>user_data</I
1286
></TT
1287
> :</TD
1288
><TD
1289
WIDTH="80%"
1290
ALIGN="LEFT"
1291
VALIGN="TOP"
1292
>user data set when the signal handler was connected.</TD
1293
></TR
1294
></TBODY
1295
></TABLE
1296
><P
1297
></P
1298
></DIV
1299
></DIV
1300
><HR><DIV
1301
CLASS="REFSECT2"
1302
><A
1303
NAME="AEN2289"
1304
></A
1305
><H3
1306
><A
1307
NAME="GDKPIXBUFLOADER-ANIMATION-DONE"
1308
></A
1309
>The "animation-done" signal</H3
1310
><TABLE
1311
BORDER="0"
1312
BGCOLOR="#D6E8FF"
1313
WIDTH="100%"
1314
CELLPADDING="6"
1315
><TR
1316
><TD
1317
><PRE
1318
CLASS="PROGRAMLISTING"
1319
>void user_function (<A
1320
HREF="gdkpixbufloader.html"
1321
>GdkPixbufLoader</A
1322
> *gdkpixbufloader,
1323
gpointer user_data);</PRE
1324
></TD
1325
></TR
1326
></TABLE
1327
><P
1328
> This signal is emitted when an animation is done loading.
1329
</P
1330
><DIV
1331
CLASS="INFORMALTABLE"
1332
><A
1333
NAME="AEN2296"><P
1334
></P
1335
><TABLE
1336
BORDER="0"
1337
WIDTH="100%"
1338
BGCOLOR="#FFD0D0"
1339
CELLSPACING="0"
1340
CELLPADDING="4"
1341
CLASS="CALSTABLE"
1342
><TBODY
1343
><TR
1344
><TD
1345
WIDTH="20%"
1346
ALIGN="RIGHT"
1347
VALIGN="TOP"
1348
><TT
1349
CLASS="PARAMETER"
1350
><I
1351
>gdkpixbufloader</I
1352
></TT
1353
> :</TD
1354
><TD
1355
WIDTH="80%"
1356
ALIGN="LEFT"
1357
VALIGN="TOP"
1358
>the object which received the signal.</TD
1359
></TR
1360
><TR
1361
><TD
1362
WIDTH="20%"
1363
ALIGN="RIGHT"
1364
VALIGN="TOP"
1365
><TT
1366
CLASS="PARAMETER"
1367
><I
1368
>user_data</I
1369
></TT
1370
> :</TD
1371
><TD
1372
WIDTH="80%"
1373
ALIGN="LEFT"
1374
VALIGN="TOP"
1375
>user data set when the signal handler was connected.</TD
1376
></TR
1377
></TBODY
1378
></TABLE
1379
><P
1380
></P
1381
></DIV
1382
></DIV
1383
><HR><DIV
1384
CLASS="REFSECT2"
1385
><A
1386
NAME="AEN2309"
1387
></A
1388
><H3
1389
><A
1390
NAME="GDKPIXBUFLOADER-CLOSED"
1391
></A
1392
>The "closed" signal</H3
1393
><TABLE
1394
BORDER="0"
1395
BGCOLOR="#D6E8FF"
1396
WIDTH="100%"
1397
CELLPADDING="6"
1398
><TR
1399
><TD
1400
><PRE
1401
CLASS="PROGRAMLISTING"
1402
>void user_function (<A
1403
HREF="gdkpixbufloader.html"
1404
>GdkPixbufLoader</A
1405
> *gdkpixbufloader,
1406
gpointer user_data);</PRE
1407
></TD
1408
></TR
1409
></TABLE
1410
><P
1411
> This signal is emitted when <A
1412
HREF="gdkpixbufloader.html#GDK-PIXBUF-LOADER-CLOSE"
1413
>gdk_pixbuf_loader_close</A
1414
>() is called.
1415
It can be used by different parts of an application to receive
1416
notification when an image loader is closed by the code that
1417
drives it.
1418
</P
1419
><DIV
1420
CLASS="INFORMALTABLE"
1421
><A
1422
NAME="AEN2317"><P
1423
></P
1424
><TABLE
1425
BORDER="0"
1426
WIDTH="100%"
1427
BGCOLOR="#FFD0D0"
1428
CELLSPACING="0"
1429
CELLPADDING="4"
1430
CLASS="CALSTABLE"
1431
><TBODY
1432
><TR
1433
><TD
1434
WIDTH="20%"
1435
ALIGN="RIGHT"
1436
VALIGN="TOP"
1437
><TT
1438
CLASS="PARAMETER"
1439
><I
1440
>gdkpixbufloader</I
1441
></TT
1442
> :</TD
1443
><TD
1444
WIDTH="80%"
1445
ALIGN="LEFT"
1446
VALIGN="TOP"
1447
>the object which received the signal.</TD
1448
></TR
1449
><TR
1450
><TD
1451
WIDTH="20%"
1452
ALIGN="RIGHT"
1453
VALIGN="TOP"
1454
><TT
1455
CLASS="PARAMETER"
1456
><I
1457
>user_data</I
1458
></TT
1459
> :</TD
1460
><TD
1461
WIDTH="80%"
1462
ALIGN="LEFT"
1463
VALIGN="TOP"
1464
>user data set when the signal handler was connected.</TD
1465
></TR
1466
></TBODY
1467
></TABLE
1468
><P
1469
></P
1470
></DIV
1471
></DIV
1472
></DIV
1473
><DIV
1474
CLASS="REFSECT1"
1475
><A
1476
NAME="AEN2330"
1477
></A
1478
><H2
1479
>See Also</H2
1480
><P
1481
> <A
1482
HREF="gdk-pixbuf-file-loading.html#GDK-PIXBUF-NEW-FROM-FILE"
1483
>gdk_pixbuf_new_from_file</A
1484
>()
1485
</P
1486
></DIV
1487
><DIV
1488
CLASS="NAVFOOTER"
1489
><BR
1490
CLEAR="all"><BR><TABLE
1491
WIDTH="100%"
1492
BORDER="0"
1493
BGCOLOR="#000000"
1494
CELLPADDING="1"
1495
CELLSPACING="0"
1496
><TR
1497
><TD
1498
WIDTH="25%"
1499
BGCOLOR="#C00000"
1500
ALIGN="left"
1501
><A
1502
HREF="gdk-pixbuf-animation.html"
1503
><FONT
1504
COLOR="#FFFFFF"
1505
SIZE="3"
1506
><B
1507
><<< Previous Page</B
1508
></FONT
1509
></A
1510
></TD
1511
><TD
1512
WIDTH="25%"
1513
BGCOLOR="#0000C0"
1514
ALIGN="center"
1515
><FONT
1516
COLOR="#FFFFFF"
1517
SIZE="3"
1518
><B
1519
><A
1520
HREF="index.html"
1521
><FONT
1522
COLOR="#FFFFFF"
1523
SIZE="3"
1524
><B
1525
>Home</B
1526
></FONT
1527
></A
1528
></B
1529
></FONT
1530
></TD
1531
><TD
1532
WIDTH="25%"
1533
BGCOLOR="#00C000"
1534
ALIGN="center"
1535
><FONT
1536
COLOR="#FFFFFF"
1537
SIZE="3"
1538
><B
1539
><A
1540
HREF="r27.html"
1541
><FONT
1542
COLOR="#FFFFFF"
1543
SIZE="3"
1544
><B
1545
>Up</B
1546
></FONT
1547
></A
1548
></B
1549
></FONT
1550
></TD
1551
><TD
1552
WIDTH="25%"
1553
BGCOLOR="#C00000"
1554
ALIGN="right"
1555
><A
1556
HREF="gnomecanvaspixbuf.html"
1557
><FONT
1558
COLOR="#FFFFFF"
1559
SIZE="3"
1560
><B
1561
>Next Page >>></B
1562
></FONT
1563
></A
1564
></TD
1565
></TR
1566
><TR
1567
><TD
1568
COLSPAN="2"
1569
ALIGN="left"
1570
><FONT
1571
COLOR="#FFFFFF"
1572
SIZE="3"
1573
><B
1574
>Animations</B
1575
></FONT
1576
></TD
1577
><TD
1578
COLSPAN="2"
1579
ALIGN="right"
1580
><FONT
1581
COLOR="#FFFFFF"
1582
SIZE="3"
1583
><B
1584
>GnomeCanvasPixbuf</B
1585
></FONT
1586
></TD
1587
></TR
1588
></TABLE
1589
></DIV
1590
></BODY
1591
></HTML
1592
>
b'\\ No newline at end of file'
Loggerhead is a web-based interface for Breezy
Version: 2.0.1