Classes:AmbientSound

From ZDoom Wiki
Jump to navigation Jump to search
Note: Wait! Stop! You do not need to copy this actor's code into your project! Here's why:
  1. This actor is already defined in GZDoom, there's no reason to define it again.
  2. In fact, trying to define an actor with the same name will cause an error (because it already exists).
  3. If you want to make your own version of this actor, use inheritance.
  4. Definitions for existing actors are put on the wiki for reference purpose only.
Ambient sound
Actor type Map spot Game MiniZDoomLogoIcon.png (ZDoom)
DoomEd Number 14065 Class Name AmbientSound


Classes: ActorAmbientSound
 → AmbientSoundNoGravity

The AmbientSound thing plays an ambient sound determined by its first parameter. The sounds themselves must be defined in SNDINFO. While some ambient sounds are defined in ZDoom.pk3, none of them are actually added to the index of ambient sounds with the $ambient command, so a map using this thing needs a SNDINFO lump. Up to 64 ambient sounds can be used in the Doom map format and 256 in Hexen format. UDMF maps have no limit.

The second parameter determines the volume of the sound, as a percentile value. 0 is interpreted as the default (100).

The third parameter determines the minimum distance for sound fading to be applied. If left to zero, the standard rolloff is used instead.

The fourth parameter determines the maximum distance at which the sound can be heard. If left to zero, or if lower than the third parameter, the standard rolloff is used instead.

The fifth and last parameter, if not null, is a scalar for the third and fourth parameters.

Use in a Doom-format map

In a map format where things cannot have parameters, DoomEd numbers 14001 to 14064 can be used instead: ZDoom will translate each such item in the map to an AmbientSound actor whose first parameter is equal to its number minus 14000. (So, 14001 will be interpreted as if it were 14065 with first parameter 1.)

DECORATE definition

ACTOR AmbientSound native
{
  +NOBLOCKMAP
  +NOSECTOR
  +DONTSPLASH
}

See also