/datum/looping_sound

A datum for sounds that need to loop, with a high amount of configurability.

Vars
chance	Chance per loop to play a mid_sound.
direct	If true, plays directly to provided atoms instead of from them.
end_sound	(soundfile) The sound played after the main loop has concluded.
end_volume	Override for volume of end sound.
extra_range	The extra range of the sound in tiles, defaults to 0.
falloff_distance	only applicable to is_sound_projecting: max range till sound volume starts dropping as distance increases
is_sound_projecting	Let's you make a "loud" sound that "projects." IE you can hear this sound from a further distance away. Think of like an air raid siren. They're loud if you're close yeah... but you can hear them from mad far away, bruv with a longer "falloff distance." Fixes the extra_range stuff
loop_started	Has the looping started yet?
max_loops	The max amount of loops to run for.
mid_length	The length of time to wait between playing mid_sounds.
mid_sounds	(list or soundfile) Since this can be either a list or a single soundfile you can have random sounds. May contain further lists but must contain a soundfile at the end.
parent	The source of the sound, or the recipient of the sound.
skip_starting_sounds	Do we skip the starting sounds?
start_length	How long to wait before starting the main loop after playing start_sound.
start_sound	(soundfile) Played before starting the mid_sounds loop.
start_volume	Override for volume of start sound.
timer_id	The ID of the timer that's used to loop the sounds.
vary	Whether or not the sounds will vary in pitch when played.
volume	Sound output volume.
Procs
get_sound	Returns the sound we should now be playing.
handle_parent_del	A simple proc to handle the deletion of the parent, so that it does not force it to hard-delete.
is_active	A simple proc that lets us know whether the sounds are currently active or not.
on_start	A proc that's there to handle delaying the main sounds if there's a start_sound, and simply starting the sound loop in general.
on_stop	Simple proc that's executed when the looping sound is stopped, so that the `end_sound` can be played, if there's one.
play	The proc that handles actually playing the sound.
set_parent	A simple proc to change who our parent is set to, also handling registering and unregistering the QDELETING signals on the parent.
sound_loop	A simple proc handling the looping of the sound itself.
start	The proc to actually kickstart the whole sound sequence. This is what you should call to start the `looping_sound`.
start_sound_loop	The proc that handles starting the actual core sound loop.
stop	The proc to call to stop the sound loop.

Var Details

var
chance
–

Chance per loop to play a mid_sound.

var
direct
–

If true, plays directly to provided atoms instead of from them.

var
end_sound
–

(soundfile) The sound played after the main loop has concluded.

var
end_volume
–

Override for volume of end sound.

var
extra_range
–

The extra range of the sound in tiles, defaults to 0.

var
falloff_distance
–

only applicable to is_sound_projecting: max range till sound volume starts dropping as distance increases

var
is_sound_projecting
–

Let's you make a "loud" sound that "projects." IE you can hear this sound from a further distance away. Think of like an air raid siren. They're loud if you're close yeah... but you can hear them from mad far away, bruv with a longer "falloff distance." Fixes the extra_range stuff

var
loop_started
–

Has the looping started yet?

var
max_loops
–

The max amount of loops to run for.

var
mid_length
–

The length of time to wait between playing mid_sounds.

var
mid_sounds
–

(list or soundfile) Since this can be either a list or a single soundfile you can have random sounds. May contain further lists but must contain a soundfile at the end.

var
parent
– /atom

The source of the sound, or the recipient of the sound.

var
skip_starting_sounds
–

Do we skip the starting sounds?

var
start_length
–

How long to wait before starting the main loop after playing start_sound.

var
start_sound
–

(soundfile) Played before starting the mid_sounds loop.

var
start_volume
–

Override for volume of start sound.

var
timer_id
–

The ID of the timer that's used to loop the sounds.

var
vary
–

Whether or not the sounds will vary in pitch when played.

var
volume
–

Sound output volume.

Proc Details

proc
get_sound
(_mid_sounds)

Returns the sound we should now be playing.

proc
handle_parent_del
(/datum/source)

A simple proc to handle the deletion of the parent, so that it does not force it to hard-delete.

proc
is_active
()

A simple proc that lets us know whether the sounds are currently active or not.

proc
on_start
()

A proc that's there to handle delaying the main sounds if there's a start_sound, and simply starting the sound loop in general.

proc
on_stop
()

Simple proc that's executed when the looping sound is stopped, so that the end_sound can be played, if there's one.

proc
play
(soundfile, volume_override)

The proc that handles actually playing the sound.

Arguments:

soundfile - The soundfile we want to play.
volume_override - The volume we want to play the sound at, overriding the volume variable.

proc
set_parent
(new_parent)

A simple proc to change who our parent is set to, also handling registering and unregistering the QDELETING signals on the parent.

proc
sound_loop
(start_time)

A simple proc handling the looping of the sound itself.

Arguments:

start_time - The time at which the mid_sounds started being played (so we know when to stop looping).

proc
start
(on_behalf_of)

The proc to actually kickstart the whole sound sequence. This is what you should call to start the looping_sound.

Arguments:

on_behalf_of - The new object to set as a parent.

proc
start_sound_loop
()

The proc that handles starting the actual core sound loop.

proc
stop
(null_parent)

The proc to call to stop the sound loop.

Arguments:

null_parent - Whether or not we should set the parent to null (useful when destroying the looping_sound itself). Defaults to FALSE.

/datum/looping_sound

Vars

Procs

Var Details

var chance –

var direct –

var end_sound –

var end_volume –

var extra_range –

var falloff_distance –

var is_sound_projecting –

var loop_started –

var max_loops –

var mid_length –

var mid_sounds –

var parent – /atom

var skip_starting_sounds –

var start_length –

var start_sound –

var start_volume –

var timer_id –

var vary –

var volume –

Proc Details

proc get_sound(_mid_sounds)

proc handle_parent_del(/datum/source)

proc is_active()

proc on_start()

proc on_stop()

proc play(soundfile, volume_override)

proc set_parent(new_parent)

proc sound_loop(start_time)

proc start(on_behalf_of)

proc start_sound_loop()

proc stop(null_parent)

var
chance
–

var
direct
–

var
end_sound
–

var
end_volume
–

var
extra_range
–

var
falloff_distance
–

var
is_sound_projecting
–

var
loop_started
–

var
max_loops
–

var
mid_length
–

var
mid_sounds
–

var
parent
– /atom

var
skip_starting_sounds
–

var
start_length
–

var
start_sound
–

var
start_volume
–

var
timer_id
–

var
vary
–

var
volume
–

proc
get_sound
(_mid_sounds)

proc
handle_parent_del
(/datum/source)

proc
is_active
()

proc
on_start
()

proc
on_stop
()

proc
play
(soundfile, volume_override)

proc
set_parent
(new_parent)

proc
sound_loop
(start_time)

proc
start
(on_behalf_of)

proc
start_sound_loop
()

proc
stop
(null_parent)