Intermission script

From ZDoom Wiki

Intermission scripts are very simple definition files that specialize the backdrops used for the intermission screens between levels, i.e. 'Level finished' and 'Entering level'. The format was primarily designed to get rid of a lot of awful special coding in the intermission screen code. The idea was to enable defining the intermission screens for an entire episode in one file.

Intermission scripts are specified by the enterpic and exitpic MAPINFO commands.

The following commands are supported:

• NOAUTOSTARTMAP

The player has to manually end the intermission and start the new map. Use this if you want the 'entering' screen to be active longer than a few seconds.

• BACKGROUND picture

A graphics patch or texture that is used as the background. If this is a texture (wall, flat or TX_) it will be tiled across the screen. If it is a regular graphics patch it will be stretched to fill the screen.

If this is a patch all coordinates specified here will be relative to the texture, otherwise it will be relative to a 320x200 screen. If no background is specified the screen will be cleared with black.

• SPLAT picture

Defines the graphic with which all visited levels will be marked. Named 'splat' for Doom's original graphic used for this purpose.

• POINTER picture1 picture2

Defines the pointer which will be used to point to the next level the player is about to enter. There are 2 graphics because normally pointers have their origin at one side so this way there is an alternative if one pointer would be off screen. Doom originally also uses 2 pointer graphics.

• SPOTS
  {
  list
  }
  

Defines a list of coordinate spots where the splats and pointers should be drawn to. The list consists of entries of the format

mapname xpos ypos.

Note: Spots will only appear if placed below the graphics at the top of the screen (eg. "Now entering", "Finished") whether or not they will interfere with those graphics.

• ANIMATION x y speed
  {
  piclist
  }
  

Defines an animation that is played on the backdrop. You have to specify the x- and y- position and an animation speed. Animation speed is always randomized with the given speed as the maximum time in 1/35 of a second. The list is just a list of graphics patches. There can be 20 patches per animation at most.

• PIC xpos ypos picname

Displays a single patch at the given coordinate.

• IFENTERING mapname command

Executes the following command only if the player enters the specified map. This condition is only true on the 'Entering level' screen. The only supported commands are ANIMATION and PIC.

• IFNOTENTERING mapname command

Executes the following command only if the player does not enter the specified map. This condition can only be false on the 'Entering level' screen. The only supported commands are ANIMATION and PIC.

• IFLEAVING mapname command

Executes the following command only if the player is leaving the specified map. This condition can only be true on the 'Level finished' screen. The only supported commands are ANIMATION and PIC.

• IFNOTLEAVING mapname command

Executes the following command only if the player is leaving the specified map. This condition can only be false on the 'Level finished' screen. The only supported commands are ANIMATION and PIC.

• IFVISITED mapname command

Executes the following command only if the player has already visited the specified map. This can be used to draw special graphics if the player has found a secret level. The only supported commands are ANIMATION and PIC.

• IFNOTVISITED mapname command

Executes the following command only if the player has not already visited the specified map. The only supported commands are ANIMATION and PIC.

• IFTRAVELLING mapname1 mapname2 command

Executes the following command only if the player is right between the two specified maps. The only supported commands are ANIMATION and PIC.

• IFNOTTRAVELLING mapname1 mapname2 command

Executes the following command only if the player is not between the two specified maps. The only supported commands are ANIMATION and PIC.