オペレーター IntParamSelector

Operator Library: Parameters

この演算子は、パラメータ「値」にマップパラメータを生成します。パラメータ「選択」を使用すると、設計内の任意の場所に配置された複数のモジュールパラメータ間でこのマップパラメータを切り替えることができます。参照するパラメータのパスと名前を指定するには、パラメータ「参照」にセミコロンで区切られたリストを追加します。

参照されるパラメータは、以下の3つのタイプのいずれかになります。

  • VA_SINT: 演算子CONSTのパラメータValueのような符号付き整数。

  • VA_UINT: 演算子SCALEのパラメーターScaleFactorのような符号なし整数。

  • VA_ENUM: 演算子SetSignalStatusのパラメータmodeのような列挙型。

マップパラメータ自体は常にInt64型です。マップパラメータは、現在選択されている参照パラメータのすべてのプロパティを反映します。

64ビット全体を使用する符号なしパラメータを参照する場合は、Int64型に従って値を再解釈する必要があります。

選択したパラメータが表示され、アクセス可能になるデザイン階層内のターゲットを定義できます。ターゲットは、 DisplayHierarchyとDisplayName という2 つのパラメータで定義されます。DisplayHierarchy では、参照演算子自体が配置されているプロセス内の階層ボックスを指定します。DisplayNameパラメータでは、ターゲットパラメータの名前を設定します。つまり、次のようになります。

  • DisplayHierarchyとDisplayNameの両方が設定されている場合、 DisplayNameで定義されたパラメーターは、 DisplayHierarchyで指定された階層ボックスで使用できます。
  • DisplayNameが空の場合、パラメーターは作成されません。
  • DisplayNameが設定されていてもDisplayHierarchyが空の場合、 DisplayNameで定義されたパラメーターが親階層（つまり、参照演算子自体が配置されている階層ボックス）に追加されます。

これにより、選択したパラメータを設計の任意の階層レベルで利用可能にすることができます。たとえば、保護された階層ボックス内のモジュールのパラメータを、その保護された階層ボックス自体のプロパティの直下でパラメータ化できるようにすることができます。

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

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

接続されているパラメータのいずれかが変更された場合（つまり、選択されたパラメータ、マップパラメータの値、または表示対象パラメータが変更された場合）、他のすべての接続されているパラメータの値も変更されます。

このオペレータは、設計のデータフロー構造に干渉しないため、入力も出力もありません。

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

I/O Property

Property 値
オペレータータイプ 入力または出力がないため、なし

サポートされているリンクフォーマット

None

パラメーター

Status
タイプ 静的読み取り（GUIには書き込みと表示されます）パラメータ
Default None
範囲 OK またはエラー メッセージが発生します

エラーステータスを表示します。パラメータ Activate が Yes に設定されている場合、他のモジュールパラメータがチェックされます。このパラメータには、このチェックの結果、つまり OK またはエラーメッセージが表示されます。

このパラメータは最終的なアプレットの一部ではありません。

DisplayName
タイプ static write parameter
Default None
範囲 任意の文字列

参照演算子インスタンス自体に加えて、設計内の別の箇所で、パラメーター参照で定義された参照パラメーターへのアクセスを許可する場合は、新しいパラメーターを定義する必要があります。ここに、この新しいパラメーターの名前を指定してください。このフィールドが空の場合、新しいパラメーターは作成されません。

DisplayHierarchy
タイプ static write parameter
Default None
範囲 任意の文字列

パラメータDisplayNameで定義した新しいマップパラメータを関連付ける階層ボックスをここで指定します。

このパラメーターでは、オートコンプリート機能と構文ハイライト機能を使用できます。オートコンプリートを使用するには、モジュールプロパティダイアログでこのパラメーターの「パラメーター値」フィールドをクリックし、キーボードのTabキーを押します。オートコンプリート機能の詳細については、「翻訳演算子と参照演算子のオートコンプリートと構文ハイライト」を参照してください。

新しいパラメーター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, the 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

Select
タイプ 静的、動的、書き込みパラメーター
Default 0
範囲 参照されるパラメータの数によって異なります

参照されるパラメーターを切り替えるためのセレクター。

値
タイプ static、dynamic、write、readパラメータ
Default 0
範囲 符号付き整数（64ビット）、符号なし整数（64ビット）

選択したパラメータとの間でアクセスするためのマップパラメータ。このパラメータは、現在選択されている参照パラメータと同じプロパティを持ちます。

単位
タイプ static write parameter
Default -
範囲 Latin-1

パラメータ値の単位をここに入力してください。

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

パラメータ「値」の説明をここに入力してください。

参考資料
タイプ static write parameter
Default None
範囲 セミコロンで区切られたリスト形式で参照されるパラメータを定義する文字列：モジュールへの相対パス、モジュール名、パラメータ名。

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

[注] 参照の構文

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

文字列リスト内の項目の構文は次のとおりです：

<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 (i.e. an operator instance or a hierarchical box) that contains the referenced parameter.

<ParamName> is the 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/SetParam.Valueを使用します。

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

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

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

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

使用例

IntParamSelector オペレータの使用方法は、以下の例に示されています。

  • 'Parameter Selection'

    例 - パラメータ変換オペレーター IntParamSelector および FloatParamSelector の使用方法のデモンストレーション。

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