Buckets:
| # | |
| # The Python Imaging Library. | |
| # | |
| # QOI support for PIL | |
| # | |
| # See the README file for information on usage and redistribution. | |
| # | |
| from __future__ import annotations | |
| import os | |
| from typing import IO | |
| from . import Image, ImageFile | |
| from ._binary import i32be as i32 | |
| from ._binary import o8 | |
| from ._binary import o32be as o32 | |
| def _accept(prefix: bytes) -> bool: | |
| return prefix.startswith(b"qoif") | |
| class QoiImageFile(ImageFile.ImageFile): | |
| format = "QOI" | |
| format_description = "Quite OK Image" | |
| def _open(self) -> None: | |
| assert self.fp is not None | |
| if not _accept(self.fp.read(4)): | |
| msg = "not a QOI file" | |
| raise SyntaxError(msg) | |
| self._size = i32(self.fp.read(4)), i32(self.fp.read(4)) | |
| channels = self.fp.read(1)[0] | |
| self._mode = "RGB" if channels == 3 else "RGBA" | |
| self.fp.seek(1, os.SEEK_CUR) # colorspace | |
| self.tile = [ImageFile._Tile("qoi", (0, 0) + self._size, self.fp.tell())] | |
| class QoiDecoder(ImageFile.PyDecoder): | |
| _pulls_fd = True | |
| _previous_pixel: bytes | bytearray | None = None | |
| _previously_seen_pixels: dict[int, bytes | bytearray] = {} | |
| def _add_to_previous_pixels(self, value: bytes | bytearray) -> None: | |
| self._previous_pixel = value | |
| r, g, b, a = value | |
| hash_value = (r * 3 + g * 5 + b * 7 + a * 11) % 64 | |
| self._previously_seen_pixels[hash_value] = value | |
| def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]: | |
| assert self.fd is not None | |
| self._previously_seen_pixels = {} | |
| self._previous_pixel = bytearray((0, 0, 0, 255)) | |
| data = bytearray() | |
| bands = Image.getmodebands(self.mode) | |
| dest_length = self.state.xsize * self.state.ysize * bands | |
| while len(data) < dest_length: | |
| byte = self.fd.read(1)[0] | |
| value: bytes | bytearray | |
| if byte == 0b11111110 and self._previous_pixel: # QOI_OP_RGB | |
| value = bytearray(self.fd.read(3)) + self._previous_pixel[3:] | |
| elif byte == 0b11111111: # QOI_OP_RGBA | |
| value = self.fd.read(4) | |
| else: | |
| op = byte >> 6 | |
| if op == 0: # QOI_OP_INDEX | |
| op_index = byte & 0b00111111 | |
| value = self._previously_seen_pixels.get( | |
| op_index, bytearray((0, 0, 0, 0)) | |
| ) | |
| elif op == 1 and self._previous_pixel: # QOI_OP_DIFF | |
| value = bytearray( | |
| ( | |
| (self._previous_pixel[0] + ((byte & 0b00110000) >> 4) - 2) | |
| % 256, | |
| (self._previous_pixel[1] + ((byte & 0b00001100) >> 2) - 2) | |
| % 256, | |
| (self._previous_pixel[2] + (byte & 0b00000011) - 2) % 256, | |
| self._previous_pixel[3], | |
| ) | |
| ) | |
| elif op == 2 and self._previous_pixel: # QOI_OP_LUMA | |
| second_byte = self.fd.read(1)[0] | |
| diff_green = (byte & 0b00111111) - 32 | |
| diff_red = ((second_byte & 0b11110000) >> 4) - 8 | |
| diff_blue = (second_byte & 0b00001111) - 8 | |
| value = bytearray( | |
| tuple( | |
| (self._previous_pixel[i] + diff_green + diff) % 256 | |
| for i, diff in enumerate((diff_red, 0, diff_blue)) | |
| ) | |
| ) | |
| value += self._previous_pixel[3:] | |
| elif op == 3 and self._previous_pixel: # QOI_OP_RUN | |
| run_length = (byte & 0b00111111) + 1 | |
| value = self._previous_pixel | |
| if bands == 3: | |
| value = value[:3] | |
| data += value * run_length | |
| continue | |
| self._add_to_previous_pixels(value) | |
| if bands == 3: | |
| value = value[:3] | |
| data += value | |
| self.set_as_raw(data) | |
| return -1, 0 | |
| def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None: | |
| if im.mode == "RGB": | |
| channels = 3 | |
| elif im.mode == "RGBA": | |
| channels = 4 | |
| else: | |
| msg = "Unsupported QOI image mode" | |
| raise ValueError(msg) | |
| colorspace = 0 if im.encoderinfo.get("colorspace") == "sRGB" else 1 | |
| fp.write(b"qoif") | |
| fp.write(o32(im.size[0])) | |
| fp.write(o32(im.size[1])) | |
| fp.write(o8(channels)) | |
| fp.write(o8(colorspace)) | |
| ImageFile._save(im, fp, [ImageFile._Tile("qoi", (0, 0) + im.size)]) | |
| class QoiEncoder(ImageFile.PyEncoder): | |
| _pushes_fd = True | |
| _previous_pixel: tuple[int, int, int, int] | None = None | |
| _previously_seen_pixels: dict[int, tuple[int, int, int, int]] = {} | |
| _run = 0 | |
| def _write_run(self) -> bytes: | |
| data = o8(0b11000000 | (self._run - 1)) # QOI_OP_RUN | |
| self._run = 0 | |
| return data | |
| def _delta(self, left: int, right: int) -> int: | |
| result = (left - right) & 255 | |
| if result >= 128: | |
| result -= 256 | |
| return result | |
| def encode(self, bufsize: int) -> tuple[int, int, bytes]: | |
| assert self.im is not None | |
| self._previously_seen_pixels = {0: (0, 0, 0, 0)} | |
| self._previous_pixel = (0, 0, 0, 255) | |
| data = bytearray() | |
| w, h = self.im.size | |
| bands = Image.getmodebands(self.mode) | |
| for y in range(h): | |
| for x in range(w): | |
| pixel = self.im.getpixel((x, y)) | |
| if bands == 3: | |
| pixel = (*pixel, 255) | |
| if pixel == self._previous_pixel: | |
| self._run += 1 | |
| if self._run == 62: | |
| data += self._write_run() | |
| else: | |
| if self._run: | |
| data += self._write_run() | |
| r, g, b, a = pixel | |
| hash_value = (r * 3 + g * 5 + b * 7 + a * 11) % 64 | |
| if self._previously_seen_pixels.get(hash_value) == pixel: | |
| data += o8(hash_value) # QOI_OP_INDEX | |
| elif self._previous_pixel: | |
| self._previously_seen_pixels[hash_value] = pixel | |
| prev_r, prev_g, prev_b, prev_a = self._previous_pixel | |
| if prev_a == a: | |
| delta_r = self._delta(r, prev_r) | |
| delta_g = self._delta(g, prev_g) | |
| delta_b = self._delta(b, prev_b) | |
| if ( | |
| -2 <= delta_r < 2 | |
| and -2 <= delta_g < 2 | |
| and -2 <= delta_b < 2 | |
| ): | |
| data += o8( | |
| 0b01000000 | |
| | (delta_r + 2) << 4 | |
| | (delta_g + 2) << 2 | |
| | (delta_b + 2) | |
| ) # QOI_OP_DIFF | |
| else: | |
| delta_gr = self._delta(delta_r, delta_g) | |
| delta_gb = self._delta(delta_b, delta_g) | |
| if ( | |
| -8 <= delta_gr < 8 | |
| and -32 <= delta_g < 32 | |
| and -8 <= delta_gb < 8 | |
| ): | |
| data += o8( | |
| 0b10000000 | (delta_g + 32) | |
| ) # QOI_OP_LUMA | |
| data += o8((delta_gr + 8) << 4 | (delta_gb + 8)) | |
| else: | |
| data += o8(0b11111110) # QOI_OP_RGB | |
| data += bytes(pixel[:3]) | |
| else: | |
| data += o8(0b11111111) # QOI_OP_RGBA | |
| data += bytes(pixel) | |
| self._previous_pixel = pixel | |
| if self._run: | |
| data += self._write_run() | |
| data += bytes((0, 0, 0, 0, 0, 0, 0, 1)) # padding | |
| return len(data), 0, data | |
| Image.register_open(QoiImageFile.format, QoiImageFile, _accept) | |
| Image.register_decoder("qoi", QoiDecoder) | |
| Image.register_extension(QoiImageFile.format, ".qoi") | |
| Image.register_save(QoiImageFile.format, _save) | |
| Image.register_encoder("qoi", QoiEncoder) | |
Xet Storage Details
- Size:
- 8.61 kB
- Xet hash:
- a404eb519fc3cd6b19f33ec8ed0de75a6975cbfae8f2954d76453bc464a78869
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.