Creating custom ANM files: Difference between revisions

From EDukeWiki
Jump to navigation Jump to search
Daedolon (talk | contribs)
No edit summary
Line 1: Line 1:
Duke Nukem 3D uses the [http://wiki.multimedia.cx/index.php?title=DeluxePaint_Animation DeluxePaint Animation format] for displaying its cutscenes and logos. These are a sequence of [http://en.wikipedia.org/wiki/PCX ZSoft PCX images] within the ANM file.
Duke Nukem 3D uses the [http://wiki.multimedia.cx/index.php?title=DeluxePaint_Animation DeluxePaint Animation format] for displaying its cutscenes and logos. These are a sequence of [http://en.wikipedia.org/wiki/PCX ZSoft PCX images] within the ANM file.


You can create your own ANM files, as well as extract the PCX files from an existing ANM file by using the [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-editart/anim2pcx.zip ANIM2PCX tool].
You can create your own ANM files, as well as extract the PCX files from an existing ANM file by using the [http://archive.dukertcm.com/knowledge-base/downloads-rtcm/duke3d-tools-editart/anim2pcx.zip ANIM2PCX tool]. FFmpeg (and its descendents ffplay and mplayer) also support ANMs as input.


Although ANM files are limited to a 8bit palette, you can have a custom one in every animation for higher image quality. Please note that the first color in the palette used is used as background color during [http://en.wikipedia.org/wiki/Bit_blit blitting] and filling of the screen. All resulted letterboxing will use this color as the background color. While the animation changes, it's also possible that you will see the screen filled with this color for a single game tick.
Although ANM files are limited to an 8-bit palette, each ANM holds its own palette, independent of any stored in the game. This palette remains constant for every frame of an ANM. Please note that the first color index in the palette used is used as background color during [http://en.wikipedia.org/wiki/Bit_blit blitting] and filling of the screen. All resulting pillarboxing will use this color as the background color. While the animation changes, it's also possible that you will see the screen filled with this color for a single game tic. Therefore, it is highly recommended to ensure the first palette index is RGB #000000, black.
 
Unless each of the PCX images within the ANM file have the same palette, the palette of the first file will be used for the remainder of frames.{{citation needed}}


==List of animations==
==List of animations==
Line 18: Line 16:
| 1
| 1
| cineov2
| cineov2
| 120/10
| 120/10 = 12 fps
|-
|-
| 2
| 2
| cineov3
| cineov3
| 120/10
| 120/10 = 12 fps
|-
|-
| 3
| 3
| RADLOGO
| RADLOGO
| 120/10
| 120/10 = 12 fps
|-
|-
| 4
| 4
| DUKETEAM
| DUKETEAM
| 120/10
| 120/10 = 12 fps
|-
|-
| 5
| 5
| logo
| logo
| 120/9
| 120/9 &#x2248; 13.<span style="text-decoration: overline">3</span> fps
|-
|-
| 6
| 6
| vol41a
| vol41a
| 120/14
| 120/14 &#x2248; 8.<span style="text-decoration: overline">571428</span> fps
|-
|-
| 7
| 7
| vol42a
| vol42a
| 120/18
| 120/18 &#x2248; 6.<span style="text-decoration: overline">6</span> fps
|-
|-
| 8
| 8
| vol4e1
| vol4e1
| 120/10
| 120/10 = 12 fps
|-
|-
| 9
| 9
| vol43a
| vol43a
| 120/10
| 120/10 = 12 fps
|-
|-
| 10
| 10
| vol4e2
| vol4e2
| 120/14
| 120/14 &#x2248; 8.<span style="text-decoration: overline">571428</span> fps
|-
|-
| 11
| 11
| vol4e3
| vol4e3
| 120/10
| 120/10 = 12 fps
|}
|}


By default, the game looks for a file with the extension .ANM for each animation file, but with the addition of IVF support in EDuke32, you can also use the [http://wiki.multimedia.cx/index.php?title=IVF IVF container] for custom animations.
By default, the game looks for a file with the extension .ANM for each animation file.
 
== VP8 replacement ==
 
You can also use the VP8 video codec inside an [http://wiki.multimedia.cx/index.php?title=IVF IVF container] for custom animations. Simply give your IVF file the same name as an ANM and place it in one of EDuke32's search paths. For example: <code>LOGO.IVF</code>.
 
Note that VP8 videos will only display when using 32-bit OpenGL video mode--'''not''' the 8-bit classic software renderer. Also note that the hardcoded sounds (listed below) of any VP8-replaced-ANM will not play. Instead, use the [[DEF Language#animsounds|<code>animsounds</code> def command]] to specify new ones. Further note that the IVF container does not hold audio--''all'' audio for a VP8 video must be added via <code>animsounds</code>.
 
To create VP8 video, the EDuke32 Team recommends [https://trac.ffmpeg.org/wiki/Encode/VP8 FFmpeg].





Revision as of 05:12, 16 June 2014

Duke Nukem 3D uses the DeluxePaint Animation format for displaying its cutscenes and logos. These are a sequence of ZSoft PCX images within the ANM file.

You can create your own ANM files, as well as extract the PCX files from an existing ANM file by using the ANIM2PCX tool. FFmpeg (and its descendents ffplay and mplayer) also support ANMs as input.

Although ANM files are limited to an 8-bit palette, each ANM holds its own palette, independent of any stored in the game. This palette remains constant for every frame of an ANM. Please note that the first color index in the palette used is used as background color during blitting and filling of the screen. All resulting pillarboxing will use this color as the background color. While the animation changes, it's also possible that you will see the screen filled with this color for a single game tic. Therefore, it is highly recommended to ensure the first palette index is RGB #000000, black.

List of animations

These are all the animations that exist by default in Duke Nukem 3D (1.5) and their framerates.

# Name Framerate
1 cineov2 120/10 = 12 fps
2 cineov3 120/10 = 12 fps
3 RADLOGO 120/10 = 12 fps
4 DUKETEAM 120/10 = 12 fps
5 logo 120/9 ≈ 13.3 fps
6 vol41a 120/14 ≈ 8.571428 fps
7 vol42a 120/18 ≈ 6.6 fps
8 vol4e1 120/10 = 12 fps
9 vol43a 120/10 = 12 fps
10 vol4e2 120/14 ≈ 8.571428 fps
11 vol4e3 120/10 = 12 fps

By default, the game looks for a file with the extension .ANM for each animation file.

VP8 replacement

You can also use the VP8 video codec inside an IVF container for custom animations. Simply give your IVF file the same name as an ANM and place it in one of EDuke32's search paths. For example: LOGO.IVF.

Note that VP8 videos will only display when using 32-bit OpenGL video mode--not the 8-bit classic software renderer. Also note that the hardcoded sounds (listed below) of any VP8-replaced-ANM will not play. Instead, use the animsounds def command to specify new ones. Further note that the IVF container does not hold audio--all audio for a VP8 video must be added via animsounds.

To create VP8 video, the EDuke32 Team recommends FFmpeg.


Full list of sounds played for each animation

By replacing these sounds, you can customize your own animation files with new sound files. The frames they're played on are hard-coded, but listed here for ease of use.

cineov2
Frame Sounds
1 WIND_AMBIENCE
26 ENDSEQVOL2SND1
36 ENDSEQVOL2SND2
54 THUD
62 ENDSEQVOL2SND3
75 ENDSEQVOL2SND4
81 ENDSEQVOL2SND5
115 ENDSEQVOL2SND6
124 ENDSEQVOL2SND7
cineov3
Frame Sounds
1 WIND_REPEAT
98 DUKE_GRUNT
82+20 THUD, SQUISHED
104+20 ENDSEQVOL3SND3
114+20 ENDSEQVOL3SND2
158 PIPEBOMB_EXPLODE
logo
Frame Sounds
1 FLY_BY
19 PIPEBOMB_EXPLODE
vol41a
Frame Sounds
1 INTRO4_1
12 INTRO4_2
7 INTRO4_3
26 INTRO4_4


vol42a
Frame Sounds
1 INTRO4_B
12 SHORT_CIRCUIT
34 SHORT_CIRCUIT
18 INTRO4_5
vol4e1
Frame Sounds
3 DUKE_UNDERWATER
35 VOL4ENDSND1
vol43a
Frame Sounds
10 INTRO4_6
vol4e2
Frame Sounds
11 DUKE_UNDERWATER
20 VOL4ENDSND1
39 VOL4ENDSND2
50 FX_StopAllSounds();
vol4e3
Frame Sounds
1 BOSS4_DEADSPEECH
40 VOL4ENDSND1, DUKE_UNDERWATER
50 BIGBANG