三、音乐播放

Ａ、FMUSIC_PlaySong

　例子：FMUSIC_MODULE *mod = 0;／／初始化

　　　　　。。。

　　　　　。。。

　FMUSIC_PlaySong(mod);　　　／／播放

以下是此函数详细资料

／／／／／／／／／／／／／／／／／

FMUSIC_PlaySong

Starts a song playing.

signed char F_API FMUSIC_PlaySong(
FMUSIC_MODULE *mod
);

Parameters

Return Value

TRUE song succeeded playing
FALSE song failed playing

／／／／／／／／／／／／／／／／／／／／／／／／／／／／／

Ｂ、FSOUND_PlaySound

例子：FSOUND_SAMPLE　* notre_son；／／初始化

　　　　。。。。

　　　notre_son = FSOUND_Sample_Load(FSOUND_FREE, "sound\\bgsound.mp3", FSOUND_NORMAL, 0, 0);／／加载

　　　。。。。

　　FSOUND_PlaySound(0, notre_son);／／播放

以下是关于此函数的详细说明

／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／

FSOUND_PlaySound

Plays a sample in a specified channel, using the sample's default frequency, volume
and pan settings.
／／用一个指定通道来播放例子，使用默认的频率，音量，pan设置

int F_API FSOUND_PlaySound(
int channel,
FSOUND_SAMPLE *sptr
);

Parameters

Return Value

On success, the channel handle that was selected is returned.
On failure, -1 is returned.

Remarks

If you play a FSOUND_HW3D declared sample with this function, then the position and velocity
are set to those of the listener.

／／如果用这个函数播放一个FSOUND_HW3D声明例子，位置和速度被设置给倾听者

Other attributes such as volume, frequency and pan are taken
from the sample's default volume, frequency, pan etc.

／／其他属性如音量，频率和pan从默认中获取。
----------
The channel handle :
The return value is reference counted. This stops the user from updating a stolen channel.
Basically it means the only sound you can change the attributes (ie volume/pan/frequency/3d position) for are the one you specifically called playsound for. If another sound steals that channel, and you keep trying to change its attributes (ie volume/pan/frequency/3d position), it will do nothing.
This is great if you have sounds being updated from tasks and you just forget about it.
You can keep updating the sound attributes and if another task steals that channel, your original task wont change the attributes of the new sound!!!
The lower 12 bits contain the channel number. (yes this means a 4096 channel limit for FMOD :)
The upper 19 bits contain the reference count.
The top 1 bit is the sign bit.
ie
S RRRRRRRRRRRRRRRRRRR CCCCCCCCCCCC
----------
Remember if not using FSOUND_FREE, then the channel pool is split up into software and hardware channels.

／／记住如果没有正在使用FSOUND_FREE，之后通道pool会被分为软件和硬件通道。
Software channels occupy the first n indicies specified by the value passed into FSOUND_Init.
Hardware channels occupy the next n indicies after this, and can be a variable amount, depending on the hardware.

／／软通道占据用FSOUND_Init指定的Ｎ个 indicies 。硬通道分到之后Ｎ个 indicies ，可以有个有效量，取决于硬件
Use FSOUND_GetNumHardwareChannels to query how many channels are available in hardware.

／／可以使用FSOUND_GetNumHardwareChannels 去质问有多少通道在硬件中有效。

／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／

另：FSOUND_PlaySoundEx

例如：

channel = FSOUND_PlaySoundEx(FSOUND_FREE, samp2, NULL, TRUE);

以下是此函数的详细资料

／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／

FSOUND_PlaySoundEx

Extended featured version of FSOUND_PlaySound.

／／FSOUND_PlaySound的扩展版本
New functionality includes the ability to start the sound paused.

／／新函数包含开始声音暂停的功能。
This allows attributes of a channel to be set freely before the sound actually starts playing, until FSOUND_SetPaused(FALSE) is used.

／／这个通道允许属性在声音真正播放前被设为自由。直到使用FSOUND_SetPaused(FALSE)。
Also added is the ability to associate the channel to a specified DSP unit.

／／同样增加了分配通道到一个指定ＤＳＰ单元的功能。

This allows the user to 'group' channels into seperate DSP units, which allows effects to be inserted between these 'groups', and allow various things like having one group affected by reverb (wet mix) and another group of channels unaffected (dry).

／／允许用户把 'group' 通道分到可以把效果插入这些'group' 中的ＤＳＰ单元中，允许像有一组湿声和另一组干声明通道的各种方式。

This is useful to seperate things like music from being affected by DSP effects, while other sound effects are.
／／通常把如音乐的东西从ＤＳＰ效果分离。

int F_API FSOUND_PlaySoundEx(
int channel,
FSOUND_SAMPLE *sptr,
FSOUND_DSPUNIT *dspunit,
signed char startpaused
);

Parameters

Return Value

On success, the channel handle that was selected is returned.
On failure, -1 is returned.

Remarks

FSOUND_ALL is supported. Passing this will cause ALL channels to play. (note this could make things VERY noisy!)／／同上
If FSOUND_ALL is used the last channel success flag will be returned. This return value is not useful in most circumstances.／／如果是使用FSOUND_ALL ，返回的是最后通道值。返回值在大多情况下都没有用。
----------
The channel handle :
The return value is reference counted. This stops the user from updating a stolen channel.
This means the only sound you can change the attributes (ie volume/pan/frequency/3d position) for are the
one you specifically called playsound for. If another sound steals that channel, and you keep trying to
change its attributes (ie volume/pan/frequency/3d position), it will do nothing.
This is great if you have sounds being updated from tasks and you just forget about it.
You can keep updating the sound attributes and if another task steals that channel, your original task
wont change the attributes of the new sound!!!
The lower 12 bits contain the channel number. (yes this means a 4096 channel limit for FMOD :)
The upper 19 bits contain the reference count.
The top 1 bit is the sign bit.
ie
S RRRRRRRRRRRRRRRRRRR CCCCCCCCCCCC
----------
Remember if not using FSOUND_FREE, then the channel pool is split up into software and hardware channels.
Software channels occupy the first n indicies specified by the value passed into FSOUND_Init.
Hardware channels occupy the next n indicies after this, and can be a variable amount, depending on the hardware.
Use FSOUND_GetNumHardwareChannels to query how many channels are available in hardware.

／／同上
----------
If you attach a sound to a DSP unit (for grouping purposes), the callback for the DSP unit will be overwritten with fmod's internal mixer callback, so the callback the user supplied is rendered obsolete and is not called.
Also, do not attach sounds to system DSP units, the assignment will be ignored if you do.

／／如果你把一个声音附加在一个ＤＳＰ单元上，ＤＳＰ单元的回调将会被fmod的内在混合回调覆盖，所以用户提供的回调会作废和不被调用，同时，不把声音附加在系统ＤＳＰ单元，这个任务将会忽略。

／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／

Ｃ、FSOUND_Stream_Play

例子：FSOUND_Stream_Play(FSOUND_FREE, stream)

以下是此函数的详细说明

／／／／／／／／／／／／／／／／／／／／／／／／／／／／／／

FSOUND_Stream_Play

Starts a pre-opened stream playing.

int F_API FSOUND_Stream_Play(
int channel,
FSOUND_STREAM *stream
);

Parameters

Return Value

On success, the channel handle the stream is playing in is returned.
On failure, -1 is returned.

Remarks

When a stream starts to play, it inherits a special high priority (256).

／／当一个stream开始播放时，它继承一个特别高的优先权（２５６）。
It cannot be rejected by other sound effect channels in the normal fashion as the user can never set a priority above 255 normally.

／／当用户没有设置一个低于256的正常优先权时，它不能被其他声效通道以正常方式拒绝。
--------------
If the stream has been opened with FSOUND_NONBLOCKING, this function will not succeed until the stream is ready.
--------------
FSB streaming is not supported if the format from FSBank is 'Retain original format'. On PC platforms, only PCM and ADPCM FSB files are allowed.

／／同前
--------------
FSOUND_STEREOPAN is recommended for stereo streams if you call FSOUND_SetPan. This puts the left and right channel to full volume.

／／如果你调用FSOUND_SetPan，FSOUND_STEREOPAN会被推荐给立体声。他可以把左右声道都调为最大音量。
Otherwise a normal pan will give half volume for left and right. See FSOUND_SetPan for more information on this.

／／相反一个正常pan会带一半音量给左和右。查看FSOUND_SetPan 去了解更多信息。
--------------
You can use normal channel based commands (such as FSOUND_SetVolume etc) on the return handle, as it is a channel handle.

／／你可以用正常通道的基本命令到返回句柄上，当它是一个通道句柄时

另：FSOUND_Stream_PlayEx

例如：  channel = FSOUND_Stream_PlayEx(FSOUND_FREE, stream, NULL, TRUE);

以下是此函数的详细说明

／／／／／／／／／／／／／／／／／／／／／／／

FSOUND_Stream_PlayEx

Extended featured version of FSOUND_Stream_Play.
Added functionality includes the ability to start the stream paused. This allows attributes
of a stream channel to be set freely before the stream actually starts playing, until FSOUND_SetPaused(FALSE) is used.
Also added is the ability to associate the stream channel to a specified DSP unit. This allows
the user to 'group' channels into seperate DSP units, which allows effects to be inserted
between these 'groups', and allow various things like having one group affected by reverb (wet mix) and another group of
channels unaffected (dry). This is useful to seperate things like music from being affected
by DSP effects, while other sound effects are.
／／同上

int F_API FSOUND_Stream_PlayEx(
int channel,
FSOUND_STREAM *stream,
FSOUND_DSPUNIT *dspunit,
signed char paused
);

Parameters

Return Value

On success, a channel handle the stream is playing in is returned.
On failure, -1 is returned.

Remarks

When a stream starts to play, it inherits a special high priority (256).

／／同上
It cannot be rejected by other sound effect channels in the normal fashion as the user can never set a priority above 255 normally.

／／同上
--------
FSOUND_STEREOPAN is recommended for stereo streams if you call FSOUND_SetPan. This puts the left and right channel to full volume.
Otherwise a normal pan will give half volume for left and right. See FSOUND_SetPan for more information on this.

／／同上
--------
You can use normal channel based commands (such as FSOUND_SetVolume etc) on the return handle, as it is a channel handle.

／／同上

什么是FMOD?
FMOD是一个非常简单通用的audio引擎,可以在windows,winCE,Linux,GameCube Xbox等平台上很好运行.
FMOD是一个共享软件,如果不用于商业用途可以免费使用,商业用途需要付费100美金.详细情况请关注www.fomod.org

下载后将fmod.dll和fmodvc.lib加入你的工程中.并引用头文件fmod.h
在使用fmod播入音乐之前,首先要初始化,代码如下:
FSOUND_Init(44100,32,0);
第一个参数为单乐输出的rate,单位为赫兹,在这里我们设置为44100.
第二个参数为设置最大的通道数量
第三个参数,可以指定一些标识,如果我们想的话.这里暂时置它为0.

好了,现在我们准备开始播放单乐了,可FMOD道底支持什么样的单乐格式呢?
歌曲,采样或是文件流(song,sample and stream)?
FMOD将它细分在两个API中.他们分别是FSOUND和FMUSIC

所有的music如:mod,s3m,xm,it,mid,rmi,sgt,fsb 都通过FMUSIC 这个API来播放
FSOUND API是提供给压缩格式使用的.文件一般如:wav,mp3,ogg,raw等
这些格式,你都可以通过别的软件进行互相转换.
如果你要播放的单乐是像炮弹发射一样的短小的声音,那么你可以将这些声间转成sample
Samples将在播放前先解压到内存,而且可以多次播放.
如果你要播放的是象背景音乐一样的较长的音乐,你可以得到这个音乐转化为流,这将导致
使用一些CPU和内存,因为文件从磁盘读取然后转成流需要一个过程.同时需要注意一点,在
同一时间不能多次播放

FMUSIC:
用FMUSIC播放需要一个handle,看如下代码:
handle = FMUSIC_LoadSong("YourFileName");
FMUSIC_PlaySong(handle);
现在你可能注意到,几乎每个function的第一个参数都需要一个handle;

设置单量
FMUSIC_SetMasterVolume(handle,256);
256是最高音,0表示静音

暂定单乐
FMUSIC_SetPaused(handle,true);
FMUSIC_SetPaused(handle,false);

循环播放
FMUSIC_SetLooping(handle,true);

停止音乐
FMUSIC_StopSong(handle);

free内存
FMUSIC_FreeSong(handle);

一个例子:
#include <conio.h>
#include "inc/fmod.h"

FMUSIC_MODULE* handle;

int main ()
{
 // init FMOD sound system
 FSOUND_Init (44100, 32, 0);

 // load song
 handle=FMUSIC_LoadSong ("canyon.mid");

 // play song only once
 // when you want to play a midi file you have to disable looping
 // BEFORE playing the song else this command has no effect!
 FMUSIC_SetLooping (handle, false);

 // play song
 FMUSIC_PlaySong (handle);

 // wait until the users hits a key to end the app
 while (!_kbhit())
 {
 }

 //clean up
 FMUSIC_FreeSong (handle);
 FSOUND_Close();
}

下面开始介绍FSOUND
得到FSOUND的句柄:
handle = FSOUND_Sample_Load(0,"yourFileName",0,0,0);
FSOUND_PlaySound(0,handle);
这些音效在播放前将被载入内存,所以可能需要一点点时间.
第二行命令的第一个参数是播放时使用的通道.

设置音量
FSOUND_SetVolume(handle,255);
255为最大音量,0表示静音

暂停音乐
FSOUND_SetPaused(handle,true);
FSOUND_SetPaused(handle,false);

停止音乐
FSOUND_StopSound (handle);

清除内存
FSOUND_Sample_Free(handle);

看一个例子:
#include <conio.h>
#include "inc/fmod.h"

FSOUND_SAMPLE* handle;

int main ()
{
 // init FMOD sound system
 FSOUND_Init (44100, 32, 0);

 // load and play sample
 handle=FSOUND_Sample_Load (0,"sample.mp3",0, 0, 0);
 FSOUND_PlaySound (0,handle);

 // wait until the users hits a key to end the app
 while (!_kbhit())
 {
 }

 // clean up
 FSOUND_Sample_Free (handle);
 FSOUND_Close();
}

Streams:
handle=FSOUND_Stream_Open("YourFileName",0, 0, 0);
FSOUND_Stream_Play (0,handle);

停止音乐
FSOUND_Stream_Stop(handle);
清除
FSOUND_Stream_Close(handle);

一个例子:
#include <conio.h>
#include "inc/fmod.h"

FSOUND_STREAM* handle;

void main ()
{
 //init FMOD sound system
 FSOUND_Init (44100, 32, 0);

 //load and play sample
 handle=FSOUND_Stream_Open("sample.mp3",0, 0, 0);
 FSOUND_Stream_Play (0,handle);

 //wait until the users hits a key to end the app
 while (!_kbhit())
 {
 }

 //clean up
 FSOUND_Stream_Close(handle);
 FSOUND_Close();
}