VisualApplets
オペレーターリファレンス

Library Parameters は、設計時および実行時の両方におけるデザインのパラメータ設定において、いくつかの大きな利点を提供します。

Parameters ライブラリの優れた点は、デザインのデータフロー構造を実際に変更することなく、デザイン内のパラメータ値の間で接続（ネットまたはチェーン）を設定できることです。

Library Parameters には、7つのリファレンスオペレーターと4つのトランスレーションオペレーターが含まれています。両方のタイプのオペレーターの詳細については、以下を参照してください。

You find example designs using the operators of the Parameters Library in your VisualApplets installation: <installation_directory>\VisualApplets\Examples\AdvancedVAFunctions\Parameters Library.

************************************************************

リファレンスオペレーター

Parameters ライブラリの Reference オペレーターを使用すると、オペレーターパラメータをリファレンスオペレーターのマップパラメータ Value（または Field）に 1:1 でマッピングできます。参照されるパラメータ（パスと名前）は、パラメータ「Reference」で指定します。

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

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

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

マップパラメータを設定するには、次の2〜3つの手順を実行します。

すべてのマップパラメータは、環境によって通常のパラメータとして扱われます。「元の」オペレーターパラメータにアクセスするのと同様に、Framegrabber API または Framegrabber SDK ツール（microDiagnostics および microDisplay）を介してアクセスできます。

リファレンスオペレーターの各インスタンスを使用すると、デザイン内の任意のパラメータの値と、リファレンスオペレーターインスタンスのマップパラメータ（パラメータ Value）との間に 1:1 の関係を設定できます。

リファレンスオペレーターでサポートされているデータ型：

マップパラメータを作成するには、まず1つのリファレンスオペレーターをインスタンス化する必要があります。使用可能なデータ型ごとに、1つのリファレンスオペレーターを利用できます。

リファレンスオペレーターを使用してマップ値を作成する手順：

以下の例では、Reference Operator Example という名前のオペレーター IntParamReference のインスタンスが、モジュール Buffer のパラメータ YLength に接続されています。この例では、両方のモジュール（Reference Operator Example と Buffer）が同じ階層レベルに配置されています。

参照されたパラメータへのパス：

参照されたパラメータ：

この例では、オペレーター Buffer のパラメータ YLength の値が、リファレンスオペレーターインスタンスのパラメータ Value でも使用できるようになりました。

リファレンスオペレーターのパラメータ Value を使用して、さまざまな処理を行うことができます。

たとえば、パラメータ Value にある値を、デザイン内の任意の場所にある別のモジュール（オペレーターインスタンスまたは階層ボックス）で使用できるようにすることができます。これを行うには：

この例では、リファレンスオペレーターインスタンスのパラメータ Value が、モジュール ModuleWithConnectedParameter の新しいパラメータ ConnectionToYLengthInModuleBuffer に接続されています：

パラメータ Activate が「Yes」に設定されている場合、Apply ボタンをクリックすると、接続されたモジュールに正しい値を持つ新しいパラメータが表示されます：

これにより、モジュール ModuleWithConnectedParameter の新しいパラメータ ConnectionToYLengthInModuleBuffer は、モジュール Buffer のパラメータ YLength と同じ値を持ちます。

マッピングはリファレンスオペレーターインスタンスによって実行されます。

3つのモジュールのいずれかの接続されたパラメータがリセットされた場合、他のすべてのモジュールの値も同様にリセットされます。

階層ボックス：

ParametersライブラリのReferenceオペレーターを使用すると、デザイン内の任意の階層レベルでデザインのパラメータを利用できるようにすることができます。これは、保護された階層ボックスの内部深くにネストされたパラメータを、実行時にパラメータ化できるようにする場合（つまり、動的な書き込みパラメータとして利用できるようにする場合）に特に役立ちます。階層ボックスのパラメータ化を簡単に行うために、階層ボックス自体がパラメータを持つことができるようになりました（階層ボックス自体のProperties内のパラメータとして）。

Referenceオペレーターを使用すると、階層ボックスの表面（階層ボックスのProperties）から、深く埋め込まれている可能性のある特定のパラメータへのパスを設定できます。これにより、保護された階層ボックス（または他の保護された階層ボックス内にネストされた保護された階層ボックス）内のパラメータであっても、そのパラメータ化インターフェイスがアクセス制限のない階層レベルに引き上げられるため、実行時に設定およびリセットすることができます。

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

この例では、モジュールReferenceOperatorExampleのパラメータValueだけでなく、モジュールModuleWithConnectedParameterのパラメータConnectionToYLengthInModuleBufferも参照できることを意味します。

リファレンスオペレーターインスタンスReferenceOperatorExampleのパラメータValueへの参照：

モジュールModuleWithConnectedParameterのパラメータConnectionToYLengthInModuleBufferへの参照：

利用可能な6つのリファレンスオペレーターにより、保護された階層ボックスでパラメータ値として発生し得るすべてのデータ型が提供されます。

************************************************************

トランスレーションオペレーター

Parametersライブラリのトランスレーションオペレーターを使用すると、1つまたは複数の他のオペレーターのパラメータに変換アクセスできます。

計算のために数式を定義します。これらの数式の構文はGenICam APIバージョン2.0に準拠しており、以下で説明します。

読み取りアクション：

パラメータReadActionでは、トランスレーションオペレーターのパラメータValueへの読み取りアクセス時に何が起こるかを定義します。

リファレンスオペレーターとの主な違いの1つは、トランスレーションオペレーターが単に値を保持するわけではない点です。代わりに、パラメータValueの値は数式から計算されます。この数式はパラメータReadActionで定義します。

パラメータValueへの読み取りアクセスが発生するとすぐに、ReadActionで定義した数式が実行され、その結果が値を要求している要素に転送されます。

数式には、デザイン内のどこにあるオペレーターパラメータの値も含めることができます。これらの値のいずれかが変更されるとすぐに、トランスレーションオペレーターのパラメータValueの計算は新しい結果になります（以前にパラメータValueが保持していた値とは異なります）。

数式には、パラメータの値だけでなく、最小値、最大値、ステップサイズ、列挙項目の数値などのパラメータの特定のプロパティも組み込むことができます。

Write Action

パラメータWriteActionでは、トランスレーションオペレーターのパラメータValueへの書き込みアクセス時に何が起こるかを定義します。

リファレンスオペレーターとは対照的に、パラメータValueの値をデザイン内の別のパラメータに単純に転送するわけではありません。代わりに、パラメータValueの値は、トランスレーションオペレーターのパラメータWriteActionで定義する一連の書き込みアクションに使用されます。書き込みアクションは、1つまたは複数の式で構成されます。これらの式の左側で、どのオペレーターのどのパラメータが計算結果を受け取るかを定義します。複数の式を定義する場合は、セミコロンで式を区切ってください。

パラメータValueへの書き込みアクセスが発生するとすぐに、パラメータWriteActionで定義した式の右側にある数式が実行され、その結果が式の左側で指定されたパラメータに転送されます。

数式は、デザイン内のどこにあるオペレーターパラメータの値も参照できます。これらの値のいずれかが変更されると、前回と同じ値をValueパラメータに再書き込みしたときに、計算結果が異なります。

数式には、パラメータの値だけでなく、最小値、最大値、ステップサイズ、列挙項目の数値などのパラメータの特定のプロパティも組み込むことができます。

データ型：

選択した演算子によって、そのパラメータ Value のデータ型が次のように定義されます。

演算子 IntParamTranslator -> 整数値

演算子 FloatParamTranslator -> 浮動小数点値

演算子 EnumParamTranslator -> 列挙型の値

ただし、演算子によってパラメータ Value の型が定義されても、読み取りまたは書き込み操作時にアクセスされるパラメータのデータ型が制限されるわけではありません。たとえば、演算子 IntParamTranslator はそのパラメータ Value が整数型であることを定義していますが、演算子内で定義された数式には、倍精度浮動小数点型などのパラメータへのアクセスを含めることができます。

値の範囲の計算のための数式

パラメータ Value の現在の値の範囲を計算する数式を追加することもできます。該当する数式は、パラメータ RangeFrom、RangeTo、および RangeIncrement（ステップサイズ）で定義します。

数式には、デザイン内の任意の場所にあるモジュールパラメータの値のほか、最小値、最大値、ステップサイズ、列挙アイテムの数値など、これらのパラメータの特定の Property を含めることができます。

グローバル定数の参照

モジュールパラメータとその Property にアクセスすることに加えて、変換式ではグローバル定数を参照できます。グローバル定数は、パラメータ変換式で使用できるシステム全体の値を提供します。

変換式では、次を使用してグローバル定数を指定できます。 :: プレフィックス。一般的な構文は次のとおりです。 ${::ConstantName}、例えば ${::DesignClock} または ${::ConstantName}

変換式で使用できるように、デフォルトで次の標準グローバル定数が用意されています。

いつ 値 は静的であるため、次を設定することでユーザー定義のグローバル定数を作成できます。 DisplayHierarchy モジュールパラメータ :: で IntVariable, FloatVariable, IntParamTranslator、または FloatParamTranslator オペレータ。これにより、変換式で使用するグローバル定数が作成されます。次を使用してアクセスできます。 ${::myGlobalConst}.

オペレータリスト

次のリストは、Library Parameters のすべてのオペレータをまとめたものです。