1
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
4
<meta http-equiv='Content-Type' content='text/html; charset=us-ascii' />
5
<title>The PIL.ImageFile Module</title>
6
<link rel='stylesheet' href='effbot.css' type='text/css' />
9
<h1>The PIL.ImageFile Module</h1>
11
<dt><b>_ParserFile(data)</b> (class) [<a href='#PIL.ImageFile._ParserFile-class'>#</a>]</dt>
13
<p>(Internal) Support class for the Parser file.</p>
14
<p>For more information about this class, see <a href='#PIL.ImageFile._ParserFile-class'><i>The _ParserFile Class</i></a>.</p>
16
<dt><a id='PIL.ImageFile._safe_read-function' name='PIL.ImageFile._safe_read-function'><b>_safe_read(fp, size)</b></a> [<a href='#PIL.ImageFile._safe_read-function'>#</a>]</dt>
18
<p>Reads large blocks in a safe way. Unlike fp.read(n), this function
19
doesn't trust the user. If the requested size is larger than
20
SAFEBLOCK, the file is read block by block.</p>
24
File handle. Must implement a <b>read</b> method.
28
Number of bytes to read.</dd>
31
A string containing up to <i>size</i> bytes of data.
35
<dt><a id='PIL.ImageFile._save-function' name='PIL.ImageFile._save-function'><b>_save(im, fp, tile)</b></a> [<a href='#PIL.ImageFile._save-function'>#</a>]</dt>
37
<p>(Helper) Save image body to file.</p>
50
<dt><b>ImageFile(fp=None, filename=None)</b> (class) [<a href='#PIL.ImageFile.ImageFile-class'>#</a>]</dt>
52
<p>Base class for image file handlers.</p>
53
<p>For more information about this class, see <a href='#PIL.ImageFile.ImageFile-class'><i>The ImageFile Class</i></a>.</p>
55
<dt><b>Parser</b> (class) [<a href='#PIL.ImageFile.Parser-class'>#</a>]</dt>
57
<p>Incremental image parser.</p>
58
<p>For more information about this class, see <a href='#PIL.ImageFile.Parser-class'><i>The Parser Class</i></a>.</p>
60
<dt><b>StubImageFile</b> (class) [<a href='#PIL.ImageFile.StubImageFile-class'>#</a>]</dt>
62
<p>Base class for stub image loaders.</p>
63
<p>For more information about this class, see <a href='#PIL.ImageFile.StubImageFile-class'><i>The StubImageFile Class</i></a>.</p>
66
<h2><a id='PIL.ImageFile._ParserFile-class' name='PIL.ImageFile._ParserFile-class'>The _ParserFile Class</a></h2>
68
<dt><b>_ParserFile(data)</b> (class) [<a href='#PIL.ImageFile._ParserFile-class'>#</a>]</dt>
70
<p>(Internal) Support class for the <b>Parser</b> file.
73
<h2><a id='PIL.ImageFile.ImageFile-class' name='PIL.ImageFile.ImageFile-class'>The ImageFile Class</a></h2>
75
<dt><b>ImageFile(fp=None, filename=None)</b> (class) [<a href='#PIL.ImageFile.ImageFile-class'>#</a>]</dt>
77
<p>Base class for image file handlers.</p>
80
<h2><a id='PIL.ImageFile.Parser-class' name='PIL.ImageFile.Parser-class'>The Parser Class</a></h2>
82
<dt><b>Parser</b> (class) [<a href='#PIL.ImageFile.Parser-class'>#</a>]</dt>
84
<p>Incremental image parser. This class implements the standard
85
feed/close consumer interface.</p>
87
<dt><a id='PIL.ImageFile.Parser.close-method' name='PIL.ImageFile.Parser.close-method'><b>close()</b></a> [<a href='#PIL.ImageFile.Parser.close-method'>#</a>]</dt>
89
<p>(Consumer) Close the stream.</p>
94
<dt>Raises <b>IOError</b>:</dt><dd>
95
If the parser failed to parse the image file.</dd>
98
<dt><a id='PIL.ImageFile.Parser.feed-method' name='PIL.ImageFile.Parser.feed-method'><b>feed(data)</b></a> [<a href='#PIL.ImageFile.Parser.feed-method'>#</a>]</dt>
100
<p>(Consumer) Feed data to the parser.</p>
104
A string buffer.</dd>
105
<dt>Raises <b>IOError</b>:</dt><dd>
106
If the parser failed to parse the image file.</dd>
109
<dt><a id='PIL.ImageFile.Parser.reset-method' name='PIL.ImageFile.Parser.reset-method'><b>reset()</b></a> [<a href='#PIL.ImageFile.Parser.reset-method'>#</a>]</dt>
111
<p>(Consumer) Reset the parser. Note that you can only call this
112
method immediately after you've created a parser; parser
113
instances cannot be reused.</p>
116
<h2><a id='PIL.ImageFile.StubImageFile-class' name='PIL.ImageFile.StubImageFile-class'>The StubImageFile Class</a></h2>
118
<dt><b>StubImageFile</b> (class) [<a href='#PIL.ImageFile.StubImageFile-class'>#</a>]</dt>
120
<p>Base class for stub image loaders.
122
A stub loader is an image loader that can identify files of a
123
certain format, but relies on external code to load the file.
125
<dt><a id='PIL.ImageFile.StubImageFile._load-method' name='PIL.ImageFile.StubImageFile._load-method'><b>_load()</b></a> [<a href='#PIL.ImageFile.StubImageFile._load-method'>#</a>]</dt>
127
<p>(Hook) Find actual image loader.</p>
1
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
4
<meta http-equiv='Content-Type' content='text/html; charset=us-ascii' />
5
<title>The PIL.ImageFile Module</title>
6
<link rel='stylesheet' href='effbot.css' type='text/css' />
9
<h1>The PIL.ImageFile Module</h1>
11
<dt><b>_ParserFile(data)</b> (class) [<a href='#PIL.ImageFile._ParserFile-class'>#</a>]</dt>
13
<p>(Internal) Support class for the Parser file.</p>
14
<p>For more information about this class, see <a href='#PIL.ImageFile._ParserFile-class'><i>The _ParserFile Class</i></a>.</p>
16
<dt><a id='PIL.ImageFile._safe_read-function' name='PIL.ImageFile._safe_read-function'><b>_safe_read(fp, size)</b></a> [<a href='#PIL.ImageFile._safe_read-function'>#</a>]</dt>
21
File handle. Must implement a <b>read</b> method.
28
A string containing up to <i>size</i> bytes of data.
32
<dt><a id='PIL.ImageFile._save-function' name='PIL.ImageFile._save-function'><b>_save(im, fp, tile)</b></a> [<a href='#PIL.ImageFile._save-function'>#</a>]</dt>
46
<dt><b>ImageFile(fp=None, filename=None)</b> (class) [<a href='#PIL.ImageFile.ImageFile-class'>#</a>]</dt>
48
<p>Base class for image file handlers.</p>
49
<p>For more information about this class, see <a href='#PIL.ImageFile.ImageFile-class'><i>The ImageFile Class</i></a>.</p>
51
<dt><b>Parser</b> (class) [<a href='#PIL.ImageFile.Parser-class'>#</a>]</dt>
53
<p>Incremental image parser.</p>
54
<p>For more information about this class, see <a href='#PIL.ImageFile.Parser-class'><i>The Parser Class</i></a>.</p>
56
<dt><b>StubImageFile</b> (class) [<a href='#PIL.ImageFile.StubImageFile-class'>#</a>]</dt>
58
<p>Base class for stub image loaders.</p>
59
<p>For more information about this class, see <a href='#PIL.ImageFile.StubImageFile-class'><i>The StubImageFile Class</i></a>.</p>
62
<h2><a id='PIL.ImageFile._ParserFile-class' name='PIL.ImageFile._ParserFile-class'>The _ParserFile Class</a></h2>
64
<dt><b>_ParserFile(data)</b> (class) [<a href='#PIL.ImageFile._ParserFile-class'>#</a>]</dt>
66
<p>(Internal) Support class for the <b>Parser</b> file.
69
<h2><a id='PIL.ImageFile.ImageFile-class' name='PIL.ImageFile.ImageFile-class'>The ImageFile Class</a></h2>
71
<dt><b>ImageFile(fp=None, filename=None)</b> (class) [<a href='#PIL.ImageFile.ImageFile-class'>#</a>]</dt>
75
<h2><a id='PIL.ImageFile.Parser-class' name='PIL.ImageFile.Parser-class'>The Parser Class</a></h2>
77
<dt><b>Parser</b> (class) [<a href='#PIL.ImageFile.Parser-class'>#</a>]</dt>
80
<dt><a id='PIL.ImageFile.Parser.close-method' name='PIL.ImageFile.Parser.close-method'><b>close()</b></a> [<a href='#PIL.ImageFile.Parser.close-method'>#</a>]</dt>
86
<dt>Raises <b>IOError</b>:</dt><dd>
90
<dt><a id='PIL.ImageFile.Parser.feed-method' name='PIL.ImageFile.Parser.feed-method'><b>feed(data)</b></a> [<a href='#PIL.ImageFile.Parser.feed-method'>#</a>]</dt>
96
<dt>Raises <b>IOError</b>:</dt><dd>
100
<dt><a id='PIL.ImageFile.Parser.reset-method' name='PIL.ImageFile.Parser.reset-method'><b>reset()</b></a> [<a href='#PIL.ImageFile.Parser.reset-method'>#</a>]</dt>
104
<h2><a id='PIL.ImageFile.StubImageFile-class' name='PIL.ImageFile.StubImageFile-class'>The StubImageFile Class</a></h2>
106
<dt><b>StubImageFile</b> (class) [<a href='#PIL.ImageFile.StubImageFile-class'>#</a>]</dt>
108
<p>Base class for stub image loaders.
110
A stub loader is an image loader that can identify files of a
111
certain format, but relies on external code to load the file.
113
<dt><a id='PIL.ImageFile.StubImageFile._load-method' name='PIL.ImageFile.StubImageFile._load-method'><b>_load()</b></a> [<a href='#PIL.ImageFile.StubImageFile._load-method'>#</a>]</dt>