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

Operator Library: Parameters

Operator FloatParamTranslator により、1 つまたは複数の他のオペレータのパラメータに対する翻訳されたアクセス（読み取りおよび書き込み）が可能になります。 計算には、数式を定義します。これらの数式の構文は、GenICam API バージョン 2.0 に準拠しています。

さらに、このオペレータを使用して、パラメータの翻訳で使用するためのユーザー定義のグローバル定数を作成できます。 Value が静的な場合、DisplayHierarchy パラメータを :: に設定することでグローバル定数を作成できます。 結果として得られる定数はシステム全体で使用可能になり、すべてのパラメータ翻訳数式からアクセスできます。 翻訳数式でのグローバル定数の使用方法の詳細については、DisplayHierarchy パラメータの説明を参照してください。

Operator FloatParamTranslator は、VA_DOUBLE 型のマップパラメータを生成します。 マップパラメータの名前は Value です。

このオペレータはパラメータ Value の型を VA_DOUBLE 型として定義していますが、書き込みまたは読み取り操作中にアクセスされるパラメータのデータ型を制限するものではありません。

Read Action

パラメータ ReadAction では、翻訳オペレータのパラメータ Value への読み取りアクセス時に何が起こるかを定義します。 パラメータ Value は単に値を保持しているわけではありません。 代わりに、パラメータ Value の値は数式から計算されます。 この数式はパラメータ ReadAction で定義します。 パラメータ Value への読み取りアクセスが発生するとすぐに、ReadAction で定義した数式が実行され、その結果が値を要求している要素に転送されます。

数式には、デザイン内のどこにあるオペレータパラメータの値も含めることができます。 これらの値のいずれかが変更されるとすぐに、翻訳オペレータのパラメータ Value の計算は新しい結果になります （値パラメータ Value が以前に保持していた値とは異なります）。 数式には、パラメータの値だけでなく、最小値、最大値、ステップサイズ、列挙項目の数値などのパラメータの特定の Property も含めることができます。

Write Action

パラメータ WriteAction では、翻訳オペレータのパラメータ Value への書き込みアクセス時に何が起こるかを定義します。 参照オペレータを使用する場合とは異なり、パラメータ Value の値をデザイン内の別のパラメータに単に転送するわけではありません。代わりに、パラメータ Value の値は、翻訳オペレータのパラメータ WriteAction で定義した一連の書き込みアクションに使用されます。 書き込みアクションは、1 つまたは複数の等式で構成されます。 これらの等式の左辺では、どのオペレータのどのパラメータが計算結果を受け取るかを定義します。 複数の等式を定義する場合は、セミコロンで等式を区切ります。 パラメータ Value への書き込みアクセスが発生するとすぐに、パラメータ WriteAction で定義した等式の右辺にある数式が実行され、その結果が等式の左辺で指定されたパラメータに転送されます。

数式は、デザイン内のどこにあるオペレータパラメータの値も参照できます。 これらの値のいずれかが変更されるとすぐに、以前と同じ値を Value パラメータに再書き込みしたときの計算結果が異なります。 数式には、パラメータの値だけでなく、最小値、最大値、ステップサイズ、列挙項目の数値などのパラメータの特定の Property も含めることができます。

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

パラメータ Value の現在の値の範囲を計算するための数式を追加することもできます。 対応する数式は、パラメータ RangeFrom、RangeTo、および RangeIncrement（ステップサイズ）で定義します。 数式には、デザイン内のどこにあるモジュールパラメータの値や、最小値、最大値、ステップサイズ、列挙項目の数値などのこれらのパラメータの特定の Property を含めることができます。

マップパラメータの参照

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

これにより、マップパラメータ Value を（デザインの）任意の階層レベルでアクセス可能にすることができます。 これは、保護された階層ボックスを扱う場合に特に役立ちます。 保護された階層ボックス自体のPropertyの直下にパラメータを利用できるようにすることができます。

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

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

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