Operator IntFieldParamReference

Operator Library: Parameters

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

参照されるフィールドパラメーターには、VA_SINTFIELDまたはVA_UINTFIELDのいずれかの型を指定できます。マップパラメーターは、参照されるパラメーターのすべてのPropertyをミラーリングします。

Since there are no field parameters specified in the GenICam standard, the created GenICam API and the created Framegtabber API code (FgLib) vary on this point. In the GenICam API code, the two parameters <DisplayName>_Index and <DisplayName>_Value are created.

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

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

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

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

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

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

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

例：

マップパラメーター FieldValues が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

索引
タイプ 動的書き込みパラメータ
Default 0
範囲 UInt

ここにフィールドインデックスを設定します。

値
タイプ 動的、書き込み、読み取りパラメータ
Default 0
範囲 符号付き整数（64ビット）、符号なし整数（64ビット）

パラメーター Indexで指定されたフィールドエントリの設定または読み取りを行います。

Field
タイプ 静的、動的、書き込み、読み取りパラメータ
Default なし
範囲 アレイ

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

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

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

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

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

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

[注] 参照の構文

The syntax is as follows:

<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/LUT.LUTContentを使用します。

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

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

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

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

使用例

オペレーター IntFieldParamReference の使用法を以下の例に示します。

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