HARK version 1.2.0 Document : SaveSourceLocation

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: ファイルのオープンに失敗した．原因は書き込み権限が無いなど．