fmod

fmod APIを使ったサウンドプログラム – リソース(*.rc)のデータを参照する

ma2 — Wed, 30 Oct 2013 20:00:00 GMT

いろいろあってて、5年振りに、fmod exの事を書きます。

---

ゲーム等で、音楽データが*.exeと別々になっていると、ユーザに音楽データ(ファイル)をさわってしまったりすることがあります。
対策として、音楽データのリソースを定義して、そこにデータを置きます。

※ ユーザー定義リソース/カスタムリソースと言われる物です

以下のコードが例です。

int hoge()
{
  HRSRC hRes = FindResource(0, MAKEINTRESOURCE(IDR_MP3), _T("MP3"));
  if(NULL != hRes){
    HGLOBAL hData = LoadResource(0, hRes);
    if(NULL != hData){
      DWORD dataSize = SizeofResource(0, hRes);
      char* data = (char*)LockResource(hData);

      FMOD_CREATESOUNDEXINFO sndInfo;
      ZeroMemory( &sndInfo, sizeof(FMOD_CREATESOUNDEXINFO) );
      sndInfo.cbsize = sizeof(FMOD_CREATESOUNDEXINFO);
      sndInfo.length = dataSize;

      result = FMOD_System_CreateStream( fmodsystem, data, FMOD_OPENMEMORY,
          &sndInfo, &fmodsound );
      if( result != FMOD_OK ){
        return -3;
      }
    }
  }
  return 0;
}

FindResourceからユーザー定義リソースがあるか捜索し、見つかった場合はLockResourceでロックします。
SizeofResourceをFMOD_CREATESOUNDEXINFOのlengthに渡します。

最後に、LockResourceからFMOD_System_CreateStreamへ渡します。
この際に第三引数に、FMOD_OPENMEMMORYを付けます。

androidでのfmod(リベンジ)

ma2 — Thu, 05 Jul 2012 17:26:00 GMT

去年書いた[これ]のリベンジです。

Eclipseとか、javaとか、androidとか、jarとか、全然知らない状態だったんだ、自分orz
androidでfmodのサンプル(examplesの「3D」)が手元で動くまで、かなり手探りでした。

使ったfmodのバージョンと置き場

(ここ)からダウンロードする fmodapi44109android を「c:\cygwin\」以下に置きました。

Javaの設定

今回は、Windows7で環境を作っています。
OSの環境変数の「CLASSPATH」に「.;C:\cygwin\fmodapi44100android\api\lib\fmodex.jar;C:\Program Files\Java\jre6\lib\ext\QTJava.zip」を追加しました。

cygwinの設定

前回も書いてますが、cygwin必要です。
必要な設定についでは、android ndkに書きました。
今回は「C:\cygwin\」以下がcygwinの環境です。

[FMOD_LIB]の設定

fmodapi44109android のdocumentationにある「Getting started with FMOD for Android.pdf」をP.8「Running Examples」を見ると、OSの環境変数の「FMOD_LIB」を指定するように指定があります。
環境変数に、[名前]「FMOD_LIB」、[内容]「C:\cygwin\fmodapi44100android\api\lib\fmodex.jar」を追加しました。

[eclipse]Javaのビルド・パス(1)

「プロジェクト(P)」→「プロパティー(P)」から、「*** のプロパティー」→「Javaのビルド･パス」→「ライブラリー(L)」の「外部 jar 追加(X)」で、fmodex.jarを選ぶ。

[eclipse]Javaのビルド・パス(2)

「プロジェクト(P)」→「プロパティー(P)」から、「*** のプロパティー」→「Javaのビルド･パス」→「順序およびエクセポート(O)」で、fmodex.jarを有効にする。

[android sdk]関連の設定

環境変数の「PATH」に、android sdkを置いた場所を追加します。

[android ndk]関連の設定

cygwinのホームディレクトリの「.bashrc」に、以下の3行を追加します。

export NDK_PROJECT_PATH=/cygdrive/d/Developers/Java/android/***
export ANDROID_NDK_ROOT=/cygdrive/c/cygwin/android_ndk_r*
export PATH=$PATH:$ANDROID_NDK_ROOT

NDK_PROJECT_PATH は、ndkのプロジェクト(=Eclipseで作ったプロジェクト?)。
ANDROID_NDK_ROOT は、ndkのルートを指定します。
PATH は、それまでのPATHにndkのルートを追加します。

・・・とりあえず出来た。

fmod APIを使ったサウンドプログラム - (番外)iPhone版 SDKがリリースされてました、が

ma2 — Sun, 30 Nov 2008 20:13:00 GMT

[注意] がっかりするエントリです

fmod APIに関連したエントリなのですが、今回は番外編です。

fmod exは、WindowsやMacやLinuxなどのPCプラットフォーム以外にWindowsCEやコンシューマゲーム機など多くのプラットフォームに対応したSDKを公開しています。
# プラットフォームをまたぐ縮小版(Mini FMOD)などもありマルチプラットフォームを目指しているようです

一週間ほど前に新たな対応プラットフォームとしてiPhone版がリリースされていました。

Firelight Technologies release FMOD Ex for iPhone.(21-11-2008) / FMOD music & sound effects system

そんなわけで、Macを持っていない当方ですが、中身ぐらいのぞけないかなと思いました。
が、いまこのエントリを書いている時点でSDKのダウンロードは出来なくなっていました。
iPhoneの開発事情は一度リリースしたアプリがAppStoreから取り下げられたりすることがあるので、そういう理由でおさえられちゃったのかなーと真っ先に思いました。

が、フォーラムをのぞくとそんな旨の書き込みは無く、バグ報告のスレッドがある程度でした。
さらに情報を探していてMac版のSDKも公開停止になっていることに気づきました。
iPhone関連の事情が理由じゃなくて、関連するプラットフォームだから一緒に引っ込めました、というのが真実だといいなと期待しています。

ということで、ちょっと紹介したかったことでがっかりしたエントリでした。

ちなみに、今回のfmod関連エントリはWindows(32bit)のみです。
# と書いておかないと大変なことになりそうなのでw

fmod APIを使ったサウンドプログラム - 楽曲のループと繰返し範囲

ma2 — Wed, 12 Nov 2008 23:38:00 GMT

fmod APIを使用したプログラムについて解説します。

前回は、システムの初期化からBGMの再生までの方法を紹介しました。
今回はそれを拡張する形でfmodの機能を紹介していきます。

前回はmusic.oggをBGMとして読み込みました。
しかし、プログラムを実行してみるとわかりますが、一度BGM再生が終了するとそれ以降は音が出ません。
繰り返しなり先頭に戻って再度演奏をするようにはなっていません。
これを繰り返し演奏にするには、FMOD_System_CreateStream APIの引数を以下のように変更します。

// fmodTest01の呼び出し(一度だけ再生)
result = FMOD_System_CreateStream( fmodsystem, "./music.ogg", FMOD_DEFAULT, NULL, &fmodsound );
↓
// 繰り返し再生
result = FMOD_System_CreateStream( fmodsystem, "./music.ogg", FMOD_DEFAULT | FMOD_LOOP_NORMAL, NULL, &fmodsound );

FMOD_MODE定数には、FMOD_LOOP_NORMAL(通常の繰り返しを有効にする)というフラグがあります。
これを指定すると、読み込んだデータの先頭から~~シュウたん~~終端までを繰り返しの範囲とすることが出来ます。

次に、ループ範囲を指定するAPIを紹介します。
これを使うことで、オーディオファイルに含まれている特定の範囲を繰り返しの範囲にすることが出来ます。

API名

FMOD_Channel_SetLoopPoints

構文

FMOD_RESULT FMOD_Channel_SetLoopPoints( FMOD_CHANNEL* channel, unsigned int loopstart, FMOD_TIMEUNIT loopstarttype, unsigned int loopend, FMOD_TIMEUNIT loopendtype );

引数

channel	繰返し範囲を設定するFMOD_CHANNELのポインタです。 FMOD_System_PlaySoundで演奏を開始した際に取得したものを使用します。
loopstart	繰返し範囲の開始地点を指定します。指定する値の単位は、loopstarttypeで指定したFMOD_TIMEUNIT定数によって変更することが出来ます。
loopstarttype	loopstart値の単位を指定します。
loopend	繰返し範囲の終了地点を指定します。指定する値の単位は、loopendtypeで指定したFMOD_TIMEUNIT定数によって変更することが出来ます。
loopendtype	loopend値の単位を指定します。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

channelで指定したチャンネルの繰り返し範囲を設定します。
開始地点/終了地点の設定値と単位は引数の項の通りです。
loopstarttype/loopendtypeで指定できる単位(FMOD_TIMEUNIT定数)にはさまざまな種類がありますが、一般的なものは以下の定数です。

FMOD_TIMEUNIT_MS	ミリ秒(1/1000秒)単位での指定です。
FMOD_TIMEUNIT_PCM	PCMでのサンプル単位です。サンプリングレートが44.1KHzのデータであった場合、チャンネルやビットレートに関わらず1/44100秒刻みの単位になります。
FMOD_TIMEUNIT_PCMBYTES	PCMでのバイト指定です。 FMOD_TIMEUNIT_PCMBYTESとは違い、サンプリングレート/チャンネル/ビットレートに応じて計算方法が異なります。

例として、開始地点を1000ミリ秒/終了地点を9000ミリ秒にする場合の記述をする場合は以下のようにします。

long PlayMusicStream( void )
{
  FMOD_RESULT result;

  // BGMの再生(頭出し状態...一時停止)
  result = FMOD_System_PlaySound( fmodsystem, FMOD_CHANNEL_FREE, fmodsound, TRUE, &fmodchannel );
  if( result != FMOD_OK ){
    return -1;
  }
  // 繰返し範囲の設定
  FMOD_Channel_SetLoopPoints( fmodchannel, 1000, FMOD_TIMEUNIT_MS, 9000, FMOD_TIMEUNIT_MS );

  // 演奏位置の設定 ... (*A)
  // FMOD_Channel_SetPosition( fmodchannel, 1000, FMOD_TIMEUNIT_MS );

  // 一時停止状態解除
  FMOD_Channel_SetPaused( fmodchannel, FALSE );
  return 0;
} 

# 見慣れないAPIがありますが後述します

繰返し範囲を設定する場合には、APIの呼び出しを工夫する必要があります。
FMOD_Channel_SetLoopPointsを呼び出す際にFMOD_CHANNEL*をあらかじめ取得しておく必要があります。
しかし、FMOD_CHANNEL*を取得する際にFMOD_System_PlaySoundを前回のサンプル(fmodTest01)そのままの状態で呼び出してしまうと演奏が始まってしまいます。
そこで第四引数のpausedをFALSEからTRUEにします。
これでAPI呼び出し直後から演奏が始まる事を防ぐことが出来ます。
次に、FMOD_Channel_SetLoopPointsを呼び出します。
最後に、FMOD_Channel_SetPausedを呼び出して一時停止を解除します。
FMOD_Channel_SetPaused APIは、FMOD_System_PlaySoundの第四引数pausedの状態だけを変更するAPIです。
このAPIの解説は省略します。

この状態で演奏をすると、最終的に繰り返し再生になりますが、初回の演奏のみBGMが先頭から演奏されます。
これを回避する処理がコメントになっている(*A)の部分になります。

API名

FMOD_Channel_SetPosition

構文

FMOD_RESULT FMOD_Channel_SetPosition( FMOD_CHANNEL* channel, unsigned int position, FMOD_TIMEUNIT postype );

引数

channel	繰返し範囲を設定するFMOD_CHANNELのポインタです。 FMOD_System_PlaySoundで演奏を開始した際に取得したものを使用します。
position	演奏を行う地点を指定します。指定する値の単位は、postypeで指定したFMOD_TIMEUNIT定数によって変更することが出来ます。
postype	position値の単位を指定します。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

channelで指定したチャンネルの演奏位置を設定します。
変更は、チャンネルが一時停止状態でない場合は即座に反映されます。
チャンネルが一停止状態であった場合は、一時停止が解除された瞬間に指定地点からの演奏が始まるようになります。
postypeで指定できる単位(FMOD_TIMEUNIT定数)はFMOD_Channel_SetLoopPoints APIの解説を参照してください。

(*A)のコメントを解除した場合、初回の演奏から繰返し範囲の先頭から演奏が始まります。

以上が繰り返し再生とその設定方法になります。

fmod APIを使ったサウンドプログラム - 初期化/終了とBGM再生/停止

ma2 — Mon, 10 Nov 2008 15:14:00 GMT

fmod APIを使用したプログラムについて解説します。
今回から具体的なAPIを使用したプログラミングに入ります。

Win32のプロジェクトなので要点以外のコードがとても多かったり、先にソースを読んでおいて解説と並行したいという方もいると思います。
ということで出来上がったものをこちらにあらかじめ用意しました。

# 料理講座っぽく言ってみたかっただけです

このプロジェクトでは、次の処理を行っています。

fmodシステムの初期化(InitMusicStream関数)
BGMとして使用するオーディオファイルの読み込み(PlayMusicStream関数)
fmodシステムの終了処理(ReleaseMusicStream関数)

これらの処理は、それぞれ関数化してWinMain.cppで呼び出すようにしています。
カッコ内の関数名はfmodTest.cpp内で定義されています。

fmodTest.cpp内の解説に移ります。
このソースファイルには、3個のグローバル変数があります。

FMOD_SYSTEM*    fmodsystem = NULL;
FMOD_SOUND*     fmodsound = NULL;
FMOD_CHANNEL*   fmodchannel = NULL;

このFMOD_SYSTEM、FMOD_SOUND、FMOD_CHANNELはそれぞれオーディオシステム全体、再生する楽曲/効果音データ、データ再生時チャンネルのハンドルです。
ヘッダファイル(fmod.h)内では、それぞれ構造体として定義されていますが、メンバまでは記述されていません。
現時点ではこれらの情報を追求する必要はないので｢こういうもの｣という程度にとどめておいてください。

次にInitMusicStream関数内で呼び出しているAPIの解説です。

API名

FMOD_System_Create

構文

FMOD_RESULT FMOD_System_Create( FMOD_SYSTEM* system );

引数

system

FMOD_SYSTEMのポインタです。
処理が成功した場合、生成されたFMODシステムのアドレスが返されます。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

FMOD_SYSTEMオブジェクトを生成します。
FMOD_SYSTEMオブジェクトは、生成しただけでは使用できないので返されたsystemをFMOD_System_Initに渡し、初期設定を行う必要があります。

API名

FMOD_System_Init

構文

FMOD_RESULT FMOD_System_Init( FMOD_SYSTEM* system, int maxchannels, FMOD_INITFLAGS flags, void* extradriverdata );

引数

system	FMOD_SYSTEMのポインタです。 FMOD_System_Createで生成したものを使います。
maxchannels	FMODで使用されるチャンネルの最大数です。通常は100もあれば困ることはありません。
flags	拡張機能を合わせて初期化するためのフラグです。特に必要がなければFMOD_INIT_NORMALだけを指定します。 FMOD_INIT_NORMAL以外のFMOD_INITFLAGS定数については、ヘッダファイルもしくはリファレンスマニュアルを参照してください。
extradriverdata	サウンドデバイスのドライバに渡すデータがある場合に使用する引数です。渡すデータがない場合は、NULLを渡します。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

systemで指定したFMOD_SYSTEMオブジェクトの初期設定を行います。
設定できる内容はmaxchannelsとflagsの解説を参照してください。

API名

FMOD_System_CreateStream

構文

FMOD_RESULT FMOD_System_CreateStream( FMOD_SYSTEM* system, const char* name_or_data, FMOD_MODE mode, FMOD_CREATESOUNDEXINFO* exinfo, FMOD_SOUND** sound );

引数

system	FMOD_SYSTEMのポインタです。 FMOD_System_Createで生成したものを使います。
name_or_data	再生するオーディオデータのパスもしくはURLです。音楽CDを再生する場合はドライブレターを指定します(例、Eドライブの場合は"E:")。ファイルパスはマルチバイト文字列で指定します。UNICODEビルドをした場合でもワイド文字列は使用できません。
mode	ファイルを開く際に指定する条件のフラグです。特に必要がなければFMOD_DEFAULTだけを指定します。FMOD_DEFAULT以外のFMOD_MODE定数については、ヘッダファイルもしくはリファレンスマニュアルを参照してください。
exinfo	開いたファイルに関する情報(FMOD_CREATESOUNDEXINFO構造体)です。取得できる情報については、ヘッダファイルもしくはリファレンスマニュアルを参照してください。
sound	FMOD_SOUNDのポインタをアドレスで渡します(形式上ダブルポインタになる)。ここで返される値は、FMOD_Sound_* APIを呼び出す際に必要になります。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

name_of_dateで指定したパスやファイルを開きます。
オンライン上のURLや音楽CDのドライブを指定することもできます。
このAPIでは指定したパスをストリーム再生(再生をする際に必要なデータを逐次読み込んでいく)する形式で読み込みます。
パスやファイルを開くことができた場合、soundにそのデータのアドレスが返されます。

リファレンスがたくさん出てきましたが、初期化処理で指定する値は特殊環境でなければデフォルト推奨値でよいと思います。
FMOD_System_CreateとFMOD_System_InitがFMODシステムの生成と初期化処理で、次にFMOD_System_CreateStreamでBGMに使用するファイルを開きます。
ここまでが初期化処理(とファイルオープン処理)になります。

次にPlayMusicStream関数内で呼び出されているAPIの説明です。

API名

FMOD_System_PlaySound

構文

FMOD_RESULT FMOD_System_PlaySound( FMOD_SYSTEM* system, FMOD_CHANNELINDEX channelid, FMOD_SOUND* sound, FMOD_BOOL paused, FMOD_CHANNEL** channel );

引数

system	FMOD_SYSTEMのポインタです。 FMOD_System_Createで生成したものを使います。
channelid	再生の際に使用するチャンネルを指定します。 FMOD_CHANNEL_FREE(-1)を指定すると空いているチャンネルに自動割り当てされます。特定のチャンネルを指定する場合は、ゼロ以上の値を指定します。
sound	再生するデータのFMOD_SOUNDのポインタ。 FMOD_System_CreateStreamで作成したものを使います。
paused	API呼び出し直後に再生を進めるかを指定します。 TRUEを指定した場合、一時停止状態になります。一時停止の解除は、FMOD_Channel_SetPaused APIを使用します。 (このエントリでは解説しません)
channel	再生を行うチャンネル(FMOD_CHANNEL)のポインタです。再生中のBGMや効果音に対する操作/設定をするAPIで必要になります。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

soundに指定したFMOD_SOUNDを再生します。
呼び出しが成功した場合、channelに再生チャンネルのハンドルが返され、再生が始まります(ただし、pausedによる一時停止設定など例外もあります)。

PlayMusicStream関数が呼び出され、FMOD_System_PlaySound APIが呼び出されれば、演奏が始まります。

最後に、プログラム終了時に行うFMODシステムの終了処理のAPIを解説します。

API名

FMOD_Channel_Stop

構文

FMOD_RESULT FMOD_Channel_Stop( FMOD_CHANNEL* channel );

引数

channel

データ再生をしているチャンネルのハンドルです。
FMOD_System_PlaySound等の呼び出しで取得したものを指定します。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

channelで指定したチャンネルの演奏を停止します。

API名

FMOD_Sound_Release

構文

FMOD_RESULT FMOD_Sound_Release( FMOD_SOUND* sound );

引数

sound

再生のためにオープン(ストリーム)もしくは読み込んでいるデータのハンドルです。
FMOD_System_CreateStream等で取得したものを使用します。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

soundで指定したデータを開放します。

API名

FMOD_System_Close

構文

FMOD_RESULT FMOD_System_Close( FMOD_SYSTEM* system );

引数

system

FMOD_SYSTEMのポインタです。
FMOD_System_Createで生成したものを使います。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

systemで指定したFMODシステムを使用できないようにします。
このAPIを呼び出す前にFMODシステムに関連するリソースは開放するようにしてください。

API名

FMOD_System_Release

構文

FMOD_RESULT FMOD_System_Release( FMOD_SYSTEM* system );

引数

system

FMOD_SYSTEMのポインタです。
FMOD_System_Createで生成したものを使います。

返り値

FMOD_RESULT(FMOD_OKであれば成功、それ以外は各種エラーコード)

解説

systemで指定したFMODシステムを開放します。
このAPIでシステムを開放する場合、事前にFMOD_System_Closeを呼ぶ必要はありません。

リファレンスによれば、FMOD_System_ReleaseすればFMOD_System_Closeは省いてよいようですが、念のためサンプルではClose→Releaseと呼び出しています。

以上が、fmod APIの初期化/終了の処理と最低限のBGM再生を行うための解説です。
ここまでの処理ができれば、後は素材を揃えてAPIで遊ぶことができます。

最後に、サンプルを動かすための注意をいくつか。

fmodex.dllをコピーしてください。
このサンプルはfmodex.dllが読み込めないと動作しません。
SDKをインストールしたフォルダの｢./api｣フォルダにfmodex.dllというファイルがあります。
これをサンプルのプロジェクトファイルがあるフォルダにコピーしてください。
また、VisualStudio上から実行した場合と、ビルドしてできたexeファイルを直接呼び出す場合では、dllの配置場所を変えないといけません。
VisualStudioから実行する場合は、プロジェクトファイルがあるフォルダに置いてください。
exeファイルを直接実行する場合は、exeファイルと同じ場所に置いてください。
music.oggを用意してください。
このサンプルでは、music.oggというファイルを読み込んで再生しています。
オーディオファイルは、mp3やwavでもよいのですが、サンプルで指定しているものと名前が一致するようにしてください。
fmodのSDKには、サンプルとしていくつかのoggファイルがインストールの時点で作成されます。
インストールフォルダ配下の｢.\fmoddesignerapi\examples\media\music｣からファイルをコピーして名前を変更して使うこともできます。
music.oggはサンプルに同梱していません。
# excited.oggやrelaxed.oggは演奏時間が長いです

以上が、fmod APIを使った簡単なサンプルになります。

fmod APIを使ったサウンドプログラム - プロジェクト設定

ma2 — Mon, 10 Nov 2008 01:11:00 GMT

fmod APIを使用したプログラムについて解説します。
今回はAPIの形式とそれにあわせて生じるプロジェクトの設定について解説します。

プログラム言語は、C言語を使います。
開発環境は、VisualStudio2005(SP1)です。

fmodはC言語ではハンドルを使ったAPI、C++ではシステムやサウンドなど機能ごとのクラスが提供されます。
ヘッダファイルもfmod.hとfmod.hppとそれぞれ別のものが用意されています。
fmod.hはC++でも使用できます。

はじめは、fmodの初期化/終了とオーディオファイルの再生と停止をするデモです。
最初ということで、プロジェクト設定もあわせて行います。

まず、プロジェクトを作成します。
メニューの[ファイル]→[新規作成]→[プロジェクト]を選択し、[Win32プロジェクト](プロジェクトの種類を[Visual C++]→[Win32]の順)を選びます。
プロジェクト名と場所は特に制限は無いので自由に決めてください。
解説の都合上、プロジェクト名は｢fmodTest｣とします。
プロジェクト作成のウィザードでは｢空のプロジェクト｣をチェックしてください。
このエントリでは過去に公開したゲーム雛形のソースファイルをベースにします。
プロジェクトを作成したフォルダにソースファイルをコピーしてプロジェクトに追加します。

ここからプロジェクトの設定です。
SDKのインストールでインストールパスのデフォルトは｢C:\Program Files\FMOD SoundSystem\FMOD Programmers API Win32｣であると書きました。
このパスが必要になります。

fmod APIをC/C++から呼び出す場合ヘッダファイルとライブラリファイルをそれぞれインクルード/リンクする必要があり、そのためにパスを追加しなければいけません。
追加が必要なパスは以下のとおりです。

種類	場所
ヘッダファイル	C:\Program Files\FMOD SoundSystem\FMOD Programmers API Win32\api\inc
ライブラリファイル	C:\Program Files\FMOD SoundSystem\FMOD Programmers API Win32\api\lib

要するにインストールパスの配下なのですが、これを設定しなければいけません。

インクルードパスの設定は、プロジェクトのプロパティから[C/C++]のタブを選びます。

# この項目は、ソースファイルを追加した後でないと表示されません。

ライブラリのパスは、同プロパティから[リンク]のタブを選びます。

最後にリンクするライブラリファイルを設定します。

[追加の依存ファイル]だけは、ファイルを指定します。
fmod SDKのlibファイルを見るとたくさんファイルがありますが、ここでは｢fmodex_vc.lib｣を設定します。

これらの設定は、デバッグビルド/リリースビルド共通です。
[構成]コンボボックスで｢すべての構成｣を選ぶことで、一括設定ができます。

プロジェクト設定は以上です。サンプルコードの追加に続きます。

fmod APIを使ったサウンドプログラム - SDKのインストール

ma2 — Sun, 09 Nov 2008 15:24:00 GMT

fmodのSDKインストールについて解説します。

fmod SDKはfmodのサイト上では、｢fmod EX Programming API｣と呼ばれています。
fmodのサイトからダウンロードのページに行きます。
ロゴのすぐ下に"Links"という項目があります。
そこから｢FMOD Ex Progrramers API｣という項目を選びます。

(これを書いている2008/11/09現在ではすぐ真下ですが)プラットフォームごとのファイルのリンクに移ります。
自分の環境はWindowsVistaの32ビット環境なので｢Windows 32bit｣がプラットフォームになります。
さらにSDKにはstable(安定版)とdevelopment(開発者向け)の2種類がありますが、stableをダウンロードします。

ダウンロードしたSDKのバージョンは4.20.01です。
ファイル名は｢fmodapi42001win32-installer.exe｣になります。
これを起動してインストールします。

いわゆるインストール画面なのですが、進めるにあたっての要点をまとめました。
# とりあえず全部撮ったんですが多かったので

インストール先は、｢C:\Program Files\FMOD SoundSystem\FMOD Programmers API Win32｣がデフォルトです。
これは変更できます。
インストールの最後にコマンドプロンプトが開いて処理を始めます。
これは、同梱されているサンプルを動かすための準備です。

以上でインストールは完了です。

fmod APIを使ったサウンドプログラム - fmodの紹介

ma2 — Sun, 09 Nov 2008 05:28:00 GMT

どうも、ma2(まっつ)です。
ちょっと思うところがあって連載もどきなことをやってみようかと思います。

｢fmod music & sound effect system｣というものがあります。
これはオーストラリアの｢Firelight Technologies｣という会社が提供する、音楽再生をするためのライブラリとツールキットです。
対応するプラットフォームは、Windows(32/64bit),WindowsCE(WindowsMobile),Macintosh(PPC or Intel),Linux(32/64bit),Solarisとコンシューマゲーム機となっています。
SDKやランタイムをダウンロードできるのは上述の｢コンシューマゲーム機｣以外のもの(以降PC版)になります。
PC版のSDKの利用は非商用に限り無償で利用できます(ただし使用していることをreadme等で明示しないといけない)。
商用利用をする場合はライセンス契約が必要になり、条件にに応じて使用料を支払う必要があります。
コンシューマゲーム機での利用はゲーム機のプラットフォームホルダーと開発契約をしているメーカにのみ提供されます。

対応するオーディオ形式は、wave/midi/mp3/ogg/XMA(*1)/mod各種です。
ただし、fmodシステムそのものに16チャンネルという制限があるので、多くのチャンネルを使っているmidiとmodは気をつけたほうがいいかもしれません。
# *1 ... Xbox360開発環境XNAのツールXACTに対応した形式

使用できる言語は、C/C++とC#とVB6。C#で使えるのはインパクトがあると思います。

堅苦しいことを丸写ししましたが、要するにちょっと使う分には自由に使えるのでこれを使ってBGMを流したり効果音を出したりするプログラムを作ってみるのが目的です。

ちなみにこのfmod APIは、以前公開したメガデモもどきでも使いました。
# 音楽再生まで手が回らなかったのでorz