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

sdMidiSetPitch

MIDIポートの再生ピッチの設定

書式

SDE_ERR sdMidiSetPitch( handle, pitch, fade_time )
SDMIDI handle
const Sint16 pitch
const Sint32 fade_time

引数

handle   MIDIポートのハンドル
pitch   再生ピッチ
fade_time   目的の再生ピッチに達するまでの時間

戻り値

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

解説

指定したMIDIポートに対して再生ピッチを設定をします。

再生ピッチを示す引数 pitchは、0100Hで半音上がり、-0100Hで半音下がりです。

引数pitchの値は作成されたデータのピッチバランスを基準に相対値で設定されます。 つまりpitchの値を元に戻すとき(データに設定されたピッチに戻すとき)は0を指定します。

再生ピッチに達するまで時間を示す引数 fade_time の単位はミリ秒で、範囲は0000H(最速)〜7FFFH(最遅)です。 この再生ピッチに達するまでの時間中、Sync毎にsdSysServer()関数が実行されていなければなりません。


備考

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

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