2010-07-31 06:52:47 +04:00
|
|
|
#
|
|
|
|
# Python Imaging Library
|
|
|
|
# $Id$
|
|
|
|
#
|
|
|
|
# stuff to read GIMP palette files
|
|
|
|
#
|
|
|
|
# History:
|
|
|
|
# 1997-08-23 fl Created
|
|
|
|
# 2004-09-07 fl Support GIMP 2.0 palette files.
|
|
|
|
#
|
|
|
|
# Copyright (c) Secret Labs AB 1997-2004. All rights reserved.
|
|
|
|
# Copyright (c) Fredrik Lundh 1997-2004.
|
|
|
|
#
|
|
|
|
# See the README file for information on usage and redistribution.
|
|
|
|
#
|
|
|
|
|
2012-10-11 02:11:13 +04:00
|
|
|
import re
|
2010-07-31 06:52:47 +04:00
|
|
|
|
2019-07-06 23:40:53 +03:00
|
|
|
from ._binary import o8
|
2014-08-28 18:18:54 +04:00
|
|
|
|
2019-03-21 16:28:20 +03:00
|
|
|
|
2019-09-30 17:56:31 +03:00
|
|
|
class GimpPaletteFile:
|
2020-06-14 14:47:59 +03:00
|
|
|
"""File handler for GIMP's palette format."""
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
rawmode = "RGB"
|
|
|
|
|
|
|
|
def __init__(self, fp):
|
|
|
|
|
2019-03-21 16:28:20 +03:00
|
|
|
self.palette = [o8(i) * 3 for i in range(256)]
|
2010-07-31 06:52:47 +04:00
|
|
|
|
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
|
|
|
if fp.readline()[:12] != b"GIMP Palette":
|
2012-10-11 07:52:53 +04:00
|
|
|
raise SyntaxError("not a GIMP palette file")
|
2010-07-31 06:52:47 +04:00
|
|
|
|
2019-04-01 03:32:51 +03:00
|
|
|
for i in range(256):
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
s = fp.readline()
|
|
|
|
if not s:
|
|
|
|
break
|
2019-04-01 03:32:51 +03:00
|
|
|
|
2010-07-31 06:52:47 +04:00
|
|
|
# skip fields and comment lines
|
2016-10-31 18:27:49 +03:00
|
|
|
if re.match(br"\w+:|#", s):
|
2010-07-31 06:52:47 +04:00
|
|
|
continue
|
|
|
|
if len(s) > 100:
|
2012-10-11 07:52:53 +04:00
|
|
|
raise SyntaxError("bad palette file")
|
2010-07-31 06:52:47 +04:00
|
|
|
|
2012-10-11 02:11:13 +04:00
|
|
|
v = tuple(map(int, s.split()[:3]))
|
2010-07-31 06:52:47 +04:00
|
|
|
if len(v) != 3:
|
2012-10-11 07:52:53 +04:00
|
|
|
raise ValueError("bad palette entry")
|
2010-07-31 06:52:47 +04:00
|
|
|
|
2019-04-01 03:30:23 +03:00
|
|
|
self.palette[i] = o8(v[0]) + o8(v[1]) + o8(v[2])
|
2010-07-31 06:52:47 +04:00
|
|
|
|
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
|
|
|
self.palette = b"".join(self.palette)
|
2010-07-31 06:52:47 +04:00
|
|
|
|
|
|
|
def getpalette(self):
|
|
|
|
|
|
|
|
return self.palette, self.rawmode
|