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