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

sdShotSetReleaseMode

One ShotポートのOne Shot Dataの再生停止時のリリースの設定

書式

SDE_ERR sdShotSetReleaseMode( handle, release_mode)
SDSHOT handle
SDE_PORT_RELEASE_MODE release_mode

引数

handle   One Shotポートのハンドル
release_mode   設定するリリースモード

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない
SDE_ERR_HOST_CMD_BUF_NO_ENOUGH   ホストコマンドのバッファが不足
SDE_ERR_PRM_ILLEGALE_VALUE   引数が正常な値の範囲外

解説

sdStopStop()関数を使用してOne Shot Dataの再生停止を行う時発音中の音のリリース(余韻)を有効にするかどうかを指定します。

次の値を設定することができます。

 定義   意味 
 SDE_PORT_RELEASE_MODE_ENABLE   リリースを有効にする 
 SDE_PORT_RELEASE_MODE_DISABLE   リリースを無効にする 


備考

One Shotポートを用いて曲・SEを再生し、停止してからサウンドメモリの内容を書き換える時(例えばMulti Unit Fileのダウンロードなど)音色のリリースが有効になっていると再生中の音色内容をダウンロードにて書き換えてしまい、ノイズになってしまう可能性があります。

このような場合、sdMidiSetRelaseMode()関数を利用していったんOne Shot Dataの再生停止時のリリースを無効にしておくと、ノイズが発生しなくなります。


参照

sdShotStop()
 One Shot再生の停止

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