2010-07-31 06:52:47 +04:00
|
|
|
#
|
|
|
|
# The Python Imaging Library.
|
|
|
|
# $Id$
|
|
|
|
#
|
|
|
|
# XV Thumbnail file handler by Charles E. "Gene" Cash
|
|
|
|
# (gcash@magicnet.net)
|
|
|
|
#
|
|
|
|
# see xvcolor.c and xvbrowse.c in the sources to John Bradley's XV,
|
|
|
|
# available from ftp://ftp.cis.upenn.edu/pub/xv/
|
|
|
|
#
|
|
|
|
# history:
|
|
|
|
# 98-08-15 cec created (b/w only)
|
|
|
|
# 98-12-09 cec added color palette
|
|
|
|
# 98-12-28 fl added to PIL (with only a few very minor modifications)
|
|
|
|
#
|
|
|
|
# To do:
|
|
|
|
# FIXME: make save work (this requires quantization support)
|
|
|
|
#
|
|
|
|
|
2017-01-17 16:22:18 +03:00
|
|
|
from . import Image, ImageFile, ImagePalette
|
2017-03-05 00:28:08 +03:00
|
|
|
from ._binary import i8, o8
|
py3k: The big push
There are two main issues fixed with this commit:
* bytes vs. str: All file, image, and palette data are now handled as
bytes. A new _binary module consolidates the hacks needed to do this
across Python versions. tostring/fromstring methods have been renamed to
tobytes/frombytes, but the Python 2.6/2.7 versions alias them to the old
names for compatibility. Users should move to tobytes/frombytes.
One other potentially-breaking change is that text data in image files
(such as tags, comments) are now explicitly handled with a specific
character encoding in mind. This works well with the Unicode str in
Python 3, but may trip up old code expecting a straight byte-for-byte
translation to a Python string. This also required a change to Gohlke's
tags tests (in Tests/test_file_png.py) to expect Unicode strings from
the code.
* True div vs. floor div: Many division operations used the "/" operator
to do floor division, which is now the "//" operator in Python 3. These
were fixed.
As of this commit, on the first pass, I have one failing test (improper
handling of a slice object in a C module, test_imagepath.py) in Python 3,
and three that that I haven't tried running yet (test_imagegl,
test_imagegrab, and test_imageqt). I also haven't tested anything on
Windows. All but the three skipped tests run flawlessly against Pythons
2.6 and 2.7.
2012-10-21 01:01:53 +04:00
|
|
|
|
2015-08-25 15:27:18 +03:00
|
|
|
__version__ = "0.1"
|
|
|
|
|
2016-04-21 14:40:54 +03:00
|
|
|
_MAGIC = b"P7 332"
|
|
|
|
|
2010-07-31 06:52:47 +04:00
|
|
|
# standard color palette for thumbnails (RGB332)
|
py3k: The big push
There are two main issues fixed with this commit:
* bytes vs. str: All file, image, and palette data are now handled as
bytes. A new _binary module consolidates the hacks needed to do this
across Python versions. tostring/fromstring methods have been renamed to
tobytes/frombytes, but the Python 2.6/2.7 versions alias them to the old
names for compatibility. Users should move to tobytes/frombytes.
One other potentially-breaking change is that text data in image files
(such as tags, comments) are now explicitly handled with a specific
character encoding in mind. This works well with the Unicode str in
Python 3, but may trip up old code expecting a straight byte-for-byte
translation to a Python string. This also required a change to Gohlke's
tags tests (in Tests/test_file_png.py) to expect Unicode strings from
the code.
* True div vs. floor div: Many division operations used the "/" operator
to do floor division, which is now the "//" operator in Python 3. These
were fixed.
As of this commit, on the first pass, I have one failing test (improper
handling of a slice object in a C module, test_imagepath.py) in Python 3,
and three that that I haven't tried running yet (test_imagegl,
test_imagegrab, and test_imageqt). I also haven't tested anything on
Windows. All but the three skipped tests run flawlessly against Pythons
2.6 and 2.7.
2012-10-21 01:01:53 +04:00
|
|
|
PALETTE = b""
|
2010-07-31 06:52:47 +04:00
|
|
|
for r in range(8):
|
|
|
|
for g in range(8):
|
|
|
|
for b in range(4):
|
py3k: The big push
There are two main issues fixed with this commit:
* bytes vs. str: All file, image, and palette data are now handled as
bytes. A new _binary module consolidates the hacks needed to do this
across Python versions. tostring/fromstring methods have been renamed to
tobytes/frombytes, but the Python 2.6/2.7 versions alias them to the old
names for compatibility. Users should move to tobytes/frombytes.
One other potentially-breaking change is that text data in image files
(such as tags, comments) are now explicitly handled with a specific
character encoding in mind. This works well with the Unicode str in
Python 3, but may trip up old code expecting a straight byte-for-byte
translation to a Python string. This also required a change to Gohlke's
tags tests (in Tests/test_file_png.py) to expect Unicode strings from
the code.
* True div vs. floor div: Many division operations used the "/" operator
to do floor division, which is now the "//" operator in Python 3. These
were fixed.
As of this commit, on the first pass, I have one failing test (improper
handling of a slice object in a C module, test_imagepath.py) in Python 3,
and three that that I haven't tried running yet (test_imagegl,
test_imagegrab, and test_imageqt). I also haven't tested anything on
Windows. All but the three skipped tests run flawlessly against Pythons
2.6 and 2.7.
2012-10-21 01:01:53 +04:00
|
|
|
PALETTE = PALETTE + (o8((r*255)//7)+o8((g*255)//7)+o8((b*255)//3))
|
2010-07-31 06:52:47 +04:00
|
|
|
|
2016-09-03 05:17:22 +03:00
|
|
|
|
2016-04-21 14:40:54 +03:00
|
|
|
def _accept(prefix):
|
|
|
|
return prefix[:6] == _MAGIC
|
|
|
|
|
2014-08-28 15:44:19 +04:00
|
|
|
|
2010-07-31 06:52:47 +04:00
|
|
|
##
|
|
|
|
# Image plugin for XV thumbnail images.
|
|
|
|
|
|
|
|
class XVThumbImageFile(ImageFile.ImageFile):
|
|
|
|
|
|
|
|
format = "XVThumb"
|
|
|
|
format_description = "XV thumbnail image"
|
|
|
|
|
|
|
|
def _open(self):
|
|
|
|
|
|
|
|
# check magic
|
2017-03-04 21:03:34 +03:00
|
|
|
if not _accept(self.fp.read(6)):
|
2012-10-11 07:52:53 +04:00
|
|
|
raise SyntaxError("not an XV thumbnail file")
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
# Skip to beginning of next line
|
|
|
|
self.fp.readline()
|
|
|
|
|
|
|
|
# skip info comments
|
2012-10-17 07:39:56 +04:00
|
|
|
while True:
|
2010-07-31 06:52:47 +04:00
|
|
|
s = self.fp.readline()
|
|
|
|
if not s:
|
2012-10-11 07:52:53 +04:00
|
|
|
raise SyntaxError("Unexpected EOF reading XV thumbnail file")
|
2017-03-05 00:28:08 +03:00
|
|
|
if i8(s[0]) != 35: # ie. when not a comment: '#'
|
2010-07-31 06:52:47 +04:00
|
|
|
break
|
|
|
|
|
|
|
|
# parse header line (already read)
|
2012-10-11 02:11:13 +04:00
|
|
|
s = s.strip().split()
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
self.mode = "P"
|
2017-03-04 20:58:49 +03:00
|
|
|
self.size = int(s[0]), int(s[1])
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
self.palette = ImagePalette.raw("RGB", PALETTE)
|
|
|
|
|
|
|
|
self.tile = [
|
|
|
|
("raw", (0, 0)+self.size,
|
|
|
|
self.fp.tell(), (self.mode, 0, 1)
|
|
|
|
)]
|
|
|
|
|
2017-03-04 20:58:49 +03:00
|
|
|
|
2010-07-31 06:52:47 +04:00
|
|
|
# --------------------------------------------------------------------
|
|
|
|
|
2016-04-21 14:40:54 +03:00
|
|
|
Image.register_open(XVThumbImageFile.format, XVThumbImageFile, _accept)
|