Operator IntFieldParamReference

Operator Library: Parameters

此運算子會從設計中任何位置的欄位參數，產生 1:1 的對應參數 (位於參數 Field 中)。您可以在參數 Reference 中指定參照的參數 (路徑與名稱)。

被引用欄位參數可以是以下其中一種類型：VA_SINTFIELD 或 VA_UINTFIELD。 map 參數完全反映被引用參數的所有屬性。

Since there are no field parameters specified in the GenICam standard, the created GenICam API and the created Framegtabber API code (FgLib) vary on this point. In the GenICam API code, the two parameters <DisplayName>_Index and <DisplayName>_Value are created.

您可以在設計階層內定義一個目標，讓參照的參數在該處可見且可存取。目標由兩個參數定義：DisplayHierarchy 與 DisplayName。在 DisplayHierarchy 中，您指定參照 operator 本身所在的同一個處理程序中的階層方塊。在參數 DisplayName 中，您設定目標參數的名稱。如果同時設定了 DisplayHierarchy 與 DisplayName，則由 DisplayName 定義的參數將可在 DisplayHierarchy 所指定的階層方塊中使用。如果 DisplayName 為空，則不會建立參數。如果設定了 DisplayName，但 DisplayHierarchy 為空，則由 DisplayName 定義的參數會新增至父階層（也就是參照 operator 本身所在的階層方塊）。

這可讓您在設計的任何階層層級上提供設計的欄位參數。例如，您可以讓受保護階層式方塊內部的模組欄位參數，直接在受保護階層式方塊本身的屬性下進行參數化。

已映射的參數本身即可被引用。 因此，您可以在引用運算子中引用參數 Field的內容， 或引用您在參數 DisplayName和DisplayHierarchy 中所定義的參數。 當 受保護的層級方塊是由其他受保護的層級方塊所建構時，這一點尤為重要。

[注意] 所有連接的參數會同時更新

如果其中一個連接的參數（參照參數、對應參數 Field 或目標參數）遭到變更，所有其他連接參數中的值也會隨之變更。

此 operator 沒有輸入和輸出，因為它不會干擾設計的資料流結構。

關於 Library Parameters 的一般介紹，請參閱 Library Parameters。

範例：

對應參數 FieldValues 現在可在 Process0/Level0/Level1 中使用：

I/O Properties

Property Value
Operator Type 無（因為沒有輸入或輸出）

Supported Link Format

無

Parameters

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

顯示錯誤狀態。如果參數 Activate 設定為 Yes，則會檢查其他模組參數。此參數會顯示檢查結果，即 OK 或錯誤訊息。

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

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

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

如果此欄位為空白，則不會建立新參數。

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

在此指定您要附加在參數 DisplayName 中定義的新 map 參數的階層式方塊。

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

如果您定義了新參數 DisplayName， 但將參數 DisplayHierarchy 留空：新參數將會 新增至包含參考 operator 實例的階層式方塊。 （請記住，如果參考 operator 實例 位於最高（製程）層級，則無法這樣做。）

[注意] 設定顯示目標路徑的語法

若要讓新參數顯示在設計的其他位置， 您需要在 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, 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

索引
Type dynamic write parameter
Default 0
Range UInt

在此設定欄位索引。

Value
Type dynamic、write、read 參數
Default 0
Range 帶號整數 (64 位元)、無帶號整數 (64 位元)

設定或讀取由參數 Index 定址的欄位項目。

欄位
Type static、dynamic、write、read 參數
Default 無
Range array

用於存取參照欄位參數的對應參數。此參數會鏡射參照欄位參數的所有屬性。

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

在此輸入參數 Value 的描述。

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

<ParamName> is the actual 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/LUT.LUTContent)。

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

Activate
Type dynamic write parameter
Default 否
Range {No, Yes}

Yes = 已啟用對參照參數的存取以及來自參照參數的存取 (透過對應參數 Value)。

No = 對參照參數的存取及來自參照參數的存取已停用，且 Status 參數已停用。 DisplayName 與 DisplayHierarchy 參數將無效。

Examples of Use

以下範例展示了運算子 IntFieldParamReference 的使用方式：

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