$Date: 2005/10/22 13:22:42 $
$Revision: 1.24 $
-- Create new audio factory.
-- EiffelMedia audio subsystem
-- (From EM_SHARED_SUBSYSTEMS)
-- EiffelMedia CD ROM subsystem
-- (From EM_SHARED_SUBSYSTEMS)
-- EiffelMedia joystick subsystem
-- (From EM_SHARED_SUBSYSTEMS)
-- EiffelMedia network subsystem is
-- (From EM_SHARED_SUBSYSTEMS)
-- EiffelMedia timer subsystem
-- (From EM_SHARED_SUBSYSTEMS)
-- EiffelMedia video subsystem
-- (From EM_SHARED_SUBSYSTEMS)
-- Last music created
-- Last sound created
-- Set internal or external music player. This can be used to support more file formats.
--
-- If a_command is an empty string, the internal player will be used (should be default).
--
-- Set a_command to a complete command as if typed into the command line, but it should
-- expect the filename to be added as last argument.
--
-- Attention: This may not work on your system as sound device has to be opened twice.
-- Load music file from a_filename into last_music.
--
-- This can load WAVE, MOD, MIDI, OGG, MP3 and any file that can be played by a command.
-- Load music file from a_pointer into last_music.
--
-- This can load WAVE, MOD, MIDI, OGG, MP3.
--
-- Note: Set a filename by yourself for easier finding
-- file in lists and/or other containers.
-- Load a_memory_buffer as a RAW file into last_sound.
--
-- Attention: a_memory_buffer is a memory buffer containing a
-- RAW file in output format.
--
-- This function does very little checking, so don't
-- use this function, if you don't know what you're
-- doing.
--
-- Note: Set a filename by yourself for easier finding
-- file in lists and/or other containers.
-- Load sound from file a_filename into last_sound.
--
-- This can load WAVE, AIFF, RIFF, OGG, and VOC files.
--
-- Attention: You must have an open mixer before using this function
-- as it must know the output characteristics so it can
-- convert this sample for playback. This conversion is done
-- at load time.
-- Load sound from file pointer a_pointer into last_sound.
--
-- This can load WAVE, AIFF, RIFF, OGG, and VOC files.
--
-- Attention: You must have an open mixer before using this function
-- as it must know the output characteristics so it can
-- convert this sample for playback. This conversion is done
-- at load time.
--
-- Note: Set a filename by yourself for easier finding
-- file in lists and/or other containers.
-- Create sound from a_pointer into last_sound.
--
-- This can load WAVE, AIFF, RIFF, OGG, and VOC files.
--
-- Note: Set a filename by yourself for easier finding
-- file in lists and/or other containers.
-- Load a_memory_buffer as a WAVE/RIFF file into last_sound.
--
-- Attention: a_memory_buffer is a memory buffer containing a
-- WAVE file in output format.
--
-- This function does very little checking, so don't
-- use this function, if you don't know what you're
-- doing.
--
-- Note: Set a filename by yourself for easier finding
-- file in lists and/or other containers.
-- Create stream hook from a_callback.
--
-- Pass in an_argument if you need some userdata in the callback.
-- This argument will be present as a_userdata in later callbacks.
--
-- Note: Streaming may cause your application to crash if you're doing
-- a lot of CPU intensive work in parallel.
Singleton factory that creates objects of type EM_MUSIC, EM_SOUND
and/or to initialize an audio stream.
Use EM_SHARED_AUDIO_FACTORY to access this singleton.
Whenever possible, use creation from file or from pointer.
Avoid creating sound from memory except you know what you're doing.
Audio format has to be the same as output settings in this case.
Streaming will likely boost your CPU if you're doing a lot of other
stuff the same time.