PsdImagePlugin.py 8.5 KB

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