Operator IntParamSelector

Operator Library: Parameters

此運算子會在參數 Value 中產生一個對應參數 (map parameter)。您可以透過參數 Select 在設計中任何位置的多個模組參數之間切換此對應參數。若要指定參考參數的路徑與名稱，請在參數 References 中新增以分號分隔的清單。

參考參數可以是以下三種類型之一：

  • VA_SINT：有號整數，例如運算子 CONST 中的參數 Value。

  • VA_UINT：無號整數，例如運算子 SCALE 中的參數 ScaleFactor。

  • VA_ENUM：列舉，例如運算子 SetSignalStatus 中的參數 mode。

對應參數本身始終為 Int64 類型。對應參數會鏡射目前選定之參考參數的所有 Property。

如果您想要參考使用完整 64 位元的無號參數，則必須根據 Int64 類型對數值進行重新解讀。

您可以在設計階層中定義一個目標，選定的參數在此目標中將會顯示且可存取。該目標由兩個參數定義：DisplayHierarchy 與 DisplayName。在 DisplayHierarchy 中，您可以定址參考運算子本身所在的同一個處理程序中的階層方塊。在參數 DisplayName 中，您可設定目標參數的名稱。這意味著：

  • 如果同時設定了 DisplayHierarchy 與 DisplayName，則由 DisplayName 定義的參數可在 DisplayHierarchy 所定址的階層方塊中使用。
  • 如果 DisplayName 為空白，則不會建立任何參數。
  • 如果設定了 DisplayName，但 DisplayHierarchy 為空白，則由 DisplayName 定義的參數會新增至父階層（也就是參考運算子本身所在的階層方塊）。

這可讓您在設計的任何所需階層層級提供選定的參數。例如，您可以直接在受保護階層方塊本身的 Property 下方，提供受保護階層方塊內模組的參數以進行參數化。

對應參數本身也可以被參考。因此，您可以參考參考運算子中參數 Value 的內容，或是參考您在參數 DisplayName 與 DisplayHierarchy 中定義的參數。當受保護階層方塊是由其他受保護階層方塊建構而成時，這點尤其重要。

[備註] 所有連接的參數會同時更新

如果其中一個連接的參數遭到變更（亦即選定的參數、對應參數 Value 或顯示目標參數），則所有其他連接參數中的數值也會隨之變更。

由於此運算子不會干擾設計的資料流結構，因此它沒有輸入與輸出。

您可以找到關於此 Library 的一般介紹 Parameters in Library Parameters.

I/O Properties

Property Value
Operator Type 無，因為沒有任何輸入或輸出

支援的 Link 格式

無

參數

Status
Type 靜態讀取（儘管 GUI 顯示為寫入）參數
Default 無
Range 會傳回 OK 或發生錯誤訊息

顯示錯誤狀態。如果參數 Activate 設定為 Yes，就會檢查其他模組參數。此參數會顯示此檢查的結果，也就是 OK 或出現錯誤訊息。

此參數不屬於最終 applet 的一部分。

DisplayName
Type 靜態寫入參數
Default 無
Range 任何字串

如果您除了參考運算子執行個體本身之外，還想在設計的其他位置授予對參數 Reference 中定義之參考參數的存取權（雙向），則需要定義一個新參數。請在此處指定這個新參數的名稱。如果此欄位為空白，則不會建立新參數。

DisplayHierarchy
Type 靜態寫入參數
Default 無
Range 任何字串

請在此處指定您要附加在參數 DisplayName 中定義的新對應參數的階層方塊。

針對此參數，您可以使用自動完成功能與語法突顯。若要使用自動完成，請按一下此參數在 Module Properties 對話方塊中的 Parameter Values 欄位，然後按下鍵盤上的 TAB 鍵。關於自動完成功能的更詳細說明，請參閱 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

如果您定義了新的參數 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
Type 靜態、動態、寫入參數
Default 0
Range 視參考參數的數量而定

用於在參照參數之間切換的選取器。

Value
Type 靜態、動態、寫入、讀取引數
Default 0
Range 有號整數（64 位元）、無號整數（64 位元）

用於對選定參數進行雙向存取的對應參數。此參數具有與目前選定之參考參數相同的 Property。

單位
Type 靜態寫入參數
Default -
Range Latin-1

請在此處輸入參數 Value 的單位。

描述
Type 靜態寫入參數
Default -
Range 任何文字

請在此處輸入參數 Value 的說明。

參考資料
Type 靜態寫入參數
Default 無
Range 以分號分隔清單來定義參考參數的字串：模組的相對路徑、模組名稱與參數名稱。

在這裡，您可以定義所參照參數在設計中的位置。

[備註] 參照語法

針對此參數，您可以使用自動完成與語法突顯功能。若要使用自動完成，請點擊此參數在 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)。

您也可以使用 ../ 以返回上一層。不過，在設計可自由複製或重新定位的模組時，請小心不要使用此選項。

Activate
Type 動態寫入參數
Default 否
Range {No, Yes}

Yes = 啟用對所參照參數的存取（透過對應參數 Value）。

No = 停用對所參照參數的存取，且參數 Status 會被停用。參數 DisplayName 與 DisplayHierarchy 將沒有作用。

使用範例

以下範例顯示了 operator IntParamSelector 的使用方式：

  • 'Parameter Selection'

    範例 - 展示如何使用參數轉譯運算子 IntParamSelector 與 FloatParamSelector。

  上一頁     上一層     下一頁  
內容 頂端 首頁