Naev

Module audio

Lua bindings to interact with audio.

Functions

__gc (audio) Frees a audio.
__eq (a1, a2) Compares two audios to see if they are the same.
new (data) Creates a new audio source.
play (source) Plays a source.
pause (source) Pauses a source.
stop (source) Stops a source.
setVolume (source, vol) Sets the volume of a source.
getVolume (source) Gets the volume of a source.
getVolume (source, enable) Sets a source to be looping or not.
setPitch (source, pitch) Sets the pitch of a source.
soundPlay (s[, pos[, vel]]) Plays a sound.


Functions

__gc (audio)
Frees a audio.

Parameters:

  • audio Audio Audio to free.
__eq (a1, a2)
Compares two audios to see if they are the same.

Parameters:

  • a1 Audio Audio 1 to compare.
  • a2 Audio Audio 2 to compare.

Returns:

    boolean true if both audios are the same.
new (data)
Creates a new audio source.

Parameters:

  • data string or File Data to load the audio from.

Returns:

    Audio New audio corresponding to the data.
play (source)
Plays a source.

Parameters:

  • source Audio Source to play.

Returns:

    boolean True on success.
pause (source)
Pauses a source.

Parameters:

  • source Audio Source to pause.

Returns:

    boolean True on success.
stop (source)
Stops a source.

Parameters:

  • source Audio Source to stop.

Returns:

    boolean True on success.
setVolume (source, vol)
Sets the volume of a source.

Parameters:

  • source Audio Source to set volume of.
  • vol number Volume to set the source to.
getVolume (source)
Gets the volume of a source.

Parameters:

  • source Audio Source to get volume of.

Returns:

    number Volume the source is set to.
getVolume (source, enable)
Sets a source to be looping or not.

Parameters:

  • source Audio Source to set looping state of.
  • enable boolean Whether or not the source should be set to looping.
setPitch (source, pitch)
Sets the pitch of a source.

Parameters:

  • source Audio Source to set pitch of.
  • pitch number Pitch to set the source to.
soundPlay (s[, pos[, vel]])
Plays a sound.

by default, the sound is played at player's current position

Parameters:

  • s string Name of the sound to play
  • pos Vec2 Position of the source (optional)
  • vel Vec2 Velocity of the source (optional)

Usage:

  • audio.soundPlay( "hail" ) -- Plays the hail sound
  • audio.soundPlay( "hail", pos ) -- Plays the hail sound at position pos
  • audio.soundPlay( "hail", pos, vel ) -- Plays the hail sound at position pos with velocity vel
generated by LDoc 1.4.6 Last updated 2021-01-17 05:05:08