Duck TrueMotion 1 - Revision history

Kostya: fill the missing bits

2023-07-21T16:10:06Z

fill the missing bits

← Older revision		Revision as of 09:10, 21 July 2023
Line 69:		Line 69:
	decoded_header[i - 1] = buffer[i] ^ buffer[i + 1];		decoded_header[i - 1] = buffer[i] ^ buffer[i + 1];

	The decoded header data structure is laid out as follows:		The decoded header data structure is laid out as follows (depending on the version and header type not all of the subsequent fields may be present though):

	byte 0 compression method		byte 0 compression method
Line 101:		Line 101:
	14: 24-bit 2x4 (H)		14: 24-bit 2x4 (H)
	16: 24-bit 2x2 (H)		16: 24-bit 2x2 (H)
	>16: invalid compression type		>16: invalid compression type (or TrueMotion RT)

	The (H) and (V) designations come from the original Duck source code. It is unclear what they mean, except for the common horizontal and vertical designations common in video terminology.		The (H) and (V) designations come from the original Duck source code. It is unclear what they mean, except for the common horizontal and vertical designations common in video terminology.
Line 113:		Line 113:
	If the version field is less than 2, then the frame is intracoded (this may indicate that early versions of the coding method was purely intracoded). If the version field is greater than or equal to 2, then if the header type field is 2 or 3, the flags field has bit 4 set (flags & 0x10) to indicate an intraframe; else if the header type field is greater than 3, then the header is invalid; else the frame is intracoded.		If the version field is less than 2, then the frame is intracoded (this may indicate that early versions of the coding method was purely intracoded). If the version field is greater than or equal to 2, then if the header type field is 2 or 3, the flags field has bit 4 set (flags & 0x10) to indicate an intraframe; else if the header type field is greater than 3, then the header is invalid; else the frame is intracoded.

	The ~~purpose of the~~ control field ~~is unclear~~.		The control field contains the information for which platform the video file was mastered (e.g. PC or SEGA console).

	The x & y offset, width, and height fields ~~apparently~~ pertain to a sprite mode ~~that is not covered in this document~~.		The x & y offset, width, and height fields pertain to a sprite mode.

	== 16-bit Data ==		== Overall frame coding ==
			Frame is split into 4x4 pixel blocks (or 2x4 pixel blocks for 24-bit mode; each pixel should be repeated twice during the reconstruction phase). Depending on the coding mode, each block may contain 1-4 chroma deltas (for each sub-block) and luma deltas for each pixel. Data is still coded per-line though. Delta values obtained during compression are substituted with the values from the corresponding delta table (with possible escapes, more about them below), grouped into pairs and sent to the Tunstall code compressor with fixed codebook (i.e. the coding method that replaces a sequence of input codes with one fixed-width output value, TM1 codebooks replace sequences of 2-8 delta pairs with a single byte).

	~~Decoding~~ a ~~16-bit frame requires 2 tables~~. ~~The tables can change from one frame~~ to ~~the next~~ and ~~must be rebuilt if~~ the ~~header specified a new table~~. ~~One table contains~~ the ~~C predictors while~~ the ~~other contains the Y predictors~~.		In case the delta value is too large, it is coded as a sum of of small delta and escape delta value. In this case Tunstall coder flushes output sequence, sends zero byte to signal escape and codes delta indices for the escape values. In 16-bit mode those values are the ordinary delta values multiplied by five, in case of 24-bit coding they come from the so-called fat tables instead.

	~~Each table consists of 1024 32~~-bit entries. Each group of 4 entries corresponds to a byte index from 0..255. Each entry contains a double pixel predictor shifted left by one. If the very last bit (bit 0) in the 32-bit entry is 0, then there is another predictor for that index. If the last bit is 1, then this predictor is the last one for this list.		== 16-bit Data ==

	~~For example~~...		Deltas in 16-bit mode are applied to two pixels at once, so horizontal predictor contains two pixels as well. Luma delta pair codes deltas that should be applied to all components in the pixel, chroma delta codes deltas for red and blue components of the pixel pair (i.e. first delta codes red offset for both pixels, second delta codes blue offset for both pixels).

	~~A B C D ...~~		=== Sprite mode ===
	~~E F G H ...~~		Sprite mode augments 16-bit intra-only coding mode with 4x4 sub-blocks with some additional modes signalled by two bits per block. First bit tells whether the block is coded like the ordinary TM1 data, second bit signals that the block is either coded with the transparency information (transmitted as a delta pair right after luma delta pair) or that the block is completely transparent.
	~~I J K L ...~~
	~~M N O P .~~..

	~~'''(UNFINISHED)'''~~		A working implementation of sprite support can be found in NihAV: https://git.nihav.org/?p=nihav.git;a=blob;f=nihav-duck/src/codecs/truemotion1.rs;hb=HEAD

	== 24-bit Data ==		== 24-bit Data ==
			In 24-bit mode delta pairs code components of a single pixel. Because of the nature of the compression, deltas should be applied as a single 32-bit word to the <code>((R << 16) \| (G << 8) \| B)</code> packed pixel value. Luma delta pair should be unpacked as <code>((lo << 16) \| (lo << 8) \| hi)</code>, chroma delta pair should be unpacked as <code>((lo << 16) \| hi)</code>.
	~~The process of decoding a~~ 24-bit ~~frame is similar to that~~ of ~~decoding~~ a ~~16-bit frame~~. ~~However,~~ the ~~frame is decoded into 2 separate planes~~, ~~a Y plane and a C plane, and recombined into a final RGB map at render time.~~

	~~A working implementation of sprite support can~~ be ~~found in NihAV: https://git.nihav.org/?p=nihav.git;~~a~~=blob;f=nihav~~-~~duck~~/~~src~~/~~codecs~~/~~truemotion1~~.~~rs;hb=HEAD~~

	~~'''(UNFINISHED)'''~~

	== Duck TrueMotion v1 Tables ==		== Duck TrueMotion v1 Tables ==
	[https://github.com/FFmpeg/FFmpeg/blob/5541cffa17a8c45004e5ceeda52d4d6b2acee037/libavcodec/truemotion1.c FFmpeg implementation]		[https://github.com/FFmpeg/FFmpeg/blob/5541cffa17a8c45004e5ceeda52d4d6b2acee037/libavcodec/truemotion1.c FFmpeg implementation]



	== Games Using Duck TrueMotion 1 ==		== Games Using Duck TrueMotion 1 ==
Line 166:		Line 158:

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

Mahanstreamer: /* 24-bit Data */

2021-08-20T04:41:00Z

24-bit Data

← Older revision		Revision as of 21:41, 19 August 2021
Line 135:		Line 135:

	The process of decoding a 24-bit frame is similar to that of decoding a 16-bit frame. However, the frame is decoded into 2 separate planes, a Y plane and a C plane, and recombined into a final RGB map at render time.		The process of decoding a 24-bit frame is similar to that of decoding a 16-bit frame. However, the frame is decoded into 2 separate planes, a Y plane and a C plane, and recombined into a final RGB map at render time.

			A working implementation of sprite support can be found in NihAV: https://git.nihav.org/?p=nihav.git;a=blob;f=nihav-duck/src/codecs/truemotion1.rs;hb=HEAD

	'''(UNFINISHED)'''		'''(UNFINISHED)'''

Mahanstreamer: added sample server, some links

2021-08-14T03:04:14Z

added sample server, some links

Multimedia Mike: /* Games Using Duck TrueMotion 1 */ update known game list

2018-09-06T03:21:24Z

Games Using Duck TrueMotion 1: update known game list

← Older revision		Revision as of 20:21, 5 September 2018
Line 144:		Line 144:
	These software titles are known to use the Duck TrueMotion 1 video codec to encode full motion video:		These software titles are known to use the Duck TrueMotion 1 video codec to encode full motion video:

	* [~~http~~://www.mobygames.com/game/saturn/blazing-dragons Blazing Dragons (Sega Saturn)]		* [https://www.mobygames.com/game/bubble-bobble-also-featuring-rainbow-islandsBubble Bobble special CD release with Rainbow Island (DOS)]
	* Congo (Sega Saturn)		* [https://www.mobygames.com/game/saturn/blazing-dragons Blazing Dragons (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/saturn/horde The Horde (Sega Saturn)]		* [https://www.mobygames.com/game/sega-saturn/congo-the-movie-the-lost-city-of-zinj Congo: The Movie - The Lost City of Zinj (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/saturn/nhl-all-star-hockey NHL All-Star Hockey (Sega Saturn)]		* [https://www.mobygames.com/game/dos/d D (DOS version only)]
	* [~~http~~://www.mobygames.com/game/phantasmagoria-a-puzzle-of-flesh Phantasmagoria: A Puzzle of Flesh (DOS & Windows)]		* [https://www.mobygames.com/game/saturn/horde The Horde (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/santa-fe-mysteries-the-elk-moon-murder Santa Fe Mysteries: The Elk Moon Murder (DOS & Windows)]		* [https://www.mobygames.com/game/saturn/nhl-all-star-hockey NHL All-Star Hockey (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]		* [https://www.mobygames.com/game/phantasmagoria-a-puzzle-of-flesh Phantasmagoria: A Puzzle of Flesh (DOS & Windows)]
	* [~~http~~://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]		* [https://www.mobygames.com/game/santa-fe-mysteries-the-elk-moon-murder Santa Fe Mysteries: The Elk Moon Murder (DOS & Windows)]
	* [~~http~~://www.mobygames.com/game/spycraft-the-great-game Spycraft: The Great Game (DOS & Windows)]		* [https://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/saturn/theme-park Theme Park (Sega Saturn)]		* [https://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/saturn/virtua-cop-2 Virtua Cop 2 (Sega Saturn)]		* [https://www.mobygames.com/game/spycraft-the-great-game Spycraft: The Great Game (DOS & Windows)]
	* [~~http~~://www.mobygames.com/game/saturn/virtua-fighter-2 Virtua Fighter 2 (Sega Saturn)]		* [https://www.mobygames.com/game/saturn/theme-park Theme Park (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/windows/zork-grand-inquisitor Zork: Grand Inquisitor (Windows)]		* [https://www.mobygames.com/game/saturn/virtua-cop-2 Virtua Cop 2 (Sega Saturn)]
	* [~~http~~://www.mobygames.com/game/windows/zork-nemesis-the-forbidden-lands Zork Nemesis: The Forbidden Lands (Windows)]		* [https://www.mobygames.com/game/saturn/virtua-fighter-2 Virtua Fighter 2 (Sega Saturn)]
	* Bubble Bobble special CD release with Rainbow Island (DOS) by Acclaim		* [https://www.mobygames.com/game/windows/zork-grand-inquisitor Zork: Grand Inquisitor (Windows)]
			* [https://www.mobygames.com/game/windows/zork-nemesis-the-forbidden-lands Zork Nemesis: The Forbidden Lands (Windows)]

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

VAG: /* Games Using Duck TrueMotion 1 */

2011-07-30T21:53:51Z

Games Using Duck TrueMotion 1

← Older revision		Revision as of 14:53, 30 July 2011
Line 149:		Line 149:
	* [http://www.mobygames.com/game/saturn/nhl-all-star-hockey NHL All-Star Hockey (Sega Saturn)]		* [http://www.mobygames.com/game/saturn/nhl-all-star-hockey NHL All-Star Hockey (Sega Saturn)]
	* [http://www.mobygames.com/game/phantasmagoria-a-puzzle-of-flesh Phantasmagoria: A Puzzle of Flesh (DOS & Windows)]		* [http://www.mobygames.com/game/phantasmagoria-a-puzzle-of-flesh Phantasmagoria: A Puzzle of Flesh (DOS & Windows)]
			* [http://www.mobygames.com/game/santa-fe-mysteries-the-elk-moon-murder Santa Fe Mysteries: The Elk Moon Murder (DOS & Windows)]
	* [http://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]		* [http://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]
	* [http://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]		* [http://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]

Compn at 04:36, 30 January 2009

2009-01-30T04:36:21Z

← Older revision		Revision as of 21:36, 29 January 2009
Line 1:		Line 1:
	* FOURCCs: DUCK		* FOURCCs: DUCK,PVEZ
	* Company: [[On2\|On2 (formerly Duck)]]		* Company: [[On2\|On2 (formerly Duck)]]
	* Patents: US #6,181,822, "Data compression apparatus and method"		* Patents: US #6,181,822, "Data compression apparatus and method"

Multimedia Mike: typo

2007-08-21T16:37:09Z

typo

← Older revision		Revision as of 09:37, 21 August 2007
Line 4:		Line 4:
	* Samples: http://samples.mplayerhq.hu/V-codecs/DUCK/		* Samples: http://samples.mplayerhq.hu/V-codecs/DUCK/

	Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, ~~typical~~ on PC or Sega Saturn titles.		Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typically on PC or Sega Saturn titles.

	== Underlying Concepts ==		== Underlying Concepts ==

DonDiego: Moved all samples in the collection into one directory.

2007-08-20T07:47:13Z

Moved all samples in the collection into one directory.

← Older revision		Revision as of 00:47, 20 August 2007
Line 2:		Line 2:
	* Company: [[On2\|On2 (formerly Duck)]]		* Company: [[On2\|On2 (formerly Duck)]]
	* Patents: US #6,181,822, "Data compression apparatus and method"		* Patents: US #6,181,822, "Data compression apparatus and method"
	* Samples:		* Samples: http://samples.mplayerhq.hu/V-codecs/DUCK/
	** [http://samples.mplayerhq.hu/game-formats/DUCK/ http://samples.mplayerhq.hu/game-formats/DUCK/]
	** [http://samples.mplayerhq.hu/V-codecs/DUCK/ http://samples.mplayerhq.hu/V-codecs/DUCK/ ]

	Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typical on PC or Sega Saturn titles.		Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typical on PC or Sega Saturn titles.

Multimedia Mike: link to differential coding theory page

2007-06-25T05:24:37Z

link to differential coding theory page

← Older revision		Revision as of 22:24, 24 June 2007
Line 6:		Line 6:
	** [http://samples.mplayerhq.hu/V-codecs/DUCK/ http://samples.mplayerhq.hu/V-codecs/DUCK/ ]		** [http://samples.mplayerhq.hu/V-codecs/DUCK/ http://samples.mplayerhq.hu/V-codecs/DUCK/ ]

	Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses differential pulse code modulation and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typical on PC or Sega Saturn titles.		Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typical on PC or Sega Saturn titles.

	== Underlying Concepts ==		== Underlying Concepts ==

Multimedia Mike: /* Games Using Duck TrueMotion 1 */ and another

2006-12-06T21:53:08Z

Games Using Duck TrueMotion 1: and another

← Older revision		Revision as of 14:53, 6 December 2006
Line 151:		Line 151:
	* [http://www.mobygames.com/game/saturn/nhl-all-star-hockey NHL All-Star Hockey (Sega Saturn)]		* [http://www.mobygames.com/game/saturn/nhl-all-star-hockey NHL All-Star Hockey (Sega Saturn)]
	* [http://www.mobygames.com/game/phantasmagoria-a-puzzle-of-flesh Phantasmagoria: A Puzzle of Flesh (DOS & Windows)]		* [http://www.mobygames.com/game/phantasmagoria-a-puzzle-of-flesh Phantasmagoria: A Puzzle of Flesh (DOS & Windows)]
			* [http://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]
	* [http://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]		* [http://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]
	* [http://www.mobygames.com/game/spycraft-the-great-game Spycraft: The Great Game (DOS & Windows)]		* [http://www.mobygames.com/game/spycraft-the-great-game Spycraft: The Great Game (DOS & Windows)]

← Older revision		Revision as of 20:04, 13 August 2021
Line 2:		Line 2:
	* Company: [[On2\|On2 (formerly Duck)]]		* Company: [[On2\|On2 (formerly Duck)]]
	* Patents: US #6,181,822, "Data compression apparatus and method"		* Patents: US #6,181,822, "Data compression apparatus and method"
	* Samples: http://samples.mplayerhq.hu/V-codecs/DUCK/		* Samples: http://samples.mplayerhq.hu/V-codecs/DUCK/ and http://ghostarchive.org/samples/V-codecs/DUCK/


	Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typically on PC or Sega Saturn titles.		Duck TrueMotion 1 (TM1) is the first video codec developed by The Duck Corporation. It uses [[Differential Coding\|differential pulse code modulation]] and interframe differencing. The primary application for which Duck TrueMotion 1 was developed is gaming software, typically on PC or Sega Saturn titles.
Line 138:		Line 139:

	== Duck TrueMotion v1 Tables ==		== Duck TrueMotion v1 Tables ==
			[https://github.com/FFmpeg/FFmpeg/blob/5541cffa17a8c45004e5ceeda52d4d6b2acee037/libavcodec/truemotion1.c FFmpeg implementation]


	~~[http://svn.mplayerhq.hu/ffmpeg/trunk/libavcodec/truemotion1data.h?view=markup&rev=4679 http://svn.mplayerhq.hu/ffmpeg/trunk/libavcodec/truemotion1data.h?view=markup&rev=4679]~~

	== Games Using Duck TrueMotion 1 ==		== Games Using Duck TrueMotion 1 ==
Line 153:		Line 155:
	* [https://www.mobygames.com/game/santa-fe-mysteries-the-elk-moon-murder Santa Fe Mysteries: The Elk Moon Murder (DOS & Windows)]		* [https://www.mobygames.com/game/santa-fe-mysteries-the-elk-moon-murder Santa Fe Mysteries: The Elk Moon Murder (DOS & Windows)]
	* [https://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]		* [https://www.mobygames.com/game/saturn/solar-eclipse Solar Eclipse (Sega Saturn)]
	* [https://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)]		* [https://www.mobygames.com/game/saturn/sonic-3d-blast Sonic 3D Blast (Sega Saturn)] - [https://www.youtube.com/watch?v=Fpqs4Fta3Ho Video]
	* [https://www.mobygames.com/game/spycraft-the-great-game Spycraft: The Great Game (DOS & Windows)]		* [https://www.mobygames.com/game/spycraft-the-great-game Spycraft: The Great Game (DOS & Windows)]
	* [https://www.mobygames.com/game/saturn/theme-park Theme Park (Sega Saturn)]		* [https://www.mobygames.com/game/saturn/theme-park Theme Park (Sega Saturn)]