Zork PMV - Revision history

Sembiance: samples

2025-05-14T15:13:06Z

samples

← Older revision		Revision as of 08:13, 14 May 2025
Line 1:		Line 1:
	* Extensions: PMV		* Extensions: PMV
	* Decoder: [https://github.com/scummvm/scummvm/blob/master/engines/made/pmvplayer.cpp]		* Decoder: [https://github.com/scummvm/scummvm/blob/master/engines/made/pmvplayer.cpp]
			* Samples: {{DexvertSamples\|video/zorkPMVVideo}}

	This is a format used in [https://wiki.scummvm.org/index.php/MADE MADE engine] game <i>Return to Zork</i>.		This is a format used in [https://wiki.scummvm.org/index.php/MADE MADE engine] game <i>Return to Zork</i>.

Kostya: packed sections description

2024-09-17T15:15:12Z

packed sections description

← Older revision		Revision as of 08:15, 17 September 2024
Line 36:		Line 36:
	2 bytes - height		2 bytes - height
	2 bytes - block type data offset (from the image part start)		2 bytes - block type data offset (from the image part start)
	2 bytes - ~~unknown~~ (~~usually~~ 0 or 1)		2 bytes - block types packed flag (0 or 1)
	2 bytes - pixel data offset		2 bytes - pixel data offset
	2 bytes - ~~unknown~~ (~~usually~~ 0 or 1)		2 bytes - pixel data packed flag (0 or 1)
	2 bytes - mask data offset		2 bytes - mask data offset
	2 bytes - ~~unknown~~ (~~usually~~ 0 or 1)		2 bytes - mask data packed flag (0 or 1)
	2 bytes - size of opcodes buffer for single image row (e.g. 20 for 320-pixel width)		2 bytes - size of opcodes buffer for single image row (e.g. 20 for 320-pixel width)

Line 48:		Line 48:
	N*3 bytes - colour data		N*3 bytes - colour data
	<code>FF FF</code> means end of palette data.		<code>FF FF</code> means end of palette data.

			Frame data segments may be packed with simple RLE scheme signalled by the flag in the header. In that case positive byte value means number of byte to copy minus one and negative value means negated run length minus one (with the next byte being the colour value to repeat).

	==Video compression==		==Video compression==

Kostya: correct some details

2024-06-14T13:00:02Z

correct some details

← Older revision		Revision as of 06:00, 14 June 2024
Line 11:		Line 11:

	Header contents:		Header contents:
	2 bytes - ~~frame~~ delay ~~(1000 / fps)~~		2 bytes - delay between frames in milliseconds
	4 bytes - always zero?		4 bytes - always zero?
	2 bytes - number of frames		2 bytes - number of frames
Line 31:		Line 31:

	Image part header:		Image part header:
	8 bytes - unknown		4 bytes - image part size
			4 bytes - unknown
	2 bytes - width		2 bytes - width
	2 bytes - height		2 bytes - height
	2 bytes - block type data offset (from the image part start)		2 bytes - block type data offset (from the image part start)
	2 bytes - unknown		2 bytes - unknown (usually 0 or 1)
	2 bytes - pixel data offset		2 bytes - pixel data offset
	2 bytes - unknown		2 bytes - unknown (usually 0 or 1)
	2 bytes - mask data offset		2 bytes - mask data offset
	2 bytes - ~~stride~~		2 bytes - unknown (usually 0 or 1)
			2 bytes - size of opcodes buffer for single image row (e.g. 20 for 320-pixel width)

	Palette data ~~stored in form of~~ updates telling at which offset and how many colours to update:		Palette data starts with "PALT" and 32-bit data sized followed by updates telling at which offset and how many colours to update:
	1 byte - number of colours		1 byte - number of colours minus one
	1 byte - start colour ~~(255, 255 means end of palette update data)~~		1 byte - start colour
	N*3 bytes - colour data		N*3 bytes - colour data
			<code>FF FF</code> means end of palette data.

	==Video compression==		==Video compression==
Line 50:		Line 53:

	Block types are stored in two-bit variables:		Block types are stored in two-bit variables:
	* 0 - ~~raw~~ block (read 16 pixels from the pixel data part)		* 0 - fill block (read one pixels from the pixel data part and fill block with it)
	* 1 - two-colour block (read 2 pixels from the pixel data part and 16-bit mask from the mask data part, arrange pixels using mask)		* 1 - two-colour block (read 2 pixels from the pixel data part and 16-bit mask from the mask data part, arrange pixels using mask)
	* 2 - four-colour block (read 4 pixels and 32-bit mask for sixteen 2-bit colour indices)		* 2 - four-colour block (read 4 pixels and 32-bit mask for sixteen 2-bit colour indices)
	* 3 - skipped block		* 3 - skipped block

			Masks are little-endian and read LSB first.

	==Audio compression==		==Audio compression==

Kostya: Created page with "* Extensions: PMV * Decoder: [https://github.com/scummvm/scummvm/blob/master/engines/made/pmvplayer.cpp] This is a format used in [https://wiki.scummvm.org/index.php/MADE MAD..."

2021-02-28T17:50:08Z

Created page with "* Extensions: PMV * Decoder: [https://github.com/scummvm/scummvm/blob/master/engines/made/pmvplayer.cpp] This is a format used in [https://wiki.scummvm.org/index.php/MADE MAD..."

New page

* Extensions: PMV
* Decoder: [https://github.com/scummvm/scummvm/blob/master/engines/made/pmvplayer.cpp]

This is a format used in [https://wiki.scummvm.org/index.php/MADE MADE engine] game <i>Return to Zork</i>.

==Container format==
Data is organised into chunks with 32-bit payload length following the 4-byte chunk identifier:
* <code>MOVE</code> - root chunk
* <code>MHED</code> - header
* <code>MFRM</code> - frame chunk

Header contents:
2 bytes - frame delay (1000 / fps)
4 bytes - always zero?
2 bytes - number of frames
4 bytes - always zero?
2 bytes - sample rate
44 bytes - unknown 16-bit words
768 bytes - palette

Frame chunk header:
8 bytes - unknown
4 bytes - audio data offset (from the chunk ID, not from payload start)
4 bytes - image data offset
4 bytes - palette data offset (if present)

Audio part header:
4 bytes - unknown
2 bytes - single chunk size in samples
2 bytes - number of chunks

Image part header:
8 bytes - unknown
2 bytes - width
2 bytes - height
2 bytes - block type data offset (from the image part start)
2 bytes - unknown
2 bytes - pixel data offset
2 bytes - unknown
2 bytes - mask data offset
2 bytes - stride

Palette data stored in form of updates telling at which offset and how many colours to update:
1 byte - number of colours
1 byte - start colour (255, 255 means end of palette update data)
N*3 bytes - colour data

==Video compression==
Video is compressed using vector quantisation for 4x4 blocks with various data elements grouped together (command/block type, raw pixels, pixel masks).

Block types are stored in two-bit variables:
* 0 - raw block (read 16 pixels from the pixel data part)
* 1 - two-colour block (read 2 pixels from the pixel data part and 16-bit mask from the mask data part, arrange pixels using mask)
* 2 - four-colour block (read 4 pixels and 32-bit mask for sixteen 2-bit colour indices)
* 3 - skipped block

==Audio compression==
Each audio chunk starts with a byte telling how it should be decoded:
* bits 0-3 - compression type
* bits 6-7 - modifier (1 - decode every odd sample, linearly interpolate every even sample from them, 2 - decode and use for interpolation every fourth sample)

Compression types:
* 0 - zero output
* 1 - no change
* 2-4 - read 2/4/16 U8 samples to delta buffer, for every sample read 1/2/4-bit index, use corresponding delta value to update the previous sample with clipping
* 5 - raw unsigned 8-bit audio data

[[Category:Game Formats]]
[[Category:Video Codecs]]