VisualApplets
Operator Reference

Operator Library: Parameters

運算子EnumParamTranslator允許對一個或多個其他運算子的參數進行轉換存取（讀取與寫入） 。 您需定義公式以進行計算。這些公式的語法符合GenICam API 2.0 版本規範。

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

雖然該運算子將其參數Value的型別定義為 VA_ENUM 型別，但並未限制在寫入或讀取操作期間 所存取之參數的資料型別。 例如，該運算子中定義的公式可包含 對 float 型別參數的存取。

閱讀動作

在參數ReadAction 中，您可定義當對轉換運算子的參數Value進行讀取存取時， 系統將如何處理。 參數Value並非僅是儲存一個值。 相反地，參數Value的值是根據一個公式計算得出的。 您需在ReadAction 參數中定義此公式。 一旦發生對Value 參數的讀取存取， 系統便會執行您在ReadAction中定義的公式， 並將結果傳送給請求該值的元件。

該公式可在設計中的任何位置包含運算子參數的數值。 一旦其中任一數值發生變化，轉換運算子參數 「Value」的計算結果便會產生新的結果 （與先前持有的參數「Value」的數值不同）。 公式不僅可以納入參數的數值，還能納入參數的特定屬性， 例如最小值、最大值、步長，或是枚舉項的數值。

寫入操作

在參數WriteAction 中，您可定義在對 轉換運算子的參數Value進行寫入存取時會發生什麼情況。 與參考運算子不同，您不會單純地將 參數Value的值轉發給設計中的另一個參數。 相反地，參數Value的值 將用於執行您在轉換運算子的 參數WriteAction中所定義的一組寫入動作。 寫入動作由一個或多個方程式組成。 透過這些方程式的左邊，您可以定義哪個運算子的 哪個參數將接收計算結果。 若定義多個方程式，請以分號分隔各方程式。 一旦對參數Value 發生寫入存取，您在參數WriteAction中定義的方程式 右側所列之公式 即會被執行，且結果將轉發至 方程式左側所指定的參數。

該公式可參照設計中任何位置 的運算子參數值。一旦其中任一數值發生變化， 當您將 與先前相同的數值重新寫入「值」參數時，計算結果將會有所不同。 公式不僅可以納入參數的數值， 還能納入參數的特定屬性，例如最小值、 最大值、步長，或是枚舉項的數值。

引用地圖參數

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

這讓您可以將地圖參數「Value」 設定為在（設計的）任何您想要的階層層級上皆可存取。 這在處理受保護的階層化方塊時特別有用。 您可以將該參數直接 設定為位於受保護的階層化方塊本身的屬性之下。

已映射的參數可以被自身引用。 因此，您可以在翻譯運算子中引用參數 Value的內容， 或引用您在參數 DisplayName和DisplayHierarchy 中所定義的參數。 這在 受保護的階層式方塊是由其他受保護的階層式方塊所構建時，尤其重要。

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

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