6.2.15 SaveSourceLocation

6.2.15.1 ノードの概要

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

6.2.15.2 必要なファイル

無し.

6.2.15.3 使用方法

どんなときに使うのか

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

典型的な接続例

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

\includegraphics{fig/modules/SaveSourceLocation-2} \includegraphics{fig/modules/SaveSourceLocation}
Figure 6.31: SaveSourceLocation の接続例: 左が MAIN  サブネッ トワーク, 右が Iterator  サブネットワーク

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

入力

SOURCES

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

出力

OUTPUT

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

パラメータ

FILENAME

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

Table 6.28: SaveSourceLocation のパラメータ表

パラメータ名

デフォルト値

単位

説明

FILENAME

string 

   

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

6.2.15.5 ノードの詳細

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

FILENAME is empty

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

Can’t open file name

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