Skip to content

class_audioserver

Jump to bottom
reduz edited this page Feb 23, 2014 · 10 revisions

AudioServer

####Inherits: Object ####Category: Core

Brief Description

Server interface for low level audio access.

Member Functions

Numeric Constants

  • SAMPLE_FORMAT_PCM8 = 0 - Sample format is 8 bits, signed.
  • SAMPLE_FORMAT_PCM16 = 1 - Sample format is 16 bits, signed.
  • SAMPLE_FORMAT_IMA_ADPCM = 2 - Sample format is IMA-ADPCM compressed.
  • SAMPLE_LOOP_NONE = 0 - Sample does not loop.
  • SAMPLE_LOOP_FORWARD = 1 - Sample loops in forward mode.
  • SAMPLE_LOOP_PING_PONG = 2 - Sample loops in a bidirectional way.
  • FILTER_NONE = 0 - Filter is disable.
  • FILTER_LOWPASS = 1 - Filter is a resonant lowpass.
  • FILTER_BANDPASS = 2 - Filter is a resonant bandpass.
  • FILTER_HIPASS = 3 - Filter is a resonant highpass.
  • FILTER_NOTCH = 4 - Filter is a notch.
  • FILTER_BANDLIMIT = 6 - Filter is a bandlimit (resonance used as highpass).
  • REVERB_SMALL = 0 - Small reverb room (closet, bathroom, etc).
  • REVERB_MEDIUM = 1 - Medium reverb room (living room)
  • REVERB_LARGE = 2 - Large reverb room (warehouse).
  • REVERB_HALL = 3 - Large reverb room with long decay.

Description

AudioServer is a low level server interface for audio access. It is"#10;"#9;in charge of creating sample data (playable audio) as well as it's"#10;"#9;playback via a voice interface.

Member Function Description

sample_create

Create an audio sample, return a RID referencing"#10;"#9;"#9;"#9;it. The sample will be created with a given format"#10;"#9;"#9;"#9;(from the SAMPLE_FORMAT_* enum), a total length (in"#10;"#9;"#9;"#9;frames, not samples or bytes), in either stereo or"#10;"#9;"#9;"#9;mono.

sample_set_description

  • void sample_set_description ( RID sample, String description )

Set the description of an audio sample. Mainly used"#10;"#9;"#9;"#9;for organization.

sample_get_description

Return the description of an audio sample. Mainly"#10;"#9;"#9;"#9;used for organization.

sample_get_format

  • int sample_get_format ( RID sample ) const

Return the format of the audio sample, in the form"#10;"#9;"#9;"#9;of the SAMPLE_FORMAT_* enum.

sample_is_stereo

  • bool sample_is_stereo ( RID sample ) const

Return wether the sample is stereo (2 channels)

sample_get_length

  • int sample_get_length ( RID sample ) const

Return the length in frames of the audio sample (not"#10;"#9;"#9;"#9;samples or bytes).

sample_set_signed_data

  • void sample_set_signed_data ( RID sample, RealArray data )

Set the sample data for a given sample as an array"#10;"#9;"#9;"#9;of floats. The length must be equal to the sample"#10;"#9;"#9;"#9;lenght or an error will be produced.

sample_set_data

Set the sample data for a given sample as an array"#10;"#9;"#9;"#9;of bytes. The length must be equal to the sample"#10;"#9;"#9;"#9;lenght expected in bytes or an error will be produced.

sample_get_data

Return the sample data as an array of bytes. The"#10;"#9;"#9;"#9;length will be the expected length in bytes.

sample_set_mix_rate

  • void sample_set_mix_rate ( RID sample, int mix_rate )

Change the default mix rate of a given sample.

sample_get_mix_rate

  • int sample_get_mix_rate ( RID sample ) const

Return the mix rate of the given sample.

sample_set_loop_format

  • void sample_set_loop_format ( RID sample, int loop_format )

Set the loop format for a sample from the"#10;"#9;"#9;"#9;SAMPLE_LOOP_* enum. As a warning, Ping Pong loops"#10;"#9;"#9;"#9;may not be available on some hardware-mixing"#10;"#9;"#9;"#9;platforms.

sample_get_loop_format

  • int sample_get_loop_format ( RID sample ) const

Return the loop format for a sample, as a value from"#10;"#9;"#9;"#9;the SAMPLE_LOOP_* enum.

sample_set_loop_begin

  • void sample_set_loop_begin ( RID sample, int pos )

Set the initial loop point of a sample. Only has"#10;"#9;"#9;"#9;effect if sample loop is enabled. See sample_set_loop_format.

sample_get_loop_begin

  • int sample_get_loop_begin ( RID sample ) const

Return the initial loop point of a sample. Only has"#10;"#9;"#9;"#9;effect if sample loop is enabled. See sample_set_loop_format.

sample_set_loop_end

  • void sample_set_loop_end ( RID sample, int pos )

Set the final loop point of a sample. Only has"#10;"#9;"#9;"#9;effect if sample loop is enabled. See sample_set_loop_format.

sample_get_loop_end

  • int sample_get_loop_end ( RID sample ) const

Return the final loop point of a sample. Only has"#10;"#9;"#9;"#9;effect if sample loop is enabled. See sample_set_loop_format.

voice_create

  • RID voice_create ( )

Allocate a voice for playback. Voices are"#10;"#9;"#9;"#9;persistent. A voice can play a single sample at the"#10;"#9;"#9;"#9;same time. See sample_create.

voice_play

  • void voice_play ( RID voice, RID sample )

Start playback of a given voice using a given"#10;"#9;"#9;"#9;sample. If the voice was already playing it will be"#10;"#9;"#9;"#9;restarted.

voice_set_volume

  • void voice_set_volume ( RID voice, real volume )

Change the volume of a currently playing voice."#10;"#9;"#9;"#9;Volume is expressed as linear gain where 0.0 is mute"#10;"#9;"#9;"#9;and 1.0 is default.

voice_set_pan

Change the pan of a currently playing voice and,"#10;"#9;"#9;"#9;optionally, the depth and height for a positional/3D"#10;"#9;"#9;"#9;sound. Panning values are expressed within the -1 to"#10;"#9;"#9;"#9;+1 range.

voice_set_filter

Set a resonant filter post processing for the voice."#10;"#9;"#9;"#9;Filter type is a value from the FILTER_* enum.

voice_set_chorus

  • void voice_set_chorus ( RID voice, real chorus )

Set chorus send post processing for the voice (from"#10;"#9;"#9;"#9;0 to 1).

voice_set_reverb

  • void voice_set_reverb ( RID voice, int room, real reverb )

Set the reverb send post processing for the voice (from"#10;"#9;"#9;"#9;0 to 1) and the reverb type, from the REVERB_* enum.

voice_set_mix_rate

  • void voice_set_mix_rate ( RID voice, int rate )

Set a different playback mix rate for the given"#10;"#9;"#9;"#9;voice.

voice_set_positional

  • void voice_set_positional ( RID voice, bool enabled )

Set wether a given voice is positional. This is only"#10;"#9;"#9;"#9;interpreted as a hint and used for backends that may"#10;"#9;"#9;"#9;support binaural encoding.

voice_get_volume

  • real voice_get_volume ( RID voice ) const

Return the current volume for a given voice.

voice_get_pan

  • real voice_get_pan ( RID voice ) const

Return the current pan for a given voice (-1 to +1"#10;"#9;"#9;"#9;range).

voice_get_pan_height

  • real voice_get_pan_height ( RID voice ) const

Return the current pan height for a given voice (-1 to +1"#10;"#9;"#9;"#9;range).

voice_get_pan_depth

  • real voice_get_pan_depth ( RID voice ) const

Return the current pan depth for a given voice (-1 to +1"#10;"#9;"#9;"#9;range).

voice_get_filter_type

  • int voice_get_filter_type ( RID voice ) const

Return the current selected filter type for a given"#10;"#9;"#9;"#9;voice, from the FILTER_* enum.

voice_get_filter_cutoff

  • real voice_get_filter_cutoff ( RID voice ) const

Return the current filter cutoff (in hz) for a given"#10;"#9;"#9;"#9;voice.

voice_get_filter_resonance

  • real voice_get_filter_resonance ( RID voice ) const

Return the current filter resonance for a given"#10;"#9;"#9;"#9;voice.

voice_get_chorus

  • real voice_get_chorus ( RID voice ) const

Return the current chorus send for a given"#10;"#9;"#9;"#9;voice (0 to 1).

voice_get_reverb_type

  • int voice_get_reverb_type ( RID voice ) const

Return the current reverb type for a given voice"#10;"#9;"#9;"#9;from the REVERB_* enum.

voice_get_reverb

  • real voice_get_reverb ( RID voice ) const

Return the current reverb send for a given voice"#10;"#9;"#9;"#9;(0 to 1).

voice_get_mix_rate

  • int voice_get_mix_rate ( RID voice ) const

Return the current mix rate for a given voice.

voice_is_positional

  • bool voice_is_positional ( RID voice ) const

Return wether the current voice is positional. See"#10;"#9;"#9;"#9;voice_set_positional.

voice_stop

  • void voice_stop ( RID voice )

Stop a given voice.

free

  • void free ( RID rid )

Free a RID resource.

set_stream_global_volume_scale

  • void set_stream_global_volume_scale ( real scale )

Set global scale for stream playback. Default is 1.0.

get_stream_global_volume_scale

  • real get_stream_global_volume_scale ( ) const

Return the global scale for stream playback.

Clone this wiki locally