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

78 lines
2.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_SndPlayerSetTrackVolume</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_SndPlayerSetTrackVolume</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_SndPlayerSetTrackVolume(
NNSSndHandle* <var>handle</var>,
u16 <var>trackBitMask</var>,
int <var>volume</var> );</code><br></pre></dd>
</dl>
<div class="refsection" lang="ja"><a name="IDAHMWT"></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>volume</code></strong></em></td>
<td>ボリュームの値です。値の範囲は、0127です。</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="refsection" lang="ja"><a name="IDAENWT"></a>
<h2>返り値</h2>
<p>なし。</p>
</div>
<div class="refsection" lang="ja"><a name="IDALNWT"></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>volume</code></strong></em>のデフォルト値は、最大の127です。
この値の影響は、シーケンスのトラック全体にかかります。
また、他のいかなるトラックボリュームパラメータとも独立して効果を発揮し、それらは、累積して影響します。
</p>
</div>
<h2>参照</h2>
<p>なし。</p>
<h2>履歴</h2>
<p>2004/06/01 サウンドハンドルはシーケンスと結びつくように記述修正<br>2004/04/01 初版<br></p>
</div>
</body>
</html>