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

# sdMidiSetPan

MIDIポートのパンポットの設定

### 書式

> `SDE_ERR sdMidiSetPan( handle, pan, fade_time )
> SDMIDI handle
> const Sint8 pan
> const Sint32 fade_time
> `

### 引数

> handle | MIDIポートのハンドル
> pan | パンポット値
> 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ポートに対して再生パンポット設定をします。

> パンポットを示す引数 panの値の範囲は-007FH(最左)〜0000H(標準)〜007FH(最右)です。

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

> 指定のパンポット値に達するまで時間を示す引数 fade_time の単位はミリ秒で、範囲は0000H(最速)〜7FFFH(最遅)です。

> この再生スピードに達するまでの時間中、VSync毎にsdSysServer()関数が実行されていなければなりません。

### 備考

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

sdMidiSetPan

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000