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

Operator Library: Parameters

このオペレーターは、接続されたリンクのPropertyへの読み取りまたは書き込みアクセスを提供します。書き込みアクセスにより、書き込みアクションを介した二次的なパラメータのアップデートがトリガーされる場合があります。

このオペレーターの利点は、ライブラリの他のオペレーターである Parameters を介してリンクPropertyを変更できることです。さらに、このオペレーターを使用して、リンクPropertyが変更されたときに他のモジュールパラメータを変更することもできます。そのために書き込みアクションを定義できます。また、このオペレーターを使用してリンクPropertyを固定し、複数のリンクProperty間の依存関係を強制することもできます。

出力ポート O のリンクフォーマットは、入力ポート I のフォーマットに厳密に従います。モジュールパラメータには、ポート I におけるリンクPropertyの現在のステータスが反映されます。モジュールパラメータを Read（デフォルト）から Write に変更できます。Read モードは、対応するリンクPropertyが読み取り専用であることを意味します。これにより、オペレーターは LinkProperties オペレーターと同様に機能します。パラメータが Write に設定されている場合、このパラメータを設定できます。その場合、パラメータ値が対応するリンクPropertyに伝播されます。これにより、出力ポート O の対応するリンクPropertyを編集できなくなるという追加の効果があり、リンクPropertyを選択的にフリーズするのに便利です。さらに、入力接続からの対応するリンクPropertyは、I および O のPropertyに伝播されなくなります。Write モードでは、接続された入力リンクの同じPropertyを編集できない場合でも、リンクPropertyパラメータを編集できます。その場合、接続されている前のモジュールのフォーマットが LinkParamTranslator インスタンスのフォーマットと一致しないことを示すエラーが入力リンクに表示されることがあります。

パラメータ WriteAction では、リンクPropertyが変更されたときに何が起こるかを定義します。パラメータ Activate は、WriteAction で定義された書き込みアクションを有効にします。

書き込みアクションは、1つまたは複数の数式で構成されます。複数の数式を定義する場合は、セミコロンで数式を区切ってください。これらの数式の左側では、どのモジュールのどのパラメータが計算結果を受け取るかを定義します。表記法を使用します this このモジュールのパラメータを参照する場合。受信したリンクのアップデート、またはこのモジュールのパラメータへの書き込みアクセスのいずれかによってリンクPropertyが変更されるとすぐに、パラメータ WriteAction で定義した数式の右側にある数式が実行され、その結果が数式の左側で指定されたパラメータに転送されます。左側と同様に、次のような表記法を使用してこのモジュールのパラメータを参照できます this.

例：

${this.MaxImgWidth} = (${this.MaxImgWidth} <= 1024) ? ${this.MaxImgWidth} : 1024;

数式は、デザイン内のどこにある静的モジュールパラメータの値も参照できます。数式には、パラメータの値だけでなく、最小値、最大値、ステップサイズ、列挙アイテムの数値など、パラメータの特定のPropertyを含めることもできます。

ライブラリの一般的な紹介については、 Parameters in Library Parameters.