Sound Library - One Shotモジュールコントロール関数

sdShotSetVol

One Shotポートのボリュームの設定

書式

SDE_ERR sdShotSetVol( handle, vol, fade_time )
SDSHOT handle
const Sint8 vol
const Sint32 fade_time

引数

handle   One Shotポートのハンドル
vol   ボリューム値
fade_time   指定したボリューム値に達するまでの時間

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない
SDE_ERR_HANDLE_NULL   ハンドルがNULL
SDE_ERR_HOST_CMD_BUF_NO_ENOUGH   ホストコマンドのバッファが不足

解説

指定したポートのOne Shotのボリューム設定をします。

ボリューム値を指定する引数 volの値の範囲は-007FH(最小)〜0000H(標準)〜007FH(最大)です。

指定のボリューム値に達するまでの時間を指定する引数 fade_timeの単位はミリ秒で範囲は0000H(最速)〜7FFFH(最遅)です。 このボリューム値に達するまでの時間中、VSync毎にsdSysServer()関数が実行されていなければなりません。


備考

引数volに指定する値が小さすぎるとサウンドが聞こえなくなる場合があります。 また値を大きくしても、元データのボリューム値が十分に大きいなどの原因で一定以上大きくならない場合があります。

定期的なタイミングで行うアプリケーションで用意したサーバ関数などで、V同期で変化のない値を毎回設定し続けることは効率的なHost Command Bufferの利用方法でないばかりか、Sound Driverの負荷を増やす原因になります。 なるべく行わないでください。


sdShotSetVol
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000