# # The Python Imaging Library. # # MSP file handling # # This is the format used by the Paint program in Windows 1 and 2. # # History: # 95-09-05 fl Created # 97-01-03 fl Read/write MSP images # 17-02-21 es Fixed RLE interpretation # # Copyright (c) Secret Labs AB 1997. # Copyright (c) Fredrik Lundh 1995-97. # Copyright (c) Eric Soroos 2017. # # See the README file for information on usage and redistribution. # # More info on this format: https://archive.org/details/gg243631 # Page 313: # Figure 205. Windows Paint Version 1: "DanM" Format # Figure 206. Windows Paint Version 2: "LinS" Format. Used in Windows V2.03 # # See also: http://www.fileformat.info/format/mspaint/egff.htm from . import Image, ImageFile from ._binary import i16le as i16, o16le as o16, i8 import struct import io __version__ = "0.1" # # read MSP files def _accept(prefix): return prefix[:4] in [b"DanM", b"LinS"] ## # Image plugin for Windows MSP images. This plugin supports both # uncompressed (Windows 1.0). class MspImageFile(ImageFile.ImageFile): format = "MSP" format_description = "Windows Paint" def _open(self): # Header s = self.fp.read(32) if s[:4] not in [b"DanM", b"LinS"]: raise SyntaxError("not an MSP file") # Header checksum checksum = 0 for i in range(0, 32, 2): checksum = checksum ^ i16(s[i:i+2]) if checksum != 0: raise SyntaxError("bad MSP checksum") self.mode = "1" self.size = i16(s[4:]), i16(s[6:]) if s[:4] == b"DanM": self.tile = [("raw", (0, 0)+self.size, 32, ("1", 0, 1))] else: self.tile = [("MSP", (0, 0)+self.size, 32, None)] class MspDecoder(ImageFile.PyDecoder): # The algo for the MSP decoder is from # http://www.fileformat.info/format/mspaint/egff.htm # cc-by-attribution -- That page references is taken from the # Encyclopedia of Graphics File Formats and is licensed by # O'Reilly under the Creative Common/Attribution license # # For RLE encoded files, the 32byte header is followed by a scan # line map, encoded as one 16bit word of encoded byte length per # line. # # NOTE: the encoded length of the line can be 0. This was not # handled in the previous version of this encoder, and there's no # mention of how to handle it in the documentation. From the few # examples I've seen, I've assumed that it is a fill of the # background color, in this case, white. # # # Pseudocode of the decoder: # Read a BYTE value as the RunType # If the RunType value is zero # Read next byte as the RunCount # Read the next byte as the RunValue # Write the RunValue byte RunCount times # If the RunType value is non-zero # Use this value as the RunCount # Read and write the next RunCount bytes literally # # e.g.: # 0x00 03 ff 05 00 01 02 03 04 # would yield the bytes: # 0xff ff ff 00 01 02 03 04 # # which are then interpreted as a bit packed mode '1' image _pulls_fd = True def decode(self, buffer): img = io.BytesIO() blank_line = bytearray((0xff,)*((self.state.xsize+7)//8)) try: self.fd.seek(32) rowmap = struct.unpack_from("<%dH" % (self.state.ysize), self.fd.read(self.state.ysize*2)) except struct.error: raise IOError("Truncated MSP file in row map") for x, rowlen in enumerate(rowmap): try: if rowlen == 0: img.write(blank_line) continue row = self.fd.read(rowlen) if len(row) != rowlen: raise IOError( "Truncated MSP file, expected %d bytes on row %s", (rowlen, x)) idx = 0 while idx < rowlen: runtype = i8(row[idx]) idx += 1 if runtype == 0: (runcount, runval) = struct.unpack_from("Bc", row, idx) img.write(runval * runcount) idx += 2 else: runcount = runtype img.write(row[idx:idx+runcount]) idx += runcount except struct.error: raise IOError("Corrupted MSP file in row %d" % x) self.set_as_raw(img.getvalue(), ("1", 0, 1)) return 0, 0 Image.register_decoder('MSP', MspDecoder) # # write MSP files (uncompressed only) def _save(im, fp, filename): if im.mode != "1": raise IOError("cannot write mode %s as MSP" % im.mode) # create MSP header header = [0] * 16 header[0], header[1] = i16(b"Da"), i16(b"nM") # version 1 header[2], header[3] = im.size header[4], header[5] = 1, 1 header[6], header[7] = 1, 1 header[8], header[9] = im.size checksum = 0 for h in header: checksum = checksum ^ h header[12] = checksum # FIXME: is this the right field? # header for h in header: fp.write(o16(h)) # image body ImageFile._save(im, fp, [("raw", (0, 0)+im.size, 32, ("1", 0, 1))]) # # registry Image.register_open(MspImageFile.format, MspImageFile, _accept) Image.register_save(MspImageFile.format, _save) Image.register_extension(MspImageFile.format, ".msp")