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

Operator Library: Parameters

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

オペレーター EnumParamTranslator は、VA_ENUMタイプのマップパラメータを生成します。 マップパラメータの名前は Value です。

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

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

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

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

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

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