#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 初版