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

sdPstmSetPan

PCM Streamポートのパンポットの設定

書式

SDE_ERR sdPstmSetPan( handle, target_slot, pan, fade_time )
SDPSTM handle
const Sint8 target_slot
const Sint8 pan
const Sint32 fade_time

引数

handle   PCM Streamポートのハンドル
target_slot   スロット番号
pan   パンポット値
fade_time   目的のパンポット値に達するまでの時間

戻り値

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

解説

指定したPCM Streamポートのスロット毎のパンポット設定をします。 引数target_slotは設定するスロット番号を指定します。 この引数にSDD_PSTM_PORT_SLOT_ALLを指定した場合は、指定したポートの全てのスロットに対して設定を行います。

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

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


備考

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

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