FliImagePlugin.py 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. #
  2. # The Python Imaging Library.
  3. # $Id$
  4. #
  5. # FLI/FLC file handling.
  6. #
  7. # History:
  8. # 95-09-01 fl Created
  9. # 97-01-03 fl Fixed parser, setup decoder tile
  10. # 98-07-15 fl Renamed offset attribute to avoid name clash
  11. #
  12. # Copyright (c) Secret Labs AB 1997-98.
  13. # Copyright (c) Fredrik Lundh 1995-97.
  14. #
  15. # See the README file for information on usage and redistribution.
  16. #
  17. from __future__ import annotations
  18. import os
  19. from . import Image, ImageFile, ImagePalette
  20. from ._binary import i16le as i16
  21. from ._binary import i32le as i32
  22. from ._binary import o8
  23. from ._util import DeferredError
  24. #
  25. # decoder
  26. def _accept(prefix: bytes) -> bool:
  27. return (
  28. len(prefix) >= 6
  29. and i16(prefix, 4) in [0xAF11, 0xAF12]
  30. and i16(prefix, 14) in [0, 3] # flags
  31. )
  32. ##
  33. # Image plugin for the FLI/FLC animation format. Use the <b>seek</b>
  34. # method to load individual frames.
  35. class FliImageFile(ImageFile.ImageFile):
  36. format = "FLI"
  37. format_description = "Autodesk FLI/FLC Animation"
  38. _close_exclusive_fp_after_loading = False
  39. def _open(self) -> None:
  40. # HEAD
  41. s = self.fp.read(128)
  42. if not (_accept(s) and s[20:22] == b"\x00\x00"):
  43. msg = "not an FLI/FLC file"
  44. raise SyntaxError(msg)
  45. # frames
  46. self.n_frames = i16(s, 6)
  47. self.is_animated = self.n_frames > 1
  48. # image characteristics
  49. self._mode = "P"
  50. self._size = i16(s, 8), i16(s, 10)
  51. # animation speed
  52. duration = i32(s, 16)
  53. magic = i16(s, 4)
  54. if magic == 0xAF11:
  55. duration = (duration * 1000) // 70
  56. self.info["duration"] = duration
  57. # look for palette
  58. palette = [(a, a, a) for a in range(256)]
  59. s = self.fp.read(16)
  60. self.__offset = 128
  61. if i16(s, 4) == 0xF100:
  62. # prefix chunk; ignore it
  63. self.__offset = self.__offset + i32(s)
  64. self.fp.seek(self.__offset)
  65. s = self.fp.read(16)
  66. if i16(s, 4) == 0xF1FA:
  67. # look for palette chunk
  68. number_of_subchunks = i16(s, 6)
  69. chunk_size: int | None = None
  70. for _ in range(number_of_subchunks):
  71. if chunk_size is not None:
  72. self.fp.seek(chunk_size - 6, os.SEEK_CUR)
  73. s = self.fp.read(6)
  74. chunk_type = i16(s, 4)
  75. if chunk_type in (4, 11):
  76. self._palette(palette, 2 if chunk_type == 11 else 0)
  77. break
  78. chunk_size = i32(s)
  79. if not chunk_size:
  80. break
  81. self.palette = ImagePalette.raw(
  82. "RGB", b"".join(o8(r) + o8(g) + o8(b) for (r, g, b) in palette)
  83. )
  84. # set things up to decode first frame
  85. self.__frame = -1
  86. self._fp = self.fp
  87. self.__rewind = self.fp.tell()
  88. self.seek(0)
  89. def _palette(self, palette: list[tuple[int, int, int]], shift: int) -> None:
  90. # load palette
  91. i = 0
  92. for e in range(i16(self.fp.read(2))):
  93. s = self.fp.read(2)
  94. i = i + s[0]
  95. n = s[1]
  96. if n == 0:
  97. n = 256
  98. s = self.fp.read(n * 3)
  99. for n in range(0, len(s), 3):
  100. r = s[n] << shift
  101. g = s[n + 1] << shift
  102. b = s[n + 2] << shift
  103. palette[i] = (r, g, b)
  104. i += 1
  105. def seek(self, frame: int) -> None:
  106. if not self._seek_check(frame):
  107. return
  108. if frame < self.__frame:
  109. self._seek(0)
  110. for f in range(self.__frame + 1, frame + 1):
  111. self._seek(f)
  112. def _seek(self, frame: int) -> None:
  113. if isinstance(self._fp, DeferredError):
  114. raise self._fp.ex
  115. if frame == 0:
  116. self.__frame = -1
  117. self._fp.seek(self.__rewind)
  118. self.__offset = 128
  119. else:
  120. # ensure that the previous frame was loaded
  121. self.load()
  122. if frame != self.__frame + 1:
  123. msg = f"cannot seek to frame {frame}"
  124. raise ValueError(msg)
  125. self.__frame = frame
  126. # move to next frame
  127. self.fp = self._fp
  128. self.fp.seek(self.__offset)
  129. s = self.fp.read(4)
  130. if not s:
  131. msg = "missing frame size"
  132. raise EOFError(msg)
  133. framesize = i32(s)
  134. self.decodermaxblock = framesize
  135. self.tile = [ImageFile._Tile("fli", (0, 0) + self.size, self.__offset)]
  136. self.__offset += framesize
  137. def tell(self) -> int:
  138. return self.__frame
  139. #
  140. # registry
  141. Image.register_open(FliImageFile.format, FliImageFile, _accept)
  142. Image.register_extensions(FliImageFile.format, [".fli", ".flc"])