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 など．

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

入力

SOURCES

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

出力

OUTPUT

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

パラメータ

FILENAME

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

6.2.17.5 ノードの詳細

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

FILENAME is empty

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

Can’t open file name

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