Smush: Difference between revisions

From MultimediaWiki
Jump to navigation Jump to search
m (add samples section)
(no more undiscovered)
 
(39 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This page attempts to document the [[LucasArts]] Smush codec, FOURCC "SANM". Note that at this stage the document is quite incomplete as the codec is still being reversed. Most information regarding ''codecs'' here is speculative, at best. Structural information is quite correct unless otherwise noted.
This page attempts to document the [[LucasArts]] Smush codec. The [[SANM]] codec document is complete; the SAN codec is still under (de)construction.


== Samples ==
Samples from various games are located at http://samples.mplayerhq.hu/game-formats/la-san/ and http://samples.mplayerhq.hu/game-formats/la-snm/.


== Use in Grim Fandango ==
== Usage Matrix ==
SANM is used in Grim Fandango for cut-scenes and in-game animations. The actual SNM movie files are stored inside LAB archive files (which are quite easy to extract, there are many tools) and gzippe'd. You must use a tool like *nix's "gunzip" to decompress the SNM files after extracting the SNM files out of the LAB files. A decompressed Smush file has the "SANM" FOURCC as the first four bytes.
{| border="1" cellpadding="2"
! Name !! Variant !! Video Codec || Audio Codec
|-
| [http://www.mobygames.com/game/dos/star-wars-rebel-assault Rebel Assault]
| ANIM v1 ||   ||  
|-
| [http://www.mobygames.com/game/dos/star-wars-rebel-assault-ii-the-hidden-empire Rebel Assault II]
| ANIM v2 ||   ||  
|-
| Rebel Assault II demo
| ANIM v2 || FOBJ Codec 37 ||  
|-
| Rebel Assault II trailer
| ANIM v2 ||   || PSAD
|-
| [http://www.mobygames.com/game/dos/full-throttle Full Throttle]
| ANIM v2 || FOBJ Codec 37 || PSAD
|-
| [http://www.mobygames.com/game/dos/dig The Dig]
| ANIM v2 || FOBJ Codec 37 || IACT
|-
| [http://www.mobygames.com/game/windows/curse-of-monkey-island The Curse Of Monkey Island]
| ANIM v2 || FOBJ Codec 47 || IACT
|-
| [http://www.mobygames.com/game/windows/outlaws Outlaws]
| ANIM v2 ||   ||  
|-
| Outlaws demo
| ANIM v2 || FOBJ Codec 47 ||  
|-
| Grim Fandango demo
| ANIM v2 || FOBJ Codec 47 ||  
|-
| Grim Fandango trailer
| ANIM v2 ||   || IACT
|-
| [http://www.mobygames.com/game/windows/grim-fandango Grim Fandango]
| SANM || Bl16 (blocky16) || [[VIMA]]
|-
| [http://www.mobygames.com/game/windows/star-wars-shadows-of-the-empire Shadows of the Empire (PC)]
| ANIM v2 ||   ||  
|-
| [http://www.mobygames.com/game/windows/star-wars-x-wing-alliance X-Wing Alliance]
| SANM ||   ||  
|-
| [http://www.mobygames.com/game/windows/star-wars-episode-i-racer Star Wars Racer]
| SANM + gzip (ZNM) ||   ||  
|-
| [http://www.mobygames.com/game/windows/star-wars-droidworks Star Wars DroidWorks]
|   ||   ||  
|-
| [http://www.mobygames.com/game/windows/indiana-jones-and-the-infernal-machine Indiana Jones and the Infernal Machine]
| SANM ||   ||  
|-
| [http://www.mobygames.com/game/windows/star-wars-jedi-knight-mysteries-of-the-sith Jedi Knight: Mysteries of the Sith]
| ANIM v2 ||   ||  
|-
| [http://www.mobygames.com/game/windows/mortimer-and-the-riddles-of-the-medallion Mortimer and the Riddles of the Medallion]
|   ||   ||  
|-
| Making Magic CDROM (not a game but still uses smush)
|   ||   ||  
|-
| [http://www.mobygames.com/game/escape-from-monkey-island Escape From Monkey Island]
|   || apparently has Smush headers but uses [[Bink Container|Bink]] ||  
|-
| Star Wars Episode 1: Insider's Guide
| SANM ||   ||  
|-
| Jar Jar's Journey Storybook
| SANM ||   ||  
|}


== Organization ==
== Variants ==
This section deals with the structural properties of Smush movies. In other words, we describe the various headers used.
Smush comes in two variants. FOURCC "[[SAN|ANIM]]" was used up until Grim Fandango, and this variant has two sub-variants: v1 (Rebel Assault only) and v2 (all others). FOURCC "[[SNM|SANM]]" was used from Grim Fandango up until its replacement by [[Bink Container|Bink]], possibly in Escape From Monkey Island.


=== Preamble ===
[[Category:Game Formats]]
The movie begins with a basic 8-byte section that looks like this:
 
0x00|"SANM" FOURCC        |4 bytes big endian
0x04|Movie size (in bytes)|4 bytes big endian
 
=== Video Header ===
This header immediately follows the preamble. It describes the movie's video properties.
 
0x000|"SHDR" FOURCC            |4 bytes big endian
0x004|Header size (in bytes)    |4 bytes big endian
0x008|Version                  |2 bytes little endian
0x00A|# of frames              |4 bytes little endian
0x00E|Padding?                  |2 bytes
0x010|Width                    |2 bytes little endian
0x012|Height                    |2 bytes little endian
0x014|Padding?                  |2 bytes
0x016|Frame delay (microseconds)|4 bytes little endian
0x01A|Color palette?            |1024 bytes
0x41A|Padding?                  |16 bytes
 
=== Audio/Keyframe Header ===
The information here is incomplete.
 
(More coming soon, I just have to dig this out of my notes)

Latest revision as of 11:53, 21 June 2012

This page attempts to document the LucasArts Smush codec. The SANM codec document is complete; the SAN codec is still under (de)construction.

Samples from various games are located at http://samples.mplayerhq.hu/game-formats/la-san/ and http://samples.mplayerhq.hu/game-formats/la-snm/.

Usage Matrix

Name Variant Video Codec Audio Codec
Rebel Assault ANIM v1    
Rebel Assault II ANIM v2    
Rebel Assault II demo ANIM v2 FOBJ Codec 37  
Rebel Assault II trailer ANIM v2   PSAD
Full Throttle ANIM v2 FOBJ Codec 37 PSAD
The Dig ANIM v2 FOBJ Codec 37 IACT
The Curse Of Monkey Island ANIM v2 FOBJ Codec 47 IACT
Outlaws ANIM v2    
Outlaws demo ANIM v2 FOBJ Codec 47  
Grim Fandango demo ANIM v2 FOBJ Codec 47  
Grim Fandango trailer ANIM v2   IACT
Grim Fandango SANM Bl16 (blocky16) VIMA
Shadows of the Empire (PC) ANIM v2    
X-Wing Alliance SANM    
Star Wars Racer SANM + gzip (ZNM)    
Star Wars DroidWorks      
Indiana Jones and the Infernal Machine SANM    
Jedi Knight: Mysteries of the Sith ANIM v2    
Mortimer and the Riddles of the Medallion      
Making Magic CDROM (not a game but still uses smush)      
Escape From Monkey Island   apparently has Smush headers but uses Bink  
Star Wars Episode 1: Insider's Guide SANM    
Jar Jar's Journey Storybook SANM    

Variants

Smush comes in two variants. FOURCC "ANIM" was used up until Grim Fandango, and this variant has two sub-variants: v1 (Rebel Assault only) and v2 (all others). FOURCC "SANM" was used from Grim Fandango up until its replacement by Bink, possibly in Escape From Monkey Island.

Retrieved from "https://wiki.multimedia.cx/index.php?title=Smush&oldid=14069"