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
|
2020-05-08 19:48:02 +03:00
|
|
|
from ._binary import 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
|
|
|
|
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):
|
2019-03-21 16:28:20 +03: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.
|
|
|
|
|
2019-03-21 16:28:20 +03:00
|
|
|
|
2010-07-31 06:52:47 +04:00
|
|
|
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)):
|
2022-12-22 00:51:35 +03:00
|
|
|
msg = "not an XV thumbnail file"
|
|
|
|
raise SyntaxError(msg)
|
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:
|
2022-12-22 00:51:35 +03:00
|
|
|
msg = "Unexpected EOF reading XV thumbnail file"
|
|
|
|
raise SyntaxError(msg)
|
2020-05-08 19:48:02 +03:00
|
|
|
if 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"
|
2018-09-30 05:58:02 +03:00
|
|
|
self._size = int(s[0]), int(s[1])
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
self.palette = ImagePalette.raw("RGB", PALETTE)
|
|
|
|
|
2019-03-21 16:28:20 +03:00
|
|
|
self.tile = [("raw", (0, 0) + self.size, self.fp.tell(), (self.mode, 0, 1))]
|
2010-07-31 06:52:47 +04:00
|
|
|
|
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)
|