VisualApplets
Operator Reference

Operator Library: Parameters

運算子 EnumParamTranslator 允許對一個或多個其他運算子的參數進行翻譯存取（讀取與寫入）。您可透過定義公式來進行計算。這些公式的語法符合 GenICam API 2.0 版本。

運算子 EnumParamTranslator 會產生一個 VA_ENUM 類型的對應參數。該對應參數的名稱為 Value。

雖然此運算子將其參數 Value 的類型定義為 VA_ENUM，但它不會限制在寫入或讀取操作期間所存取參數的資料類型。例如，運算子中定義的公式可以包含對浮點數類型參數的存取。

讀取動作

在參數 ReadAction 中，您可以定義對轉換 operator 的參數 Value 進行讀取存取時所發生的情況。 參數 Value 不僅僅是保存一個值。 相反地，參數 Value 的值是透過公式計算得出的。 您可以在參數 ReadAction 中定義此公式。 一旦發生對參數 Value 的讀取存取， 您在 ReadAction 中定義的公式就會執行， 並將結果轉發給請求該值的元素。

該公式可以包含設計中任意位置的 operator 參數值。 只要這些值其中之一發生變更，轉換 operator 參數 Value 的計算就會得出新的結果 （與參數 Value 之前保存的值不同）。 該公式不僅可以結合參數的值，還可以結合參數的特定 Property，例如最小值、最大值、步進大小或列舉項目的數值。

寫入動作

在參數 WriteAction 中，您定義了對翻譯運算子參數 Value 進行寫入存取時所發生的情況。與參照運算子不同，您不只是簡單地將參數 Value 的值轉發給設計中的另一個參數。相反地，參數 Value 的值是用於您在翻譯運算子參數 WriteAction 中定義的一組寫入動作。寫入動作由一個或多個方程式組成。透過這些方程式的左側，您可以定義哪個運算子的哪個參數會接收計算結果。如果您定義了多個方程式，請使用分號將方程式隔開。一旦對參數 Value 發生寫入存取，您在參數 WriteAction 中定義的方程式右側公式就會被執行，且其結果會被轉發到方程式左側指定的參數。

該公式可以參照設計中任何位置的 operator 參數值。 只要這些值之一發生變更，當您將與之前相同的價值重新寫入 Value 參數時，計算結果就會有所不同。 該公式不僅可以納入參數的值， 還可以納入參數的特定 Property，例如最小值、 最大值、步進大小或列舉項目的數值。

參照 Map Parameters

您可以在設計階層中定義一個目標，在此目標中，map parameter Value 將會顯示且可供存取。 此目標由兩個 parameters 定義：DisplayHierarchy 與 DisplayName。 在 DisplayHierarchy 中，您指定的是 translation operator 本身所在的 同一個處理程序中的階層式方塊。 在 parameter DisplayName 中，您設定目標 parameter 的名稱。 如果同時設定了 DisplayHierarchy 與 DisplayName， 則由 DisplayName 定義的 parameter 將可在 由 DisplayHierarchy 指定的階層式方塊中使用。 如果 DisplayName 為空白，則不會建立任何 parameter。 如果設定了 DisplayName，但 DisplayHierarchy 為空白， 則由 DisplayName 定義的 parameter 將會新增至父階層（亦即 translation operator 本身所在的階層式方塊）。

這可讓您在（設計的）任何所需階層層級上， 使 map parameter Value 能夠被存取。 這在使用受保護的階層式方塊時特別有用。 您可以直接在受保護階層式方塊本身的 properties 下方， 使該 parameter 可用。

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

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

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