/usr/share/doc/python-imaging/html/imagefile.htm is in python-imaging-doc-html 1.1.2-1.1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <html><head><title>The ImageFile Module</title><link rel="stylesheet" type="text/css" href="effbot.css" /></head><body><div id="IMAGEFILE-MODULE" class="chapter"><h1 style="chapter">The ImageFile Module</h1><p>This module provides support functions for the image open and save functions.</p><p>In addition, it provides a <tt>Parser</tt> class which you can use to decode an image piece by piece, for example while receiving it over a network connection. This class implements the same consumer interface as the standard <tt>sgmllib</tt> and <tt>xmllib</tt> modules.</p><div class="sect1"><h2 style="sect1">Example</h2><div class="example"><b style="example">Example: Parse An Image</b><pre>import ImageFile
fp = open("lena.pgm", "rb")
p = ImageFile.Parser()
while 1:
s = fp.read(1024)
if not s:
break
p.feed(s)
im = p.close()
im.save("copy.jpg")</pre></div></div><div class="sect1"><h2 style="sect1">Functions</h2><div class="sect2"><h3 style="sect2">Parser (constructor)</h3><p><tt>Parser()</tt>. Creates a parser object. Parsers cannot be reused.</p></div></div><div class="sect1"><h2 style="sect1">Methods</h2><div class="sect2"><h3 style="sect2">feed</h3><p><tt>feed(data)</tt>. Feed a string of data to the parser. This method may raise an IOError exception.</p></div><div class="sect2"><h3 style="sect2">close</h3><p><tt>close()</tt>. Tells the parser to finish decoding. If the parser managed to decode an image, it returns an <tt>Image</tt> object. Otherwise, this method raises an IOError exception.</p><blockquote class="note"><b>Note:</b><p>If the file cannot be identified, the parser will raise an IOError exception in the close method. If the file can be identified, but not decoded (for example, if the data is damaged, or if it uses an unsupported compression method), the parser will raise an IOError exception as soon as possible, either in feed or close.</p></blockquote></div></div></div></body></html>
|