6.2.17 SaveSourceLocation

6.2.17.1 ノードの概要

音源定位結果をファイルに保存するノード. 形式は 5.1 に定義されている.

6.2.17.2 必要なファイル

無し.

6.2.17.3 使用方法

どんなときに使うのか

定位結果の解析や視覚化などに利用するために, テキストファイルに保存したいときに使う. 保存したファイルの読み込みには, LoadSourceLocation ノードを用いる.

典型的な接続例

6.44に典型的な接続例を示す. 例で示すネットワークは,ConstantLocalization のノードパラメータに定めた 固定の定位結果をファイルに保存する. その他にも,本もジュールは音源定位結果を出力するノードなら何にでも接 続できる.例えば LocalizeMUSIC ,ConstantLocalization ,LoadSourceLocation など.

\includegraphics[width=.8\textwidth ]{fig/modules/SaveSourceLocation}
Figure 6.44: SaveSourceLocation の接続例

6.2.17.4 ノードの入出力とプロパティ

入力

SOURCES

: Vector<ObjectRef> 型.音源定位結果が入力される.ObjectRef 型が参照する のは Source 型.

出力

OUTPUT

: Vector<ObjectRef> 型.入力(Source 型)がそのまま出力される.

パラメータ

FILENAME

: string 型.デフォルト値はなし.

Table 6.34: SaveSourceLocation のパラメータ表

パラメータ名

デフォルト値

単位

説明

FILENAME

string 

   

保存したいファイルの名前

6.2.17.5 ノードの詳細

エラーメッセージとその原因は以下のとおり

FILENAME is empty

ノードパラメータ FILENAME にファイル名が指定されていない.

Can’t open file name

ファイルのオープンに失敗した.原因は書き込み権限が無いなど.