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

134 lines
4.1 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_SndPlayerSetTrackAllocatableChannel</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="IDAEMYT"></a><div class="titlepage">
<div></div>
<div></div>
</div>
<h1>NNS_SndPlayerSetTrackAllocatableChannel</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_SndPlayerSetTrackAllocatableChannel(
NNSSndHandle* <var>handle</var>,
u16 <var>trackBitMask</var>,
u32 <var>chBitFlag</var> );</code><br></pre></dd>
</dl>
<div class="refsection" lang="ja"><a name="IDABOYT"></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>trackBitMask</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="IDA4OYT"></a>
<h2>返り値</h2>
<p>なし。</p>
</div>
<div class="refsection" lang="ja"><a name="IDAFPYT"></a>
<h2>説明</h2>
<p>
シーケンストラックの確保可能なチャンネルを変更します。
</p>
<p>
サウンドハンドル<em><strong><code>handle</code></strong></em>に、結びつけられたシーケンスの確保可能なチャンネルを変更します。
サウンドハンドルが無効の場合は、何もしません。
</p>
<p>
<em><strong><code>trackBitMask</code></strong></em>で、設定するトラックを指定します。
下位ビットから順に、トラック0、トラック1、トラック2、、、を表し、ビットが立っているトラック全てに対して、
確保可能なチャンネルを変更します。
例えば、トラック2とトラック5の確保可能なチャンネルを変更したい場合は、 (1 &lt;&lt; 2) | (1 &lt;&lt; 5) すなわち、0x0024 とします。
</p>
<p>
<em><strong><code>chBitFlag</code></strong></em>で、確保できるチャンネルをビットフラグで設定します。
下位ビットから順に、チャンネル0、チャンネル1、チャンネル2、、、を表し、
ビットが立っているチャンネルからのみ確保することができます。
値が0の場合は、全くチャンネルを確保できなくなります。
</p>
<p>
なお、チャンネルは16個ありますが、
下記のように、チャンネル番号に応じてチャンネルの機能が異なっています。
</p>
<div class="table"><a name="IDA4PYT"></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_SndPlayerSetAllocatableChannel.html">NNS_SndPlayerSetAllocatableChannel</a></tt>関数で
設定した値は上書きされます。
</p>
</div>
</div>
<h2>参照</h2>
<p><a href="NNS_SndPlayerSetAllocatableChannel.html">NNS_SndPlayerSetAllocatableChannel</a></p>
<h2>履歴</h2>
<p>
2007/10/30 誤記修正<br>
2005/11/07 チャンネルビットフラグが0の時の説明誤り修正<br>
2005/01/05 初版<br></p>
</div>
</body>
</html>