Wiki: ambient_generic

ambient_generic - Point Entity

The ambient_generic entity allows you to play a specific sound. It is a flexible entity that can be used for both looping ambient sounds and one-off sound effects triggered on cue.

Attributes

Name (targetname) - Name is a general attribute used to identify entities.
WAV Name (message) - This defines which sound file will be played by the entity. This accepts an input of the form path/filename.wav (starting from the "sound" folder). (Example: ambience/drips.wav). The name of a sentence defined in sentences.txt will also be accepted with the form "!SENTENCENAME". (Example: !HG_ALERT1)
Volume (10 = loudest) (health) - Sets the volume of the sound. Scales from 0 (completely silent) to 10 (maximum, default). (If using dynamics attributes below, this is the maximum volume the sound will reach.)
Dynamic Presets (preset) - Sets the ambient_generic to use a predefined set of dynamics. If set to anything other than "None", this will override every other attribute apart from Name and WAV Name.
- None (0) - Does not use a preset, and will not override any other entity attributes.
- Huge Machine (1) - Very long spin up, starting slow and getting fast. Very long spin down.
- Big Machine (2) - Medium spin up, starting normal and getting fast. Long spin down.
- Machine (3) - Quick spin up, starting normal and getting fast. Quick spin down.
- Slow Fade in (4) - Slow fade in/out.
- Fade in (5) - Medium fade in/out.
- Quick Fade in (6) - Quick fade in/out.
- Slow Pulse (7) - Slow pulsing speed. Quick fade out.
- Pulse (8) - Pulsing speed. Quick fade out.
- Quick Pulse (9) - Quick pulsing speed. Quick fade out.
- Slow Oscillator (10) - Slow oscillation between normal and slow speed. Quick fade out.
- Oscillator (11) - Medium oscillation between normal and slow speed. Quick fade out.
- Quick Oscillator (12) - Fast oscillation between normal and slow speed. Quick fade out.
- Grunge pitch (13) - Extremely slow. Quick fade out.
- Very low pitch (14) - Very slow. Quick fade out.
- Low pitch (15) - Slow. Quick fade out.
- High pitch (16) - Fast. Quick fade out.
- Very high pitch (17) - Very fast. Quick fade out.
- Screaming pitch (18) - Extremely fast. Quick fade out.
- /Oscillate spinup/down (19)/ - Medium oscillation, with long spin up from slow to fast. Long spin down.
- /Pulse spinup/down (20)/ - Slow pulse, with long spin up from slow to fast. Long spin down.
- Random pitch (21) - Occasionally switches speed, tending towards slower speeds. Quick fade out.
- Random pitch fast (22) - Rapidly switches speed, tending towards faster speeds. Quick fade out.
- Incremental Spinup (23) - Quick spin up. Subsequent triggers will not toggle, but will spin up from existing speed, up to five times. Cannot be turned off.
- Alien (24) - Unusual pulsing and switching speed. Quick fade out.
- Bizzare (25) - Fast oscillation between fast and slow/silent. Quick fade out.
- Planet X (26) - Medium switching between slower speeds, similar to "Random pitch". Quick fade out.
- Haunted (27) - Slow switch between normal and slow speed. Quick fade out.
Start Volume (volstart) - Sets the volume that the sound should start at when fading in, and that it should stop at when fading out. Scales from 0 (completely silent) to 10 (maximum). (Should be lower than Volume.)
Fade in time (0-100) (fadein) - Sets how long the sound should take to fade in from Start Volume to Volume. Scales from 0 (instant) to 100 (very long).
Fade out time (0-100) (fadeout) - Sets how long the sound should take to fade out from Volume to Start Volume. Scales from 0 (instant) to 100 (very long).
Pitch (> 100 = higher) (pitch) - Sets the pitch of the sound. Scales from 100 (default), with lower values meaning lower pitch and higher values meaning higher pitch.
Start Pitch (pitchstart) - Sets the pitch that the sound should start at when spinning up, and that it should stop at when spinning down. Scales from 100 (default), with lower values meaning lower pitch and higher values meaning higher pitch. (Should be lower than Pitch.)
Spin up time (0-100) (spinup) - Sets how long the sound should take to spin up from Start Pitch to Pitch. Scales from 0 (instant) to 100 (very long).
Spin down time (0-100) (spindown) - Sets how long the sound should take to spin down from Pitch to Start Pitch. Scales from 0 (instant) to 100 (very long).
LFO type (lfotype) - Allows the sound to have certain oscillating effects applied to its pitch.
- off (0) - Disables the LFO effects.
- sqr (1) - Switches between a low and high pitch.
- tri (2) - Oscillates between a low and high pitch.
- rnd (3) - Randomly switches pitches.
LFO rate (0-1000) (lforate) - Sets how quickly the pitch changes with the LFO effects. Scales between 0 (does not change) and 1000 (changes extremely quickly).
LFO mod pitch (0-100) (lfomodpitch) - Sets how much the pitch should change with the LFO effects. Scales between 0 (does not change) and 100 (very large changes).
LFO mod vol (0-100) (lfomodvol) - Sets how much the volume should change with the LFO effects. Seems to coincide with lower pitches. Scales between 0 (does not change) and 100 (silent).
Incremental spinup count (cspinup) - Sets how many times the ambient_generic can be triggered to have the pitch spin up on top of the pitch it was already playing at. Setting this to a value other than 0 will disable toggling the sound, and will prevent the sound from being turned off even it has been triggered that many times.

Flags

Play Everywhere (1) - If enabled, the sound will be heard throughout the entire map.
Small Radius (2) - If enabled, the sound will be at maximum volume within a roughly 256 unit radius, fading out completely at around 512 units away.
Medium Radius (4) - If enabled, the sound will be at maximum volume within a roughly 512 unit radius, fading out completely at around 768 units away.
Large Radius (8) - If enabled, the sound will be at maximum volume within a roughly 768 unit radius, fading out completely at around 1280 units away.
Start Silent (16) - If enabled, the sound will not play at the start of the map, and will need to be triggered to play. Otherwise, the sound will play at the start of the map whether it is a looping sound or not.
Not Toggled (32) - Tells the entity whether or not it is dealing with a looping sound. If enabled, the sound will play whenever the entity is triggered (intended for non-looping sounds). (Looping sounds will still play, but will not turn off when triggered.) If not enabled, the sound will toggle on or off when triggered (intended for looping sounds). (Non-looping sounds will still play, but every second trigger will turn the sound off regardless of whether the sound is actually playing anything.) See notes for more information about looping sounds.

Notes

Sounds will only loop if there are cue points defined in the .wav file, and will loop (or not) regardless of entity settings. Cue points determine where the looping will start and end. Sounds will play from start to end and then loop the segment between the first cue and the second cue (or the end if there is only one), ignoring other cue points. See this example map for further analysis.
Certain timing dynamics settings (such as Pitch Spin Up/Down Time) will cause non-looping sounds to loop for the duration of those times if the sound is not long enough.
From WorldCraft 2.1 Help: "To play a wav through the streaming code (for very large, one-shot wavs) use * in front of the name. For instance, ambience/*speak2.wav would stream speak2.wav. Streaming sounds are loaded in segments from the disk, played, and flushed from memory."
If more than one of the "Radius" flags are checked, the entity will use the smallest radius that is checked. "Play Everywhere" will override those flags, however.

From the VERC Archive

LFO - Low Frequency Oscillator

LFO is a sound synthesis acronym that means "Low frequency oscillator". MOD means modulation. Rate is the frequency (how often the effect repeats itself).

So lfomodpitch means that the low frequency oscillator is affecting the pitch of the sound. This effect is commonly called "vibrato". You're probably familiar with the difference between a singer singing with and without vibrato... That's what you would do if you set lfomodpitch. Higher numbers mean more change in the pitch -- singers use very little, whereas a police siren uses a lot.

lfomodvol means that the LFO is affecting the volume of the sound. This is sometimes referred to as "tremolo" although in some musical contexts tremolo and vibrato are synonymous. This is more of a "pulse" through the sound than a wavering of pitch as above. Hopefully you get the idea.

lfotype is the shape of the waveform that is used. I assume that sqr is a square wave, tri is a triangle (or maybe sawtooth) and rnd is random. All of these have different characteristics as to how they affect the sound. sqr will jump back and forth between low and high, tri has sharp transitions, and rnd has smooth transitions. It's difficult to explain in text, but easy to hear, just experiment with it.

Radius sizes

Roughly speaking, the maximum distance that a sound could be heard from at a particular radius is (provided it is playing at maximum volume)

Small is 800
Medium is 1250
Large is 2000

Most sounds aren't being played at maximum volume, and they aren't recorded in the full dynamic range of the sample either, so the actual distance for hearing them is lower. There is no way to alter the attenuation values without writing code. You will be able to set the radius more precisely by writing entity code, but its not an exact science because of the variations in sound / sample volumes.

Preset values

The following are the values used by the presets (source):

#	pitch	pitchstart	spinup	spindown	volume	volstart	fadein	fadeout	lfotype	lforate	lfomodpitch	lfomodvol	cspinup
1	255	75	95	95	10	1	50	95
2	255	85	70	88	10	1	20	88
3	255	100	50	75	10	1	10	75
4	100	100			10	1	90	90
5	100	100			10	1	80	80
6	100	100			10	1	50	70
7	100	100			5	1	40	50	1	50		10
8	100	100			5	1	40	50	1	150		10
9	100	100			5	1	40	50	1	750		10
10	128	100	50	75	10	1	30	40	2	8	20
11	128	100	50	75	10	1	30	40	2	25	20
12	128	100	50	75	10	1	30	40	2	70	20
13	50	50			10	1	20	50
14	70	70			10	1	20	50
15	90	90			10	1	20	50
16	120	120			10	1	20	50
17	180	180			10	1	20	50
18	255	255			10	1	20	50
19	200	75	90	90	10	1	50	90	2	100	20
20	255	75	97	90	10	1	50	90	1	40	50
21	100	100			10	1	30	50	3	15	20
22	160	160			10	1	50	50	3	500	25
23	255	75	88		10	1	40						5
24	200	20	95	70	10	1	70	70	3	20	50
25	180	100	50	60	10	1	40	60	2	90	100	100
26	60	60			10	1	40	70	3	80	20	50
27	128	90	10	10	10	1	20	40	1	5	10	20

Example maps

Some example maps that show the ambient_generic in action:

Loading embedded content: Vault Item #5708

Loading embedded content: Vault Item #5723

ambient_generic Last edited 11 months ago2023-12-25 13:16:40 UTC