mirror of
https://github.com/rvtr/TwlIPL_commit-99.git
synced 2025-10-31 06:21:11 -04:00
123 lines
5.6 KiB
HTML
Executable File
123 lines
5.6 KiB
HTML
Executable File
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html>
|
||
<head>
|
||
<META http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
|
||
<title>NNS_SndArcPlayerStartSeqArc*</title>
|
||
<link rel="stylesheet" href="../css/nitro.css" type="text/css">
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.65.1">
|
||
</head>
|
||
<body>
|
||
<div class="refentry" lang="ja"><a name="IDAKKWT"></a><div class="titlepage">
|
||
<div></div>
|
||
<div></div>
|
||
</div>
|
||
<h1>NNS_SndArcPlayerStartSeqArc*</h1>
|
||
<h2>構文</h2>
|
||
<dl>
|
||
<dd><pre class="funcsynopsisinfo"><code>#include <nnsys/snd.h></code></pre></dd>
|
||
<dd><pre class="funcprototype"><code class="funcprototype">BOOL NNS_SndArcPlayerStartSeqArc(
|
||
NNSSndHandle* <var>handle</var>,
|
||
int <var>seqArcNo</var>,
|
||
int <var>index</var> );</code><br><code class="funcprototype">BOOL NNS_SndArcPlayerStartSeqArcEx(
|
||
NNSSndHandle* <var>handle</var>,
|
||
int <var>playerNo</var>,
|
||
int <var>bankNo</var>,
|
||
int <var>playerPrio</var>,
|
||
int <var>seqArcNo</var>,
|
||
int <var>index</var> );</code><br></pre></dd>
|
||
</dl>
|
||
<div class="refsection" lang="ja"><a name="IDAYNWT"></a>
|
||
<h2>引数</h2>
|
||
|
||
<div class="variablelist">
|
||
<table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><em><strong><code>handle</code></strong></em></td>
|
||
<td>サウンドハンドルのポインタです。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><em><strong><code>seqArcNo</code></strong></em></td>
|
||
<td>シーケンスアーカイブ番号です。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><em><strong><code>index</code></strong></em></td>
|
||
<td>シーケンスアーカイブのインデックス番号です。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><em><strong><code>playerNo</code></strong></em></td>
|
||
<td>プレイヤー番号です。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><em><strong><code>bankNo</code></strong></em></td>
|
||
<td>バンク番号です。</td>
|
||
</tr>
|
||
<tr>
|
||
<td><em><strong><code>playerPrio</code></strong></em></td>
|
||
<td>プレイヤープライオリティです。値の範囲は0～127で、大きいほど優先度が高くなります。</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</div>
|
||
<div class="refsection" lang="ja"><a name="IDAKPWT"></a>
|
||
<h2>返り値</h2>
|
||
|
||
<p>再生に成功した場合は、TRUEを返します。失敗すると、FALSEが返ります。 </p>
|
||
</div>
|
||
<div class="refsection" lang="ja"><a name="IDARPWT"></a>
|
||
<h2>説明</h2>
|
||
<p>
|
||
シーケンスアーカイブを再生します。
|
||
</p>
|
||
<p>
|
||
<tt class="function">NNS_SndArcPlayerStartSeqArc</tt>関数では、プレイヤー番号などのパラメータは、サウンドデータでの指定に基づいて設定されます。 <tt class="function">NNS_SndArcPlayerStartSeqArcEx</tt>関数を使うと、プレイヤー番号やバンク番号、プレイヤープライオリティをプログラム側で指定できます。ただし、 <em><strong><code>playerNo</code></strong></em>、<em><strong><code>bankNo</code></strong></em>、<em><strong><code>playerPrio</code></strong></em>の引数のうち、-1を指定したものは、サウンドデータで設定したパラメータが使用されます。
|
||
</p>
|
||
<p>
|
||
あらかじめ、
|
||
<tt class="function"><a href="NNS_SndArcInit.html">NNS_SndArcInit</a></tt>関数または、
|
||
<tt class="function"><a href="NNS_SndArcInitOnMemory.html">NNS_SndArcInitOnMemory</a></tt>関数で
|
||
サウンドアーカイブが初期化されている必要があります。
|
||
</p>
|
||
<p>
|
||
サウンドハンドル<em><strong><code>handle</code></strong></em>は、あらかじめ、<tt class="function"><a href="NNS_SndHandleInit.html">NNS_SndHandleInit</a></tt>関数で、１度だけ初期化しておかなければなりません。
|
||
この関数を呼びだすと、サウンドハンドルに既に結びつけられていたシーケンスは切り離されます（停止するわけではありません）。
|
||
再生に成功すると、サウンドハンドルにシーケンスが結びつけられます。
|
||
</p>
|
||
<p>
|
||
関数内では、必要なサウンドデータがメモリ上にあるかどうかを確認するために、
|
||
<tt class="function"><a href="NNS_SndArcGetFileAddress.html">NNS_SndArcGetFileAddress</a></tt>関数を呼びだします。
|
||
必要なデータがメモリ上にない場合、関数は失敗します。
|
||
</p>
|
||
<p>
|
||
後で<tt class="function"><a href="NNS_SndPlayerStopSeq.html">NNS_SndPlayerStopSeqBySeqArcNo</a></tt>関数を使って、
|
||
シーケンスアーカイブ番号を指定してシーケンスを停止できるように、
|
||
関数内で<tt class="function"><a href="NNS_SndPlayerSetSeqArcNo.html">NNS_SndPlayerSetSeqArcNo</a></tt>関数を呼びだしています。
|
||
</p>
|
||
<p>
|
||
サウンドデータで設定されている、発音プライオリティや音量の値を再設定したい場合は、シーケンス開始直後に、
|
||
<tt class="function"><a href="NNS_SndPlayerSetChannelPriority.html">NNS_SndPlayerSetChannelPriority</a></tt>関数や、
|
||
<tt class="function"><a href="NNS_SndPlayerSetInitialVolume.html">NNS_SndPlayerSetInitialVolume</a></tt>関数を呼びだします。
|
||
</p>
|
||
<p>
|
||
再生の失敗には、以下の原因が考えられます。
|
||
</p>
|
||
<div class="itemizedlist">
|
||
<ul type="disc">
|
||
<li>シーケンスアーカイブ番号が無効</li>
|
||
<li>インデックス番号が無効</li>
|
||
<li>既に再生中のシーケンスよりも優先度が低い</li>
|
||
<li>データがメモリ上に無い</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
<h2>参照</h2>
|
||
<p><a href="NNS_SndArcInit.html">NNS_SndArcInit</a>, <a href="NNS_SndArcInitOnMemory.html">NNS_SndArcInitOnMemory</a>, <a href="NNS_SndHandleInit.html">NNS_SndHandleInit</a>, <a href="NNS_SndArcGetFileAddress.html">NNS_SndArcGetFileAddress</a>, <a href="NNS_SndPlayerStopSeq.html">NNS_SndPlayerStopSeqBySeqArcNo</a>, <a href="NNS_SndPlayerSetSeqArcNo.html">NNS_SndPlayerSetSeqArcNo</a>, <a href="NNS_SndPlayerSetChannelPriority.html">NNS_SndPlayerSetChannelPriority</a>, <a href="NNS_SndPlayerSetInitialVolume.html">NNS_SndPlayerSetInitialVolume</a></p>
|
||
<h2>履歴</h2>
|
||
<p>2004/11/30 返り値の型が間違っていたのを修正<br>2004/06/01 NNS_SndArcPlayerStartSeqArcWithPlayerNoを拡張して、
|
||
NNS_SndArcPlayerStartSeqArcExに変更。
|
||
<br>2004/04/19 NNS_SndArcPlayerStartSeqArc, NNS_SndArcPlayerStartSeqArcWithPlayerNoのマニュアルを統合<br>2004/04/01 初版<br></p>
|
||
</div>
|
||
</body>
|
||
</html>
|