TwlIPL_commit-99/add-ins/TwlSystem/man/ja_JP/snd/NNS_SndPlayerSetAllocatableChannel.html

120 lines
3.7 KiB
HTML
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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_SndPlayerSetAllocatableChannel</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="IDAEMWT"></a><div class="titlepage">
<div></div>
<div></div>
</div>
<h1>NNS_SndPlayerSetAllocatableChannel</h1>
<h2>構文</h2>
<dl>
<dd><pre class="funcsynopsisinfo"><code>#include &lt;nnsys/snd.h&gt;</code></pre></dd>
<dd><pre class="funcprototype"><code class="funcprototype">void NNS_SndPlayerSetAllocatableChannel(
int <var>playerNo</var>,
u32 <var>chBitFlag</var> );</code><br></pre></dd>
</dl>
<div class="refsection" lang="ja"><a name="IDAUNWT"></a>
<h2>引数</h2>
<div class="variablelist">
<table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><em><strong><code>playerNo</code></strong></em></td>
<td>プレイヤー番号です。</td>
</tr>
<tr>
<td><em><strong><code>chBitFlag</code></strong></em></td>
<td>確保可能なチャンネルのビットフラグです。</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="refsection" lang="ja"><a name="IDAKOWT"></a>
<h2>返り値</h2>
<p>なし。</p>
</div>
<div class="refsection" lang="ja"><a name="IDAROWT"></a>
<h2>説明</h2>
<p>
指定プレイヤーで再生するシーケンスが、確保できるチャンネルを設定します。
デフォルトは0で、無制限に確保できることを意味します。
</p>
<p>
<em><strong><code>chBitFlag</code></strong></em>で、確保できるチャンネルをビットフラグで設定します。
下位ビットから順に、チャンネル0、チャンネル1、チャンネル2、、、を表し、
ビットが立っているチャンネルからのみ確保することができます。
値が0の場合は無制限となり、全てのチャンネルから確保することができます。
</p>
<p>
なお、チャンネルは16個ありますが、
下記のように、チャンネル番号に応じてチャンネルの機能が異なっています。
</p>
<div class="table"><a name="IDAAPWT"></a><p class="title"><b>表 . チャンネルの番号別機能</b></p>
<table summary="チャンネルの番号別機能" border="1">
<colgroup><col><col></colgroup>
<thead>
<tr>
<th>チャンネル番号</th>
<th>機能</th>
</tr>
</thead>
<tbody>
<tr>
<td>0, 2</td>
<td>PCM/ADPCMを再生できます。このチャンネルの出力をサウンドキャプチャの入力とすることもできます。</td>
</tr>
<tr>
<td>1, 3</td>
<td>PCM/ADPCMを再生できます。サウンドキャプチャとタイマーを共用しているため、サウンドキャプチャを使うときは、サウンドキャプチャの出力チャンネルとしてしか使えません。</td>
</tr>
<tr>
<td>4 7</td>
<td>PCM/ADPCMを再生できます。シーケンス再生で波形データを再生するときには優先的に使っています。</td>
</tr>
<tr>
<td>8 13</td>
<td>PCM/ADPCMまたは、PSG矩形波を再生できます。</td>
</tr>
<tr>
<td>14, 15</td>
<td>PCM/ADPCMまたは、ホワイトイズを再生できます。</td>
</tr>
</tbody>
</table>
</div>
<div class="note">
<h3 class="title">注意</h3>
<p>
この関数は、<tt class="function"><a href="NNS_SndArcPlayerSetup.html">NNS_SndArcPlayerSetup</a></tt>関数内で、
呼びだされています。再度、この関数を呼びだすと、設定した値が上書きされます。
</p>
<p>
再生したシーケンスに対して、
<tt class="function"><a href="NNS_SndPlayerSetTrackAllocatableChannel.html">NNS_SndPlayerSetTrackAllocatableChannel</a></tt>関数を
呼びだすと、ここで設定した値は上書きされます。
</p>
</div>
</div>
<h2>参照</h2>
<p><a href="NNS_SndArcPlayerSetup.html">NNS_SndArcPlayerSetup</a>, <a href="NNS_SndPlayerSetTrackAllocatableChannel.html">NNS_SndPlayerSetTrackAllocatableChannel</a></p>
<h2>履歴</h2>
<p>2005/01/05 初版<br></p>
</div>
</body>
</html>