80 lines
4.6 KiB
HTML
80 lines
4.6 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
|
|
<!-- generated by to_html.pl from f_WaveSoundBuffer.xml -->
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
<title>getVisBuffer - 視覚化用データの取得</title>
|
|
<meta name="author" content="W.Dee" />
|
|
<meta http-equiv="Content-Style-Type" content="text/css" />
|
|
<meta http-equiv="Content-Script-Type" content="text/javascript" />
|
|
<link href="funcref.css" type="text/css" rel="stylesheet" title="クラスリファレンス用標準スタイル" />
|
|
<link href="mailto:[email protected]" rev="Made" />
|
|
<link href="index.html" target="_top" rel="Start" title="トップページ" />
|
|
<link href="f_WaveSoundBuffer.html" title="WaveSoundBufferクラス" rel="Parent" />
|
|
</head>
|
|
<body>
|
|
<h1><span class="fheader"><a name="top" id="top">WaveSoundBuffer.getVisBuffer</a></span></h1><div class="para"><div>
|
|
<dl>
|
|
<dt>機能/意味</dt>
|
|
<dd>
|
|
視覚化用データの取得</dd>
|
|
<dt>タイプ</dt>
|
|
<dd>
|
|
<a class="jump" href="f_WaveSoundBuffer.html">WaveSoundBufferクラス</a>のメソッド<br />
|
|
</dd>
|
|
<dt>構文</dt>
|
|
<dd>
|
|
<span class="funcdecl">getVisBuffer(<span class="arg">buffer</span>, <span class="arg">numsamples</span>, <span class="arg">channel</span>, <span class="arg">ahead</span><span class="defarg">=<span class="defargval">0</span></span>)</span><br />
|
|
</dd>
|
|
<dt>引数</dt>
|
|
<dd>
|
|
<table rules="all" frame="box" cellpadding="3" summary="getVisBuffer の引数">
|
|
<tr><td valign="top"><span class="argname">buffer</span></td>
|
|
<td> 出力データを書き込むバッファを指定します。<br />
|
|
バッファは 16bit 符号付き整数の配列で、numsamples 引数および channels 引数
|
|
で指定したサンプルが書き込まれるのに十分な個数 ( numsamples * channels 以上 )
|
|
である必要があります。<br />
|
|
channels に 1 以外を指定した場合は、各チャネルのサンプルはインターリーブされて
|
|
( ステレオならば 右 左 右 左 ・・・・の順に ) 格納されます。<br />
|
|
配列の先頭要素へのポインタを指定する必要がありますが、整数型にキャストして
|
|
渡してください。<br />
|
|
</td></tr>
|
|
<tr><td valign="top"><span class="argname">numsamples</span></td>
|
|
<td> 取得するサンプル数を指定します。<br />
|
|
</td></tr>
|
|
<tr><td valign="top"><span class="argname">channel</span></td>
|
|
<td> 取得するチャンネル数を指定します。<br />
|
|
1 を指定すると、モノラルの場合はそのまま、そうでない場合は 1チャンネルにダウンミックス
|
|
されたデータを得ることができます。<br />
|
|
1 以外の数値を指定する場合は、再生中のサウンドと同じチャンネル数を指定する必要がありま
|
|
す。このばあいは、そのままのデータを得ることができます。<br />
|
|
</td></tr>
|
|
<tr><td valign="top"><span class="argname">ahead</span></td>
|
|
<td> 先読みするサンプル数を指定します。<br />
|
|
現在の再生位置から、この引数で指定したサンプル数だけ先にあるサンプルから取得することができます。<br />
|
|
0 を指定するか、この引数を省略すると、現在の再生位置からの取得になります。<br />
|
|
</td></tr>
|
|
</table>
|
|
</dd>
|
|
<dt>戻り値</dt>
|
|
<dd>
|
|
<result>取得できたサンプル数が戻ります。</result></dd>
|
|
<dt>説明</dt>
|
|
<dd>
|
|
視覚化用に PCM データを取得します。<br />
|
|
現在の再生位置から PCM データを読み込み、buffer 引数で指定した配列に書き込みます。<br />
|
|
ただし、バッファの状態や再生形式によっては正常にデータを読み込めない可能性もあります。<br />
|
|
このメソッドは C や C++ 等で書かれたプラグインから利用されることを想定してますので、たとえば
|
|
buffer 引数に TJS の配列を指定する、などのようなことはできません。<br />
|
|
このメソッドを使用するには <a class="jump" href="f_WaveSoundBuffer_useVisBuffer.html">WaveSoundBuffer.useVisBuffer</a> プロパティを真に指定する
|
|
必要があります。<br />
|
|
</dd>
|
|
</dl>
|
|
</div></div>
|
|
<script type="text/javascript" charset="UTF-8" src="documentid.js" ></script>
|
|
<script type="text/javascript" charset="UTF-8" src="postcontent.js" ></script>
|
|
</body>
|
|
</html>
|