[[tags: allegro game]]
== allegro
This document pertains to audio related methods found in the Allegro egg.
Please see the main [allegro] wiki page for more information.
[[toc:]]
== Constants
* audio-pan-none
== Enums
=== audio-depth
(audio-depth->int audio-depth)
{{{audio-depth}} may be one of the following symbols:
* int8
* int16
* int24
* float32
* unsigned
* uint8
* uint16
* uint24
(int->audio-depth integer)
=== channel-configuration
(channel-configuration->int channel-configuration)
{{channel-configuration}} may be one of the following symbols:
* one
* two
* three
* four
* five-one
* six-one
* seven-one
(int->channel-configuration integer)
=== mixer-quality
(mixer-quality->int mixer-quality)
{{mixer-quality}} may be one of the following symbols:
* point
* linear
(int->mixer-quality integer)
=== playmode
(playmode->int playmode)
{{playmode}} may be one of the following symbols:
* once
* loop
* bidirectional
(int->playmode integer)
== Records
=== audio-stream
audio-stream
=== mixer
mixer
=== sample
sample
=== sample-id
sample-id
=== sample-instance
sample-instance
=== voice
voice
== Functions
=== Audio
(make-sample* (blob buffer) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration (bool free-buffer))
Implements al_create_sample.
(make-sample (blob buffer) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration (bool free-buffer))
Implements al_create_sample, with (free-sample!) declared as a finalizer.
(free-sample! sample)
Implements al_destroy_sample.
(make-sample-instance* sample)
Implements al_create_sample_instance.
(make-sample-instance sample)
Implements al_create_sample_instance, with (free-sample-instance!) declared as a finalizer.
(free-sample-instance! sample)
Implements al_destroy_sample_instance.
(sample-frequency sample)
Implements al_get_sample_frequenecy.
(sample-length sample)
Implements al_get_sample_length.
(sample-depth sample)
Implements al_get_sample_depth.
(sample-channels sample)
Implements al_get_sample_channels.
(sample-instance-frequency sample-instance)
Implements al_get_sample_instance_frequency.
(sample-instance-length sample-instance)
Implements al_get_sample_instance_length.
(sample-instance-position sample-instance)
Implements al_get_sample_instance-position.
(sample-instance-speed sample-instance)
Implements al_get_sample_instance_speed.
(sample-instance-gain sample-instance)
Implements al_get_sample_instance_gain.
(sample-instance-pan sample-instance)
Implements al_get_sample_instance_pan.
(sample-instance-time sample-instance)
Implements al_get_sample_instance_time.
(sample-instance-depth sample-instance)
Implements al_get_sample_instance_depth.
(sample-instance-channels sample-instance)
Implements al_get_sample_instance_channels.
(sample-instance-playmode sample-instance)
Implements al_get_sample_instance_playmode.
(sample-instance-playing? sample-instance)
Implements al_get_sample_instance_playing.
(sample-instance-attached? sample-instance)
Implements al_get_sample_instance_attached.
(sample-instance-position-set! sample-instance unsigned-integer)
Implements al_set_sample_instance_position.
(sample-instance-length-set! sample-instance unsigned-integer)
Implements al_set_sample_instance_length.
(sample-instance-speed-set! sample-instance float)
Implements al_set_sample_instance_speed.
(sample-instance-gain-set! sample-instance float)
Implements al_set_sample_instance_gain.
(sample-instance-pan-set! sample-instance float)
Implements al_set_sample_instance_pan.
(sample-instance-playmode-set! sample-instance playmode)
Implements al_set_sample_instance_playmode.
(sample-instance-playing-set! sample-instance bool)
Implements al_set_sample_instance_playing.
(sample-instance-detach! sample-instance)
Implements al_detach_sample_instance.
(sample-instance-sample sample-instance)
Implements al_get_sample.
(sample-instance-sample-set! sample-instance sample)
Implements al_set_sample
(sample-instance-play sample-instance)
Implements al_play_sample_instance.
(sample-instance-stop sample-instance)
Implements al_stop_sample_instance.
(make-audio-stream* (integer buffer-count) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration)
Implements al_create_audio_stream.
(make-audio-stream (integer buffer-count) (unsigned-integer samples) (unsigned-integer frequency) audio-depth channel-configuration)
Implements al_create_audio_stream, with (free-audio-stream!) declared as a finalizer.
(free-audio-stream! audio-stream)
Implements al_destroy_audio_stream.
(audio-stram-drain audio-stream)
Implements al_drain_audio_stream.
(audio-stream-frequency audio-stream)
Implements al_get_audio_stream_frequency.
(audio-stream-length audio-stream)
Implements al_get_audio_stream_length.
(audio-stream-fragments audio-stream)
Implements al_get_available_audio_stream_fragments.
(audio-stream-available-fragments audio-stream)
Implements al_get_available_audio_stream_fragments.
(audio-stream-speed audio-stream)
Implements al_get_audio_stream_speed.
(audio-stream-gain audio-stream)
Implements al_get_audio_stream_gain.
(audio-stream-channels audio-stream)
Implements al_get_audio_stream_channels.
(audio-stream-depth audio-stream)
Implements al_get_audio_stream_depth.
(audio-stream-playmode audio-stream)
Implements al_get_audio_stream_playmode.
(audio-stream-playing? audio-stream)
Implements al_get_audio_stream_playing.
(audio-stream-attached? audio-stream)
Implements al_get_audio_stream_attached.
(audio-stream-fragment audio-stream)
Implements al_get_audio_stream_fragment.
(audio-stream-speed-set! audio-stream float)
Implements al_set_audio_stream_speed.
(audio-stream-gain-set! audio-stream float)
Implements al_set_audio_stream_gain.
(audio-stream-pan-set! audio-stream float)
Implements al_set_audio_stream_pan.
(audio-stream-playmode-set! audio-stream playmode)
Implements al_set_audio_stream_playmode.
(audio-stream-playing-set! audio-stream bool)
Implements al_set_audio_stream_playing.
(audio-stream-detach! audio-stream)
Implements al_detach_audio_stream.
(audio-stream-fragment-set! audio-stream c-pointer)
Implements al_set_audio_stream_fragment.
(audio-stream-rewind! audio-stream)
Implements al_rewind_audio_stream.
(audio-stream-seek-seconds! audio-stream double)
Implements al_seek_audio_stream_secs.
(audio-stream-position-seconds audio-stream)
Impements al_get_audio_stream_position_secs.
(audio-stream-length-seconds audio-stream)
Implements al_get_audio_length_secs.
(audio-stream-loop-set! audio-stream (double start-seconds) (double end-seconds))
Implements al_set_audio_stream_loop_secs.
(audio-stream-event-source audio-stream)
Implements al_get_audio_stream_event_source.
(make-mixer* (unsigned-integer frequency) audio-depth channel-configuration)
Implements al_create_mixer.
(make-mixer (unsigned-integer frequency) audio-depth channel-configuration)
Implements al_create_mixer, with (free-mixer!) declared as a finalizer.
(free-mixer! mixer)
Implements al_destroy_mixer.
(sample-instance-attach-to-mixer! sample-instance mixer)
Implements al_attach_sample_instance_to_mixer.
(audio-stream-attach-to-mixer! audio-stream mixer)
Implements al_attach_audio_stram_to_mixer.
(mixer-attach-to-mixer! mixer mixer)
Implements al_attach_mixer_to_mixer.
(mixer-postprocess-callback-set! mixer (function void (c-pointer unsigned-integer32 c-pointer)) (c-pointer data))
Implements al_set_mixer_postprocess_callback.
(mixer-frequency mixer)
Implements al_get_mixer_frequency.
(mixer-channels mixer)
Implements al_get_mixer_channels.
(mixer-depth mixer)
Implements al_get_mixer_depth.
(mixer-quality mixer)
Implements al_get_mixer_quality.
(mixer-playing? mixer)
Implements al_get_mixer_playing.
(mixer-attached? mixer)
Implements al_get_mixer_attached.
(mixer-frequency-set! mixer unsigned-integer)
Implements al_set_mixer_frequency.
(mixer-quality-set! mixer mixer-quality)
Implements al_set_mixer_quality.
(mixer-playing-set! mixer bool)
Implements al_set_mixer_playing.
(mixer-detach! mixer)
Implements al_detach_mixer.
(make-voice* (unsigned-integer frequency) audio-depth channel-configuration)
Implements al_create_voice.
(make-voice (unsigned-integer frequency) audio-depth channel-configuration)
Implements al_create_voice, with (free-voice!) declared as a finalizer.
(free-voice! voice)
Implements al_destroy_voice.
(sample-instance-attach-to-voice! sample-instance voice)
Implements al_attach_sample_instance_to_voice.
(audio-stream-attach-to-voice! audio-stram voice)
Implements al_attach_audio_stream_to_voice.
(mixer-attach-to-voice! mixer voice)
Implements al_attach_mixer_to_voice.
(voice-detach! voice)
Implements al_detach_voice.
(voice-frequency voice)
Implements al_get_voice_frequency.
(voice-position voice)
Implements al_get_voice_position voice)
(voice-channels voice)
Implements al_get_voice_channels.
(voice-depth voice)
Implements al_get_voice_depth.
(voice-playing? voice)
Implements al_get_voice_playing.
(voice-position-set! voice unsigned-integer)
Implements al_set_voice_position.
(voice-playing-set! voice bool)
Implements al_set_voice_playing.
(audio-addon-install)
Implements al_install_audio.
(audio-addon-uninstall)
Implements al_uninstall_audio.
(audio-addon-installed?)
Implements al_is_audio_installed.
(audio-addon-version)
Implements al_get_allegro_audio_version.
(channel-configuration-count channel-configuration)
Implements al_get_channel_count.
(audio-depth-size audio-depth)
Implements al_get_audio_depth_size.
(default-mixer)
Implements al_get_default_mixer.
(default-mixer-set! mixer)
Implements al_set_default_mixer.
(default-mixer-restore!)
Implements al_restore_default_mixer.
(sample-play sample (float gain) (float pan) (float speed) playmode sample-id)
Implements al_play_sample.
The Sample ID is written to the provided sample-id struct.
(sample-stop sample-id)
Implements al_stop_sample.
(reserve-samples integer)
Implements al_reserve_samples.
(stop-all-samples)
Implements al_stop_samples.
(register-sample-loader (string extension) (function sample ((const string))))
Implements al_register_sample_loader.
(register-sample-saver (string extension) (function bool ((const c-string) sample)))
Implements al_register_sample_saver.
(register-audio-stream-loader (string extension) (function audio-stream ((const string) size_t unsigned-integer32)))
Implements al_register_audio_stream_loader.
(register-sample-file-loader (string extension) (function sample (file)))
Implements al_register_sample_loader_f.
(register-sample-file-saver (string extension) (function bool (file sample)))
Implements al_register_sample_saver_f.
(register-audio-stream-file-loader (string extension) (function audio-stream (file size_t unsigned-integer)))
Implements al_register_audio_stream_loader_f.
(load-sample* string)
Implements al_load_sample.
(load-sample string)
Implements al_load_sample, with (free-sample!) declared as a finalizer.
(load-audio-stream* string (integer buffer-count) (unsigned-integer samples))
Implements al_load_audio_stream.
(load-audio-stream string (integer buffer-count) (unsigned-integer samples))
Implements al_load_audio_stream, with (free-audio-stream!) declared as a finalizer.
(load-audio-stream-from-file* file (string identity) (integer buffer-count) (unsigned-integer samples))
Implements al_load_audio_straem_from_file.
(load-audio-stream-from-file file (string identity) (integer buffer-count) (unsigned-integer samples))
Implements al_load_audio_straem_from_file, with (free-audio-stream!) declared as a finalizer.
(load-sample-from-file* file (string identity))
Implements al_load_sample_f.
(load-sample-from-file file (string identity))
Implements al_load_sample_f, with (free-sample!) declared as a finalizer.
(sample-save-to-file sample file (string identity))
Implements al_save_sample_f.
(sample-save sample (string filename))
Implements al_save_sample.
=== Audio Codec Addon
(acodec-addon-init)
Implements al_init_acodec_addon.
(acodec-addon-version)
Implements al_get_allegro_acodec_version.