Operator FloatParamReference

Operator Library: Parameters

このオペレーターは、デザイン内のどこにでもあるモジュールパラメータから、1対1のマップパラメータ（パラメータ Value 内）を生成します。参照されるパラメータ（パスと名前）は、パラメータ Reference で指定します。

参照されているパラメータのタイプは VA_DOUBLE です。 マップパラメータは、参照されているパラメータのすべての Property をミラーリングし、こちらもタイプが VA_DOUBLE になります。

選択したパラメータを表示およびアクセス可能にするターゲットを、デザイン階層内で定義できます。 ターゲットは、DisplayHierarchy と DisplayName の2つのパラメータによって定義されます。 DisplayHierarchy では、リファレンスオペレータ自体が配置されているプロセスと同じプロセス内の階層ボックスを指定します。 パラメータ DisplayName では、ターゲットパラメータの名前を設定します。 DisplayHierarchy と DisplayName の両方が設定されている場合、DisplayName で定義されたパラメータは、DisplayHierarchy で指定された階層ボックスで使用できるようになります。 DisplayName が空の場合、パラメータは作成されません。 DisplayName が設定されていて DisplayHierarchy が空である場合、 DisplayName で定義されたパラメータが親階層（つまり、リファレンスオペレータ自体が配置されている階層ボックス）に追加されます。

これにより、デザインのパラメータを任意の階層レベル（デザインの）で使用できるようになります。たとえば、保護された階層ボックス内のモジュールのパラメータを、保護された階層ボックス自体の Property の下で直接パラメータ化できるようにすることができます。

マップされたパラメータ自体を参照することもできます。 したがって、リファレンスオペレータ内のパラメータ Value のコンテンツを参照するか、 パラメータ DisplayName および DisplayHierarchy で定義したパラメータを参照することができます。 これは、保護された階層ボックスが他の保護された階層ボックスから構築されている場合に特に重要になります。

[注] 接続されているすべてのパラメーターが一度に更新されます

接続されたパラメータのいずれかが変更された場合（参照されるパラメータ、マップパラメータの Value、またはターゲットパラメータ）、他のすべての接続されたパラメータの値も同様に変更されます。

このオペレーターは、設計のデータフロー構造に干渉しないため、入力と出力を持っていません。

ライブラリ Parameters の一般的な紹介については、Library Parameters を参照してください。

例：

マップパラメータ "WB_Red" が Process0/Level0/Level1 で利用できるようになりました:

I/O Property

Property 値
オペレータータイプ なし（入力または出力がないため）

サポートされているリンクフォーマット

None

パラメーター

Status
タイプ 静的読み取り（GUIには書き込みと表示されます）パラメータ
Default なし
範囲 OKまたはエラーメッセージ

エラーステータスを表示します。パラメータ Activate が Yes に設定されている場合、 他のモジュールパラメータがチェックされます。 このパラメータには、このチェックの結果（OK またはエラーメッセージ）が表示されます。

このパラメータは最終的なアプレットの一部ではありません。

DisplayName
タイプ static write parameter
Default なし
範囲 任意の文字列

デザイン内の別の場所（リファレンスオペレーターインスタンス自体に加えて）で、参照されるパラメータ（パラメータ Reference で定義）へのアクセスおよびそこからのアクセスを許可する場合は、新しいパラメータを定義する必要があります。ここでこの新しいパラメータの名前を指定します。

このフィールドが空の場合、新しいPropertyは作成されません。

DisplayHierarchy
タイプ static write parameter
Default なし
範囲 任意の文字列

パラメータ DisplayName で定義した新しいマップパラメータを追加する階層ボックスをここで指定します。

このパラメータでは、オートコンプリート機能と構文ハイライトを使用できます。オートコンプリートを使用するには、 Module Properties ダイアログにあるこのパラメータの Parameter Values フィールドをクリックし、キーボードの TAB キーを押します。オートコンプリート機能の詳細な手順については、 'Autocompletion and Syntax Highlighting for Translator and Reference Operators' を参照してください。

新しいパラメータ DisplayName を定義したが、パラメータ DisplayHierarchy を空のままにした場合、新しいパラメータは参照オペレータインスタンスを含む階層ボックスに追加されます（参照オペレータインスタンスが最上位（プロセス）レベルにある場合は実行できませんのでご注意ください）。

[注] 表示先へのパスを設定するための構文

デザイン内の別の場所に新しいパラメータを表示させたい場合は、パラメータ DisplayHierarchy で新しいパラメータを含む階層ボックスへのパスを指定する必要があります。

構文は以下のとおりです：

<Path> is the relative path from process level to the hierarchical level of the design where the <Hierarchical Box> is located that is to receive the new parameter. Thus, parameter DisplayHierarchy can only address hierarchical boxes within the same process. Use a slash as separator between different hierarchical levels.

<HierarchicalBox> is the name of the hierarchical box that is to receive the new map parameter.

例： Level0/Level1

値
タイプ static、dynamic、write、readパラメータ
Default 0
範囲 double

参照されるパラメータとの間でのアクセスのためのマップパラメータ。このパラメータは、参照されるパラメータのすべての Property をミラーリングします。

単位
タイプ static write parameter
Default -
範囲 Latin-1

パラメータ Value の単位をここに入力します。

説明
タイプ static write parameter
Default -
範囲 任意のテキスト

パラメータ Value の説明をここに入力します。

Reference
タイプ static write parameter
Default なし
範囲 参照されるパラメーターを定義する任意の文字列：モジュールへの相対パス、モジュール名、およびパラメーター名

ここでは、デザイン内での参照されるパラメーターの位置を定義します。

このパラメータでは、オートコンプリート機能と構文ハイライトを使用できます。オートコンプリートを使用するには、 Module Properties ダイアログにあるこのパラメータの Parameter Values フィールドをクリックし、キーボードの TAB キーを押します。オートコンプリート機能の詳細な手順については、 'Autocompletion and Syntax Highlighting for Translator and Reference Operators' を参照してください。

[注] 参照の構文

構文は以下のとおりです：

<Path> is the relative path to the hierarchical level where the referenced module "Module" is located. Use a slash as separator between different hierarchical levels. Define the path as relative path from the hierarchical level the reference operator instance is located in.

<Module> is the name of the module (operator instance or hierarchical box) that contains the referenced parameter.

<ParamName> is the actual name of the referenced parameter.

If <Path> starts with a slash, the path is interpreted as absolute path starting from design level (e.g., /Process0/UUT/WhiteBalance.RedCoefficientを使用します。

次を使用することもできます： ../ 階層を1つ上に移動します。ただし、自由に複製または再配置可能なモジュールを設計する際には、このオプションを使用しないよう注意してください。

Activate
タイプ 動的書き込みパラメータ
Default いいえ
範囲 {No,Yes}

Yes = 参照パラメータとの間のアクセス（マップパラメータ Value を経由）が有効になります。

No = 参照されるパラメーターへのアクセスが無効化され、パラメーター Statusが無効になります。パラメーター DisplayNameおよびDisplayHierarchyは効果を持ちません。

使用例

オペレータ FloatParamReference の使用方法は、以下の例に示されています:

  前へ     レベルアップ     Next  
目次 上面 ホーム