$Date: 2005/10/22 13:22:42 $
$Revision: 1.33 $
-- Initalize channel with a_channel_volume and a_channel_number.
-- Last played (or still playing) sound sample on this channel
--
-- Note: Current sound may have been freed, so this pointer may not be valid anymore.
-- Sound chunk returned has no filename as created from pointer.
-- All applied effects to this channel
-- Is stereo reversed?
-- Is channel fading in or out?
-- Is channel fading in?
-- Is channel fading out?
-- is channel mute?
-- Is channel paused?
--
-- Attention: If channel was halted after pausing, channel is still paused.
-- Is channel playing?
--
-- Attention: A paused channel is also playing!
-- Current channel number
-- Current channel volume
-- Set a distance factor for this channel.
-- Distance range is [0..255].
--
-- Set a_distance to 0 to disable effect.
-- Set a number for the channel.
--
-- Note: Only use, if you know what you're doing.
-- Set panning for this channel.
-- Volume range for both sides is [0..255].
--
-- Set left_volume and right_volume to 255 to disable panning.
-- Set a postion with an_angle and a_distance for the channel.
-- Range of an_angle is [0..360] and range of a_distance is [0..255].
--
-- Values for `an_angle: 0 = directly in front of you.
-- 90 = directly to your right.
-- 180 = directly behind you.
-- 270 = directly to your left.
--
-- Set an_angle and a_distance to 0 to disable positioning.
-- Reverse stereo for the channel according to has_reversed_stereo.
-- Play a_sound for a_loop_count times with a fade in effect of
-- length a_duration milliseconds.
--
-- Passing in -1 for a_loop_count will loop infinite times.
-- Any other value will play the sample a_loop_count + 1 times.
--
-- Attention: This function is non-blocking.
-- Please check if the channel is fading before
-- you quit your application.
-- Play a_sound for a_loop_count times with a fade in effect of
-- length a_duration milliseconds and maximum time of a_tick_count
-- milliseconds.
--
-- Passing in -1 a_loop_count will loop infinite times.
-- Any other value will play the sample a_loop_count + 1 times.
--
-- Passing in -1 for a_tick_count will play sound forever.
--
-- Attention: This function is non-blocking.
-- Please check if the channel is fading before
-- you quit your application.
-- Play a_sound for a_loop_count times on this channel.
--
-- Passing in -1 for a_loop_count will loop infinite times.
-- Any other value will play the sample a_loop_count + 1 times.
-- Play a_sound for a_loop_count times on this channel for a maximum
-- of a_tick_count milliseconds.
--
-- Passing in -1 for a_loop_count will loop infinite times.
-- Any other value will play the sample a_loop_count + 1 times.
--
-- Passing in -1 for a_tick_count will play sound forever.
-- Halt channel after a_tick_count milliseconds.
-- Stop playing channel after fade out of a_duration milliseconds.
--
-- Attention: This function is non-blocking.
-- Please check if the channel is fading before
-- you quit your application.
-- Stop playing channel.
-- Maximum value for any volume setting.
-- (From EM_AUDIO_CONSTANTS)
Implements channels for use with audio mixer.
Use this class to play and pause sound files {EM_SOUND}.
You may also apply effects and do other manipulations.
Note: Whenever possible, don't create channels on your own.
Use {EM_CHANNELS}.extend instead, as channel numbering
must stay unique.
Fading is blocking as your application may crash if
closed while fading in or out.