PsdImagePlugin.py 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332
  1. #
  2. # The Python Imaging Library
  3. # $Id$
  4. #
  5. # Adobe PSD 2.5/3.0 file handling
  6. #
  7. # History:
  8. # 1995-09-01 fl Created
  9. # 1997-01-03 fl Read most PSD images
  10. # 1997-01-18 fl Fixed P and CMYK support
  11. # 2001-10-21 fl Added seek/tell support (for layers)
  12. #
  13. # Copyright (c) 1997-2001 by Secret Labs AB.
  14. # Copyright (c) 1995-2001 by Fredrik Lundh
  15. #
  16. # See the README file for information on usage and redistribution.
  17. #
  18. from __future__ import annotations
  19. import io
  20. from functools import cached_property
  21. from typing import IO
  22. from . import Image, ImageFile, ImagePalette
  23. from ._binary import i8
  24. from ._binary import i16be as i16
  25. from ._binary import i32be as i32
  26. from ._binary import si16be as si16
  27. from ._binary import si32be as si32
  28. MODES = {
  29. # (photoshop mode, bits) -> (pil mode, required channels)
  30. (0, 1): ("1", 1),
  31. (0, 8): ("L", 1),
  32. (1, 8): ("L", 1),
  33. (2, 8): ("P", 1),
  34. (3, 8): ("RGB", 3),
  35. (4, 8): ("CMYK", 4),
  36. (7, 8): ("L", 1), # FIXME: multilayer
  37. (8, 8): ("L", 1), # duotone
  38. (9, 8): ("LAB", 3),
  39. }
  40. # --------------------------------------------------------------------.
  41. # read PSD images
  42. def _accept(prefix: bytes) -> bool:
  43. return prefix[:4] == b"8BPS"
  44. ##
  45. # Image plugin for Photoshop images.
  46. class PsdImageFile(ImageFile.ImageFile):
  47. format = "PSD"
  48. format_description = "Adobe Photoshop"
  49. _close_exclusive_fp_after_loading = False
  50. def _open(self) -> None:
  51. read = self.fp.read
  52. #
  53. # header
  54. s = read(26)
  55. if not _accept(s) or i16(s, 4) != 1:
  56. msg = "not a PSD file"
  57. raise SyntaxError(msg)
  58. psd_bits = i16(s, 22)
  59. psd_channels = i16(s, 12)
  60. psd_mode = i16(s, 24)
  61. mode, channels = MODES[(psd_mode, psd_bits)]
  62. if channels > psd_channels:
  63. msg = "not enough channels"
  64. raise OSError(msg)
  65. if mode == "RGB" and psd_channels == 4:
  66. mode = "RGBA"
  67. channels = 4
  68. self._mode = mode
  69. self._size = i32(s, 18), i32(s, 14)
  70. #
  71. # color mode data
  72. size = i32(read(4))
  73. if size:
  74. data = read(size)
  75. if mode == "P" and size == 768:
  76. self.palette = ImagePalette.raw("RGB;L", data)
  77. #
  78. # image resources
  79. self.resources = []
  80. size = i32(read(4))
  81. if size:
  82. # load resources
  83. end = self.fp.tell() + size
  84. while self.fp.tell() < end:
  85. read(4) # signature
  86. id = i16(read(2))
  87. name = read(i8(read(1)))
  88. if not (len(name) & 1):
  89. read(1) # padding
  90. data = read(i32(read(4)))
  91. if len(data) & 1:
  92. read(1) # padding
  93. self.resources.append((id, name, data))
  94. if id == 1039: # ICC profile
  95. self.info["icc_profile"] = data
  96. #
  97. # layer and mask information
  98. self._layers_position = None
  99. size = i32(read(4))
  100. if size:
  101. end = self.fp.tell() + size
  102. size = i32(read(4))
  103. if size:
  104. self._layers_position = self.fp.tell()
  105. self._layers_size = size
  106. self.fp.seek(end)
  107. self._n_frames: int | None = None
  108. #
  109. # image descriptor
  110. self.tile = _maketile(self.fp, mode, (0, 0) + self.size, channels)
  111. # keep the file open
  112. self._fp = self.fp
  113. self.frame = 1
  114. self._min_frame = 1
  115. @cached_property
  116. def layers(
  117. self,
  118. ) -> list[tuple[str, str, tuple[int, int, int, int], list[ImageFile._Tile]]]:
  119. layers = []
  120. if self._layers_position is not None:
  121. self._fp.seek(self._layers_position)
  122. _layer_data = io.BytesIO(ImageFile._safe_read(self._fp, self._layers_size))
  123. layers = _layerinfo(_layer_data, self._layers_size)
  124. self._n_frames = len(layers)
  125. return layers
  126. @property
  127. def n_frames(self) -> int:
  128. if self._n_frames is None:
  129. self._n_frames = len(self.layers)
  130. return self._n_frames
  131. @property
  132. def is_animated(self) -> bool:
  133. return len(self.layers) > 1
  134. def seek(self, layer: int) -> None:
  135. if not self._seek_check(layer):
  136. return
  137. # seek to given layer (1..max)
  138. try:
  139. _, mode, _, tile = self.layers[layer - 1]
  140. self._mode = mode
  141. self.tile = tile
  142. self.frame = layer
  143. self.fp = self._fp
  144. except IndexError as e:
  145. msg = "no such layer"
  146. raise EOFError(msg) from e
  147. def tell(self) -> int:
  148. # return layer number (0=image, 1..max=layers)
  149. return self.frame
  150. def _layerinfo(
  151. fp: IO[bytes], ct_bytes: int
  152. ) -> list[tuple[str, str, tuple[int, int, int, int], list[ImageFile._Tile]]]:
  153. # read layerinfo block
  154. layers = []
  155. def read(size: int) -> bytes:
  156. return ImageFile._safe_read(fp, size)
  157. ct = si16(read(2))
  158. # sanity check
  159. if ct_bytes < (abs(ct) * 20):
  160. msg = "Layer block too short for number of layers requested"
  161. raise SyntaxError(msg)
  162. for _ in range(abs(ct)):
  163. # bounding box
  164. y0 = si32(read(4))
  165. x0 = si32(read(4))
  166. y1 = si32(read(4))
  167. x1 = si32(read(4))
  168. # image info
  169. bands = []
  170. ct_types = i16(read(2))
  171. if ct_types > 4:
  172. fp.seek(ct_types * 6 + 12, io.SEEK_CUR)
  173. size = i32(read(4))
  174. fp.seek(size, io.SEEK_CUR)
  175. continue
  176. for _ in range(ct_types):
  177. type = i16(read(2))
  178. if type == 65535:
  179. b = "A"
  180. else:
  181. b = "RGBA"[type]
  182. bands.append(b)
  183. read(4) # size
  184. # figure out the image mode
  185. bands.sort()
  186. if bands == ["R"]:
  187. mode = "L"
  188. elif bands == ["B", "G", "R"]:
  189. mode = "RGB"
  190. elif bands == ["A", "B", "G", "R"]:
  191. mode = "RGBA"
  192. else:
  193. mode = "" # unknown
  194. # skip over blend flags and extra information
  195. read(12) # filler
  196. name = ""
  197. size = i32(read(4)) # length of the extra data field
  198. if size:
  199. data_end = fp.tell() + size
  200. length = i32(read(4))
  201. if length:
  202. fp.seek(length - 16, io.SEEK_CUR)
  203. length = i32(read(4))
  204. if length:
  205. fp.seek(length, io.SEEK_CUR)
  206. length = i8(read(1))
  207. if length:
  208. # Don't know the proper encoding,
  209. # Latin-1 should be a good guess
  210. name = read(length).decode("latin-1", "replace")
  211. fp.seek(data_end)
  212. layers.append((name, mode, (x0, y0, x1, y1)))
  213. # get tiles
  214. layerinfo = []
  215. for i, (name, mode, bbox) in enumerate(layers):
  216. tile = []
  217. for m in mode:
  218. t = _maketile(fp, m, bbox, 1)
  219. if t:
  220. tile.extend(t)
  221. layerinfo.append((name, mode, bbox, tile))
  222. return layerinfo
  223. def _maketile(
  224. file: IO[bytes], mode: str, bbox: tuple[int, int, int, int], channels: int
  225. ) -> list[ImageFile._Tile]:
  226. tiles = []
  227. read = file.read
  228. compression = i16(read(2))
  229. xsize = bbox[2] - bbox[0]
  230. ysize = bbox[3] - bbox[1]
  231. offset = file.tell()
  232. if compression == 0:
  233. #
  234. # raw compression
  235. for channel in range(channels):
  236. layer = mode[channel]
  237. if mode == "CMYK":
  238. layer += ";I"
  239. tiles.append(ImageFile._Tile("raw", bbox, offset, layer))
  240. offset = offset + xsize * ysize
  241. elif compression == 1:
  242. #
  243. # packbits compression
  244. i = 0
  245. bytecount = read(channels * ysize * 2)
  246. offset = file.tell()
  247. for channel in range(channels):
  248. layer = mode[channel]
  249. if mode == "CMYK":
  250. layer += ";I"
  251. tiles.append(ImageFile._Tile("packbits", bbox, offset, layer))
  252. for y in range(ysize):
  253. offset = offset + i16(bytecount, i)
  254. i += 2
  255. file.seek(offset)
  256. if offset & 1:
  257. read(1) # padding
  258. return tiles
  259. # --------------------------------------------------------------------
  260. # registry
  261. Image.register_open(PsdImageFile.format, PsdImageFile, _accept)
  262. Image.register_extension(PsdImageFile.format, ".psd")
  263. Image.register_mime(PsdImageFile.format, "image/vnd.adobe.photoshop")