VisualApplets
Operator Reference

Operator Library: Parameters

Operator IntParticipantTranslator 允許對一個或多個其他 operator 的參數進行轉換式存取（讀取與寫入）。 您可為計算定義公式。這些公式的語法符合 GenICam API 2.0 版標準。 下方提供詳細的語法說明。

此外，此 operator 也可用於建立使用者定義的全域常數，以便在轉換公式中使用。 當 Value 為靜態時，您可以透過將 DisplayHierarchy 參數設定為 :: 來建立全域常數。 所產生的常數將在全系統範圍內生效，並可在所有 參數轉換公式中進行存取。如需在轉換公式中使用全域常數的詳細資訊，請參閱 DisplayHierarchy 參數說明。

Operator IntParamTranslator 會產生一個型別為 VA_SINT 的對應參數。 該對應參數的名稱為 Value。

儘管此 operator 將其參數 Value 的型別定義為 VA_SINT，但它並不會限制在寫入或讀取操作期間所存取參數的資料型別。 例如，operator 中定義的公式可以包含對浮點數型別參數的存取。

讀取動作

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

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

寫入動作

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

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

數值範圍計算公式

您也可以新增公式來計算參數 Value 的目前數值範圍。 您可以在參數 RangeFrom、 RangeTo 和 RangeIncrement（步進大小）中定義對應的公式。 這些公式可以包含設計中任意位置的模組參數值， 以及這些參數的特定 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。