VisualApplets
Operator Reference

函式庫 Parameters為 設計階段及執行階段的設計參數化提供了幾項主要優勢：

參數函式庫的好處在於，您可以建立 設計中參數值之間的連結（網路或鏈），而無需實際觸及 設計的資料流結構。

「函式庫參數」包含七個參考 運算子與四個轉換運算子。請參閱下方，進一步了解這兩類 運算子的相關資訊。

You find example designs using the operators of the Parameters Library in your VisualApplets installation: <installation_directory>\VisualApplets\Examples\AdvancedVAFunctions\Parameters Library.

************************************************************

參考運算子

「參數」函式庫中的 「參照」運算子，可將運算子 參數與參照運算子的地圖參數「值」（或 「欄位」）建立一對一的對應關係。您可於「參照」參數中指定 被參照的參數（路徑與名稱）。

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

這讓您能夠將設計中的 參數，設定為在您所希望的任何層級（該設計的）上皆可使用。例如，您 可以將受保護層級方塊內模組的參數，設定為 可直接在受保護層級方塊本身的屬性下方進行參數化。

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

要設定地圖參數，您只需按照以下 2 至 3 個步驟操作：

所有地圖參數在環境中均被視為一般參數。您可以 透過Framegrabber API 或Framegrabber SDK 工具（microDiagnostics 及 microDisplay）以與存取「原始」操作員參數相同的方式來存取這些參數。

每個參考運算子的實例，皆可建立設計中 任何參數的值與參考運算子實例的映射參數（參數 值）之間的一對一對應關係。

參考運算子所支援的資料類型：

要建立地圖參數，您首先需要建立一個參考運算子的實例。 針對每種可能的資料類型，您都有一種可用的參考運算子：

使用參考運算子建立地圖值的程序：

在以下範例中，一個名為 「參考運算子範例」的 IntParamReference運算子實例，連接至 模組 Buffer 中的參數YLength。 在此範例中，兩個模組 （「參考運算子範例」與 「Buffer」）皆位於同一層級。

被引用參數的路徑：

參照參數：

在我們的範例中，運算子Buffer中的參數YLength 的值，現在也已可在參考運算子實例的參數 Value中取得：

透過您所引用的 運算子中的參數Value，您可以執行許多操作。

例如，您可以將參數 Value中所含的值，在設計中的任何位置提供給另一個模組（運算子 實例或階層式方塊）使用。操作方法如下：

在我們的範例中， 參考運算子實例的參數Value已連接至模組 ModuleWithConnectedParameter中的新參數 ConnectionToYLengthInModuleBuffer：

若將「Activate」參數設定為「Yes」，則在 點擊 「套用」 按鈕後，新參數將在 已連接的模組中顯示 並帶有正確的值：

因此，模組 ModuleWithConnectedParameter的新參數 ConnectionToYLengthInModuleBuffer的值 與模組 Buffer 的參數YLength的值相同。

此映射作業由參考運算子實例執行。

若這三個模組中的任何一個，其關聯參數被重設，該值 也會在所有其他模組中被重設：

層級式方框：

「參數」函式庫中的 參考運算子，可讓您將設計中的某個參數 在您所希望的任何層級（設計的）上提供使用。這在 您希望於執行時對深層嵌套於 受保護的層級方塊內的參數進行參數化時特別有用（也就是說，如果您希望將它們 作為動態寫入參數使用）。為了便於對階層 方塊進行參數化，階層方塊現在可以攜帶參數（作為 該階層方塊自身「屬性」中的參數）。

「參考運算子」允許將路徑從 階層式方塊的表面（參見 階層式方塊的「屬性」）設定至可能深層嵌套的特定參數。 如此一來，即使是 位於受保護層級方塊中的參數（或位於 其他受保護層級方塊所嵌套的受保護層級方塊中的參數），也能在執行期間進行設定與重設， 因為其參數化介面已在層級結構中上移至一個 不受存取限制的層級。

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

在我們的範例中，這表示您可以參考模組 ReferenceOperatorExample中的參數 Value，以及模組 ModuleWithConnectedParameter 中的參數 ConnectionToYLengthInModuleBuffer。

參照參數 參照的值 運算子實例ReferenceOperatorExample：

參照模組 ModuleWithConnectedParameter 的參數 ConnectionToYLengthInModuleBuffer：

透過六種可用的參照運算子，提供了所有可 作為受保護層級框中參數值出現的資料類型。

************************************************************

翻譯運算子

參數函式庫中的轉換運算子，允許透過轉換方式存取 一個或多個其他運算子的參數。

進行計算時，您需定義公式。這些公式的語法符合 GenICam API 2.0 版本，相關說明如下。

讀取操作：

在參數ReadAction 中，您可定義當對 轉換運算子的參數Value進行讀取存取時， 會發生什麼情況。

與參考運算子相比，其中一項主要差異在於轉換 運算子並非單純儲存一個值。相反地，參數 Value的值是根據一個公式計算得出的。這個 公式由您在參數ReadAction 中定義。

一旦對參數 Value 進行讀取存取，您在 ReadAction中定義的公式便會執行，而結果會 傳送給請求該值的元件。

該公式可在設計中的任何位置包含運算子參數的值。一旦 其中一個值發生變化，轉換運算子參數 Value的計算結果便會產生新的結果（與 先前持有的參數Value的值不同）。

該公式不僅能納入參數的數值，還能納入參數的 特定屬性，例如最小值、最大值、步長，或是 枚舉項的數值。

寫入動作

在WriteAction 參數中，您可定義在對 轉換運算子的Value參數進行寫入存取時， 會發生什麼情況。

與參考運算子不同，您並非單純將 參數Value的值轉發給設計中的另一個參數。 相反地，參數Value的值將用於執行 您在轉換運算子的 WriteAction參數中定義的一組寫入動作。 寫入 動作由一個或多個方程式組成。透過這些方程式的左邊， 您可以定義由哪個運算子的哪個參數接收計算結果。若 您定義了多個方程式，請使用分號將各方程式分隔開來。

一旦對參數 Value 進行寫入存取，您在參數WriteAction中定義的 方程式右側的公式便會 被執行，而結果將傳遞至方程式左側 所指定的參數。

該公式可參照設計中任何位置的運算子參數值。一旦 其中任一值發生變更，當您 將該值重新寫入「值」 參數時，計算結果將會有所不同。

該公式不僅能納入參數的數值，還能納入參數的 特定屬性，例如最小值、最大值、步長，或是 枚舉項的數值。

資料類型：

您所選的運算子會決定其參數 Value 的資料類型，例如：

運算子IntParamTranslator→ 整數值

運算子FloatParamTranslator-> 浮點數 整數 值

運算子EnumParamTranslator→ 一個 枚舉的值

然而，儘管運算子定義了其參數 Value 的類型，但並未限制在寫入或讀取操作期間 所存取之參數的資料類型。 例如，運算子 IntParamTranslator定義其參數 Value的類型為整數；但該運算子中 所定義的公式仍可包含對（例如）double 類型參數的存取。

數值範圍計算公式

您也可以加入公式，用以計算參數 Value 的當前數值範圍。您可在 參數RangeFrom、 RangeTo 以及 RangeIncrement（步長）中定義相應的公式。

這些公式可在設計的任何位置包含模組參數的數值， 以及這些參數的特定屬性，例如最小值、最大值、 步長，或枚舉項的數值。

引用全域常數

除了存取模組參數及其屬性外，轉換 公式亦可參照全域常數。全域常數提供全系統通用的 數值，可用於參數轉換表達式中。

在翻譯公式中，您可以使用 :: 前綴。其 一般語法如下： ${::ConstantName}，例如 ${::DesignClock} 或 ${::ConstantName}

以下標準 全域常數預設可供在轉換公式中使用：

當 Value 是靜態的，您可以透過設定 來建立使用者自訂的全域常數 DisplayHierarchy 模組參數 至 :: 表格中顯示 IntVariable, FloatVariable, IntParamTranslator，或 FloatParamTranslator 運算子。這會建立一個全域常數，供翻譯公式使用。 您可以透過以下方式存取它： ${::myGlobalConst}.

營運商清單

以下清單彙整了所有「函式庫參數」的運算子