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

145 lines
4.6 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_SndWaveOutStart</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_SndWaveOutStart</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">BOOL NNS_SndWaveOutStart(
NNSSndWaveOutHandle <var>handle</var>,
NNSSndWaveFormat <var>format</var>,
const void* <var>dataaddr</var>,
BOOL <var>loopFlag</var>,
int <var>loopStartSample</var>,
int <var>samples</var>,
int <var>sampleRate</var>,
int <var>volume</var>,
int <var>speed</var>,
int <var>pan</var> );</code><br></pre></dd>
</dl>
<div class="refsection" lang="ja"><a name="IDA0MWT"></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>format</code></strong></em></td>
<td>波形データフォーマットです。</td>
</tr>
<tr>
<td><em><strong><code>dataaddr</code></strong></em></td>
<td>波形データの先頭アドレスです。</td>
</tr>
<tr>
<td><em><strong><code>loopFlag</code></strong></em></td>
<td>ループフラグです。</td>
</tr>
<tr>
<td><em><strong><code>loopStartSample</code></strong></em></td>
<td>ループ開始サンプル位置です。</td>
</tr>
<tr>
<td><em><strong><code>samples</code></strong></em></td>
<td>波形データのサンプル数です。</td>
</tr>
<tr>
<td><em><strong><code>sampleRate</code></strong></em></td>
<td>波形データのサンプリングレートです。単位は Hz です。</td>
</tr>
<tr>
<td><em><strong><code>volume</code></strong></em></td>
<td>ボリューム値です。値の範囲は、0 127 です。</td>
</tr>
<tr>
<td><em><strong><code>speed</code></strong></em></td>
<td>再生スピードです。</td>
</tr>
<tr>
<td><em><strong><code>pan</code></strong></em></td>
<td>パン定位です。値の範囲は、0(左) 64(中央) 127(右) です。</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="refsection" lang="ja"><a name="IDAIPWT"></a>
<h2>返り値</h2>
<p>再生に成功したかどうかを返します。</p>
</div>
<div class="refsection" lang="ja"><a name="IDAPPWT"></a>
<h2>説明</h2>
<p>
波形データを再生します。</p>
<p>
波形再生ハンドル<em><strong><code>handle</code></strong></em>には、<tt class="function"><a href="NNS_SndWaveOutAllocChannel.html">NNS_SndWaveOutAllocChannel</a></tt>関数で、
取得したものを入れます。
</p>
<p>
波形データフォーマット<em><strong><code>format</code></strong></em>は、下記の値で指定します。
</p>
<div class="table"><a name="IDAHQWT"></a><p class="title"><b>表 . NNSSndWaveFormat</b></p>
<table summary="NNSSndWaveFormat" border="1">
<colgroup><col><col></colgroup>
<thead>
<tr>
<th>ラベル</th>
<th>説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>NNS_SND_WAVE_FORMAT_PCM8</td>
<td>8ビットPCM</td>
</tr>
<tr>
<td>NNS_SND_WAVE_FORMAT_PCM16</td>
<td>16ビットPCM</td>
</tr>
</tbody>
</table>
</div>
<p>
波形データ先頭アドレス<em><strong><code>dataaddr</code></strong></em>は、4バイトアライメントされている必要があります。
</p>
<p>
ループフラグ<em><strong><code>loopFlag</code></strong></em>は、ループ再生を行うかどうかのフラグです。
<span class="symbol">TRUE</span>を指定すると、最後のサンプルまで再生した後、
ループ開始サンプル<em><strong><code>loopStartSample</code></strong></em>の位置から再び再生を再開します。
なお、ループ開始サンプル<em><strong><code>loopStartSample</code></strong></em>は、ビットPCMの時はの倍数、16ビットPCMの時はの倍数でなければなりません。
</p>
<p>
サンプル数<em><strong><code>samples</code></strong></em>は、ビットPCMの時はの倍数、16ビットPCMの時はの倍数でなければなりません。
</p>
<p>
再生スピード<em><strong><code>speed</code></strong></em>は、再生する速さを指定します。
<em><strong><code>speed</code></strong></em>÷32768倍の速さで再生されます。
再生スピードを速くすると、再生時間が短くなり、再生される音の高さが高くなります。
</p>
</div>
<h2>参照</h2>
<p><a href="NNS_SndWaveOutAllocChannel.html">NNS_SndWaveOutAllocChannel</a></p>
<h2>履歴</h2>
<p>2004/07/01 初版<br></p>
</div>
</body>
</html>