Parser for an obscure FMV file format: bin files from the game
"The Amazing Spider-Man vs. The Kingpin" (Sega CD)

Author: Mike Melanson
Creation date: 2006-09-30
File samples: http://samples.mplayerhq.hu/game-formats/spiderman-segacd-bin/

from hachoir_parser import Parser
from hachoir_core.field import FieldSet, UInt32, String, RawBytes
from hachoir_core.endian import BIG_ENDIAN
from hachoir_core.text_handler import textHandler, hexadecimal

class Chunk(FieldSet):
    tag_info = {
        "CONF" : ("conf[]", None, "Configuration header"),
        "AUDI" : ("audio[]", None, "Audio chunk"),
        "SYNC" : ("sync[]", None, "Start of video frame data"),
        "IVRA" : ("ivra[]", None, "Vector codebook (?)"),
        "VRAM" : ("video[]", None, "Video RAM tile pattern"),
        "CRAM" : ("color[]", None, "Color RAM (palette)"),
        "CEND" : ("video_end[]", None, "End of video data"),
        "MEND" : ("end_file", None, "End of file"),

    def __init__(self, *args):
        FieldSet.__init__(self, *args)
        self._size = self["length"].value * 8
        fourcc = self["fourcc"].value
        if fourcc in self.tag_info:
            self._name, self._parser, self._description = self.tag_info[fourcc]
            self._parser = None
            self._description = "Unknown chunk: fourcc %s" % self["fourcc"].display

    def createFields(self):
        yield String(self, "fourcc", 4, "FourCC", charset="ASCII")
        yield textHandler(UInt32(self, "length", "length"), hexadecimal)
        size = self["length"].value - 8
        if 0 < size:
            if self._parser:
                for field in self._parser(self, size):
                    yield field
                yield RawBytes(self, "data", size)

class SpiderManVideoFile(Parser):
        "id": "spiderman_video",
        "category": "game",
        "file_ext": ("bin",),
        "min_size": 8*8,
        "description": "The Amazing Spider-Man vs. The Kingpin (Sega CD) FMV video"

    endian = BIG_ENDIAN

    def validate(self):
        return (self.stream.readBytes(0, 4) == 'CONF')

    def createFields(self):
        while not self.eof:
            yield Chunk(self, "chunk[]")
hachoir-parser documentation built on Sept. 20, 2017, 5:30 p.m.