NNS_SndPlayerStopSeq*

構文

#include <nnsys/snd.h>
void NNS_SndPlayerStopSeq( NNSSndHandle* handle, int fadeFrame );
void NNS_SndPlayerStopSeqByPlayerNo( int playerNo, int fadeFrame );
void NNS_SndPlayerStopSeqBySeqNo( int seqNo, int fadeFrame );
void NNS_SndPlayerStopSeqBySeqArcNo( int seqArcNo, int fadeFrame );
void NNS_SndPlayerStopSeqBySeqArcIdx( int seqArcNo, int index, int fadeFrame );
void NNS_SndPlayerStopSeqAll( int fadeFrame );

引数

handle サウンドハンドルのポインタです。
playerNo プレイヤー番号です。
seqNo シーケンス番号です。
seqArcNo シーケンスアーカイブ番号です。
index シーケンスアーカイブ中のインデックス番号です。
fadeFrame フェードアウトフレームです。値の範囲は、0 〜 65535です。

返り値

なし。

説明

シーケンスを停止します。

NNS_SndPlayerStopSeq関数は、サウンドハンドルhandleを使って、シーケンスを止めます。サウンドハンドルに、結びつけられたシーケンスが止まります。サウンドハンドルが無効の場合は、何もしません。

NNS_SndPlayerStopSeqByPlayerNo関数は、プレイヤー番号playerNoを指定して、シーケンスを止めます。指定したプレイヤーで再生中のシーケンスが止まります。

NNS_SndPlayerStopSeqBySeqNo関数は、シーケンス番号seqNoを指定して、シーケンスを止めます。これは、NNS_SndPlayerSetSeqNo関数でセットしたシーケンス番号が、seqNoと同じである全てのシーケンスを止めます。

NNS_SndPlayerStopSeqBySeqArcNo関数は、シーケンスアーカイブ番号seqArcNoを指定して、シーケンスを止めます。 これは、NNS_SndPlayerSetSeqArcNo関数でセットしたシーケンスアーカイブ番号が、seqArcNoと同じである全てのシーケンスを止めます。 NNS_SndPlayerStopSeqBySeqArcIdx関数は、シーケンスアーカイブ番号seqArcNoと インデックス番号indexの両方が等しいシーケンスを止めます。

NNS_SndPlayerStopSeqAll関数は、全ての再生中のシーケンスを止めます。

fadeFrameで指定したゲームフレーム分の時間をかけて、徐々に音が小さくなった後、シーケンスは完全に停止します。0の場合は、即座に停止します。

これらの関数を呼びだすと、プレイヤープライオリティは最低の0になります。

参照

NNS_SndPlayerSetSeqNo, NNS_SndPlayerSetSeqArcNo

履歴

2004/08/10 NNS_SndPlayerStopSeqAll関数の引数が間違っていたのを修正。
2004/06/01 NNS_SndPlayerStopSeqBySeqNo, NNS_SndPlayerStopSeqBySeqArcNo, NNS_SndPlayerStopSeqBySeqArcIdx追加。 NNS_SndPlayerStopSeqByNumberをNNS_SndPlayerStopSeqByPlayerNoに変更。
2004/04/19 NNS_SndPlayerStopSeq, NNS_SndPlayerStopSeqByNumber, NNS_SndPlayerStopSeqAll のマニュアルを統合
2004/04/01 初版