← Back to branch summary

~ubuntu-branches/ubuntu/maverick/gdk-pixbuf/maverick

« back to all changes in this revision

Viewing changes to doc/html/gdk-pixbuf-file-loading.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-07-23 11:26:25 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20100723112625-owhl395g8ifk2wtn
Tags: 2.21.6-2ubuntu1
* Rebase on Debian
* debian/control, debian/gir1.0-gdkpixbuf-2.0.install, debian/rules:
  - build a gir1.0-gdkpixbuf-2.0 gir binary

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/gdk-pixbuf-file-loading.html
1
 
<HTML
2
 
><HEAD
3
 
><TITLE
4
 
>File Loading</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="Reference Counting and Memory Mangement"
17
 
HREF="gdk-pixbuf-refcounting.html"><LINK
18
 
REL="NEXT"
19
 
TITLE="Image Data in Memory"
20
 
HREF="gdk-pixbuf-creating.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-refcounting.html"
56
 
><FONT
57
 
COLOR="#FFFFFF"
58
 
SIZE="3"
59
 
><B
60
 
>&#60;&#60;&#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="gdk-pixbuf-creating.html"
110
 
><FONT
111
 
COLOR="#FFFFFF"
112
 
SIZE="3"
113
 
><B
114
 
>Next Page &#62;&#62;&#62;</B
115
 
></FONT
116
 
></A
117
 
></TD
118
 
></TR
119
 
></TABLE
120
 
></DIV
121
 
><H1
122
 
><A
123
 
NAME="GDK-PIXBUF-FILE-LOADING">File Loading</H1
124
 
><DIV
125
 
CLASS="REFNAMEDIV"
126
 
><A
127
 
NAME="AEN443"
128
 
></A
129
 
><H2
130
 
>Name</H2
131
 
>File Loading&nbsp;--&nbsp;Loading a pixbuf from a file.</DIV
132
 
><DIV
133
 
CLASS="REFSYNOPSISDIV"
134
 
><A
135
 
NAME="AEN446"><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
 
>&#13;#include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
147
 
 
148
 
 
149
 
GdkPixbuf*  <A
150
 
HREF="gdk-pixbuf-file-loading.html#GDK-PIXBUF-NEW-FROM-FILE"
151
 
>gdk_pixbuf_new_from_file</A
152
 
>        (const char *filename);</PRE
153
 
></TD
154
 
></TR
155
 
></TABLE
156
 
></DIV
157
 
><DIV
158
 
CLASS="REFSECT1"
159
 
><A
160
 
NAME="AEN451"
161
 
></A
162
 
><H2
163
 
>Description</H2
164
 
><P
165
 
>    The <SPAN
166
 
CLASS="APPLICATION"
167
 
>gdk-pixbuf</SPAN
168
 
> library provides a simple mechanism for loading
169
 
    an image from a file in synchronous fashion.  This means that the
170
 
    library takes control of the application while the file is being
171
 
    loaded; from the user's point of view, the application will block
172
 
    until the image is done loading.
173
 
  </P
174
 
><P
175
 
>    This interface can be used by applications in which blocking is
176
 
    acceptable while an image is being loaded.  It can also be used to
177
 
    load small images in general.  Applications that need progressive
178
 
    loading can use the <A
179
 
HREF="gdkpixbufloader.html"
180
 
>GdkPixbufLoader</A
181
 
> functionality instead.
182
 
  </P
183
 
></DIV
184
 
><DIV
185
 
CLASS="REFSECT1"
186
 
><A
187
 
NAME="AEN457"
188
 
></A
189
 
><H2
190
 
>Details</H2
191
 
><DIV
192
 
CLASS="REFSECT2"
193
 
><A
194
 
NAME="AEN459"
195
 
></A
196
 
><H3
197
 
><A
198
 
NAME="GDK-PIXBUF-NEW-FROM-FILE"
199
 
></A
200
 
>gdk_pixbuf_new_from_file ()</H3
201
 
><TABLE
202
 
BORDER="0"
203
 
BGCOLOR="#D6E8FF"
204
 
WIDTH="100%"
205
 
CELLPADDING="6"
206
 
><TR
207
 
><TD
208
 
><PRE
209
 
CLASS="PROGRAMLISTING"
210
 
>GdkPixbuf*  gdk_pixbuf_new_from_file        (const char *filename);</PRE
211
 
></TD
212
 
></TR
213
 
></TABLE
214
 
><P
215
 
>Creates a new pixbuf by loading an image from a file.  The file format is
216
 
detected automatically.</P
217
 
><P
218
 
></P
219
 
><DIV
220
 
CLASS="INFORMALTABLE"
221
 
><A
222
 
NAME="AEN466"><P
223
 
></P
224
 
><TABLE
225
 
BORDER="0"
226
 
WIDTH="100%"
227
 
BGCOLOR="#FFD0D0"
228
 
CELLSPACING="0"
229
 
CELLPADDING="4"
230
 
CLASS="CALSTABLE"
231
 
><TBODY
232
 
><TR
233
 
><TD
234
 
WIDTH="20%"
235
 
ALIGN="RIGHT"
236
 
VALIGN="TOP"
237
 
><TT
238
 
CLASS="PARAMETER"
239
 
><I
240
 
>filename</I
241
 
></TT
242
 
>&nbsp;:</TD
243
 
><TD
244
 
WIDTH="80%"
245
 
ALIGN="LEFT"
246
 
VALIGN="TOP"
247
 
> Name of file to load.</TD
248
 
></TR
249
 
><TR
250
 
><TD
251
 
WIDTH="20%"
252
 
ALIGN="RIGHT"
253
 
VALIGN="TOP"
254
 
><SPAN
255
 
CLASS="emphasis"
256
 
><I
257
 
CLASS="EMPHASIS"
258
 
>Returns</I
259
 
></SPAN
260
 
> :</TD
261
 
><TD
262
 
WIDTH="80%"
263
 
ALIGN="LEFT"
264
 
VALIGN="TOP"
265
 
> A newly-created pixbuf with a reference count of 1, or <TT
266
 
CLASS="LITERAL"
267
 
>NULL</TT
268
 
> if
269
 
any of several error conditions occurred:  the file could not be opened,
270
 
there was no loader for the file's format, there was not enough memory to
271
 
allocate the image buffer, or the image file contained invalid data.</TD
272
 
></TR
273
 
></TBODY
274
 
></TABLE
275
 
><P
276
 
></P
277
 
></DIV
278
 
></DIV
279
 
></DIV
280
 
><DIV
281
 
CLASS="REFSECT1"
282
 
><A
283
 
NAME="AEN480"
284
 
></A
285
 
><H2
286
 
>See Also</H2
287
 
><P
288
 
>    <A
289
 
HREF="gdkpixbufloader.html"
290
 
>GdkPixbufLoader</A
291
 
>.
292
 
  </P
293
 
></DIV
294
 
><DIV
295
 
CLASS="NAVFOOTER"
296
 
><BR
297
 
CLEAR="all"><BR><TABLE
298
 
WIDTH="100%"
299
 
BORDER="0"
300
 
BGCOLOR="#000000"
301
 
CELLPADDING="1"
302
 
CELLSPACING="0"
303
 
><TR
304
 
><TD
305
 
WIDTH="25%"
306
 
BGCOLOR="#C00000"
307
 
ALIGN="left"
308
 
><A
309
 
HREF="gdk-pixbuf-refcounting.html"
310
 
><FONT
311
 
COLOR="#FFFFFF"
312
 
SIZE="3"
313
 
><B
314
 
>&#60;&#60;&#60; Previous Page</B
315
 
></FONT
316
 
></A
317
 
></TD
318
 
><TD
319
 
WIDTH="25%"
320
 
BGCOLOR="#0000C0"
321
 
ALIGN="center"
322
 
><FONT
323
 
COLOR="#FFFFFF"
324
 
SIZE="3"
325
 
><B
326
 
><A
327
 
HREF="index.html"
328
 
><FONT
329
 
COLOR="#FFFFFF"
330
 
SIZE="3"
331
 
><B
332
 
>Home</B
333
 
></FONT
334
 
></A
335
 
></B
336
 
></FONT
337
 
></TD
338
 
><TD
339
 
WIDTH="25%"
340
 
BGCOLOR="#00C000"
341
 
ALIGN="center"
342
 
><FONT
343
 
COLOR="#FFFFFF"
344
 
SIZE="3"
345
 
><B
346
 
><A
347
 
HREF="r27.html"
348
 
><FONT
349
 
COLOR="#FFFFFF"
350
 
SIZE="3"
351
 
><B
352
 
>Up</B
353
 
></FONT
354
 
></A
355
 
></B
356
 
></FONT
357
 
></TD
358
 
><TD
359
 
WIDTH="25%"
360
 
BGCOLOR="#C00000"
361
 
ALIGN="right"
362
 
><A
363
 
HREF="gdk-pixbuf-creating.html"
364
 
><FONT
365
 
COLOR="#FFFFFF"
366
 
SIZE="3"
367
 
><B
368
 
>Next Page &#62;&#62;&#62;</B
369
 
></FONT
370
 
></A
371
 
></TD
372
 
></TR
373
 
><TR
374
 
><TD
375
 
COLSPAN="2"
376
 
ALIGN="left"
377
 
><FONT
378
 
COLOR="#FFFFFF"
379
 
SIZE="3"
380
 
><B
381
 
>Reference Counting and Memory Mangement</B
382
 
></FONT
383
 
></TD
384
 
><TD
385
 
COLSPAN="2"
386
 
ALIGN="right"
387
 
><FONT
388
 
COLOR="#FFFFFF"
389
 
SIZE="3"
390
 
><B
391
 
>Image Data in Memory</B
392
 
></FONT
393
 
></TD
394
 
></TR
395
 
></TABLE
396
 
></DIV
397
 
></BODY
398
 
></HTML
399
 
>
 
 
b'\\ No newline at end of file'