運算子 FloatParamReference

Operator Library: Parameters

此運算子會根據設計中任何位置的模組參數， 產生一個 1:1 的映射參數（位於「參數值」欄位中）。您需在「參數參考」欄位中指定要引用的參數 （路徑與名稱）。

被引用參數的資料型別為 VA_DOUBLE。 映射參數完全複製了被引用參數的所有屬性，且同樣為 VA_DOUBLE 型別。

您可以在設計層級結構中定義一個目標，使所選的 參數在此處可見且可存取。 該目標由兩個參數定義：DisplayHierarchy與DisplayName。 在DisplayHierarchy中，您指定一個位於 與參考運算子本身相同流程內的層級方塊。 在DisplayName參數中，您可設定目標參數的名稱。 若DisplayHierarchy與DisplayName皆已設定，則由DisplayName定義的參數將 出現在由DisplayHierarchy 所指定的層級方塊中。 若DisplayName為空，則不會建立任何參數。 若已設定DisplayName，但DisplayHierarchy為空， 則由DisplayName定義的參數將被新增至父層級結構中（即 參考運算子本身所處的階層式方塊）。

這可讓您將設計的參數提供給您想要的任何階層層級（設計中）使用。例如，您可以讓受保護階層方塊內的模組參數直接在受保護階層方塊本身的屬性下進行參數化。

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

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

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

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

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

範例：

地圖參數「WB_Red」現已可在 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 任何字串

若您希望在設計中的其他位置 （除了參照運算子實例本身之外） 授予對被參照參數 （定義於「參數參照」中）的存取權限， 則需定義一個新參數。 請在此處指定此新參數的名稱。

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

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

Value
Type static、dynamic、write、read 參數
Default 0
Range double

用於存取所引用參數及從該參數存取的映射參數。 此參數反映所引用參數的所有屬性。

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

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

描述
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/WhiteBalance.RedCoefficient)。

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

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

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

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

Examples of Use

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

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