VisualApplets
Operator Reference

此參數定義在畫面 開頭處略過的行數。

指定每個畫面的行數，亦即影像高度。

如果 ImgTriggerMode 設為 ExternSw_Gate 且 MaxGatedHeight 設為 unrestricted，則會忽略此參數。 在此情況下，畫面高度取決於外部 Image Gate 訊號的持續時間（請參閱 ImgTriggerMode 的說明）。

控制當 ImgTriggerMode 設為 ExternSw_Gate 時，是否限制最大影像高度。

當設為 restricted 時， 影像高度會限制為 YLength 中指定的數值， 即使閘道訊號維持開啟狀態亦然。任何額外的行都會被捨棄， 並且運算子會等待閘道訊號的下一個上升緣以啟動新畫面。

當設為 unrestricted 時， 影像高度完全取決於閘道保持開啟的時間長度。換句話說， 它取決於外部影像觸發訊號的脈衝寬度，或是軟體觸發保持在數值 1 的時間長度。 如果閘道保持開啟很長一段時間，所產生的影像可能會變得非常大。

	可能會違反連結屬性
	在 unrestricted 模式下使用此參數 可能會違反 VisualApplets 連結協定。 影像高度可能會超過運算子輸出連結中所定義的最大允許影像高度。 請謹慎使用 unrestricted 模式。 有關連結屬性的詳細資訊，請參閱 'Link Properties'。 隨後的 SplitImage 運算子可以將大型影像分割成較小的區塊。

選取內部 Exsync 訊號產生器的 Operating Mode。當使用外部觸發模式時，Trigger Source 由 LineTrgInSourceA 和 LineTrgInSourceB 定義。

啟用或停用傳送至相機的 Exsync 輸出。

此參數指定用於觸發 Exsync 訊號產生器的訊號來源。此參數僅在 LineTriggerMode 設為 Extern_Trigger 或 Extern_Trigger_Gated_by_Img 時才相關。

此參數指定用於觸發 Exsync 訊號產生器的訊號來源。此參數僅在 EncoderABMode 設為其中一個 A/B 模式（Signal_AB_Filter、 Signal_ABx2_Filter 或 Signal_ABx4_Filter）時才相關，此外：

選擇僅使用觸發輸入 A，還是同時使用觸發輸入 A 和 B 來產生 Exsync。

訊號 A/B 支援可讓運算子判定軸編碼器的旋轉方向，並抑制反向移動或進行補償：

啟用 A/B 支援時的相關參數：

若要重設軸編碼器狀態和 EncoderCompensationCount，請將 EncoderABMode 設為 Signal_A_Only。

定義哪個訊號領先，以識別軸編碼器的正向旋轉方向：

透過 EncoderCompensation 參數，您可以將軸編碼器後退移動的補償切換為 ON 或 OFF。

此參數僅在 EncoderABMode 參數設為 A/B 支援時才相關。

ON

如果設為 ON，運算子會監控軸編碼器的後退移動。當發生後退移動時，運算子會計算朝後退方向移動的編碼器步數。一旦軸編碼器再次向前移動，這些已計算的步數（現在處於正向）將不會被傳輸為外部觸發訊號。唯有當輸送帶回到後退移動開始的位置時，正向的編碼器步數才會再次被傳輸為外部觸發訊號。

參數 EncoderCompensation = ON：

OFF

如果設為 OFF，運算子在輸送帶後退移動期間不會傳輸任何觸發訊號。一旦輸送帶開始再次向前移動，運算子就會恢復將軸編碼器步數（正向）作為觸發訊號傳輸。

參數 EncoderCompensation = OFF：

若要將 EncoderCompensationCount 參數重設為值 0，請將 EncoderCompensation 參數設為 OFF。

此參數指定可指派給 EncoderCompensationCount 的值範圍。

此參數僅在 EncoderCompensation 參數設為 ON 且 EncoderABMode 參數設為 A/B 支援時才相關。

此參數指定輸送帶向前移動的偏移量。當輸送帶停止且/或向後移動時，這特別有用。

您可以使用 EncoderCompensationCountBits 參數為 EncoderCompensationCount 參數定義特定的值範圍。

若要重設軸編碼器與 EncoderCompensationCount 參數，請將 EncoderABMode 參數設為 Signal_A_Only 值。

或者，您可以透過將 EncoderCompensation 參數設為 OFF，將 EncoderCompensationCount 參數重設為值 0。

基本條件

如果 EncoderCompensation 參數設為 ON，內部 Counter 會計算輸送帶向後移動的軸編碼器步數。當輸送帶開始再次向前移動時，您就可以補償確切的軸編碼器步數：

只要輸送帶向後移動，內部 Counter 就會正向計數。在上圖中：從 0 到 8。

當輸送帶向前移動時，內部 Counter 會進行倒數。 如上圖所示：從 8 到 0。

當內部 Counter 的值為 0 時， 軸編碼器步進將會以觸發信號的形式傳輸。

內部 Counter 在特定時間點所持有的值即為 EncoderCompensationCount 參數的值。唯有此值為 0 時，編碼器步進才會作為觸發信號傳輸。如果 EncoderCompensationCount 參數的值為 ≠0，則軸編碼器步進不會作為觸發信號傳輸，且該值會隨著每個編碼器步進不斷改變，直到再次達到 0 為止。

讀取參數

EncoderCompensationCount 參數是一個 讀寫參數。因此，您可以隨時讀取 Counter 在任何時間點所持有的值。

定義偏移量

另一方面，由於您在擷取期間擁有寫入權限，因此您可以隨時修改參數值。如果您需要為標準編碼器補償定義偏移量，您可以使用此參數來輸入所需的偏移量步進數。

只要您輸入 EncoderCompensationCount 的值， 此值就會覆寫該參數先前持有的值。

以下範例顯示如何修改 EncoderCompensationCount 的現有值：

範例 1： 輸送帶正在 向前移動，軸編碼器步進會作為觸發信號傳輸，且 EncoderCompensationCount 的值為 0。接著，EncoderCompensationCount 的值 0 會被 值 4 覆寫。結果：有 4 個 軸編碼器步進不會作為觸發信號傳輸。

範例 2： 輸送帶正在 向後移動，（向後）軸編碼器步進會被抑制，且 EncoderCompensationCount 的值為 ≠0。接著，在輸送帶向後移動期間，EncoderCompensationCount 的值 5 會被 值 7 覆寫。結果： 偏移 2 個軸編碼器步進。

範例 3： 輸送帶在補償期間正向前移動 ，（向前）軸編碼器步進會被抑制，且 EncoderCompensationCount 的值為 ≠0。接著，在輸送帶進行補償性向前移動期間，EncoderCompensationCount 的值 4 會被 值 9 覆寫。結果： 偏移 5 個軸編碼器步進。

範例 4： 輸送帶在補償期間正向前移動 ，（向前）軸編碼器步進會被抑制，且 EncoderCompensationCount 的值為 ≠0。接著，在輸送帶進行補償性向前移動期間，EncoderCompensationCount 的值 4 會被覆寫為 較小的值，以我們的案例來說，該值為 3。結果： -1 個軸編碼器步進的負偏移量。

此參數定義外部輸入觸發信號 LineTrgInSourceA 與 LineTrgInSourceB 的極性。當設為 LowActive 時，Exsync 產生器會在指定的行觸發來源 (LineTrgInSourceA / LineTrgInSourceB) 的下降緣啟動。否則，Exsync 會在上升緣開始產生。此參數僅在 LineTriggerMode 設為 Extern_Trigger 或 Extern_Trigger_Gated_by_Img 時才有意義。

此參數指定產生 Exsync 所需的外部輸入觸發信號數量。此參數僅在 LineTriggerMode 設為外部觸發模式時 才有意義。

此參數指定產生畫面第一個 Exsync 所需的外部輸入觸發信號數量。此參數僅在 LineTriggerMode 設為 Extern_Trigger_Gated_by_Img 時才有意義。

此參數指定 Exsync 信號的週期。因此，當使用擷取卡控制模式來觸發 連接的相機時，它會定義行頻。

此參數的範圍和允許的步進大小取決於設計中設定的 FPGA 時脈 頻率。允許的步進大小為 1/DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。

此參數指定 Exsync 信號的脈衝寬度，許多相機可以使用此參數來指定 Exposure Time。因此，即使在擷取過程中，也可以透過軟體調整 Exposure Time。

此參數的範圍和允許的步進大小取決於設計中設定的 FPGA 時脈 頻率。允許的步進大小為 1/DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。

此參數指定產生的 Exsync 信號相對於外部觸發輸入的延遲。因此，Exsync2 信號是 Exsync 的延遲複製品：其極性、週期等皆與 Exsync 相同。

此參數的範圍和允許的步進大小取決於設計中設定的 FPGA 時脈 頻率。允許的步進大小為 1/DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。

此參數將 Exsync 信號產生器的極性調整為 連接相機所接受的極性。如果相機在下降緣開啟快門，請使用 LowActive；否則請使用 HighActive。

此參數用於選擇內部 Image Gate 的運作模式。

影像觸發輸入訊號可由外部（即週邊）裝置（例如軸編碼器）或軟體產生。您可透過 ImgTrgInSource 參數選擇外部影像觸發輸入的來源，請參閱下方說明。

ImgTriggerMode 參數的值會引發下列行為：

此參數指定用於觸發影像擷取的信號來源。這僅在 ImgTriggerMode 設為 ExternSw_Trigger 或 ExternSw_Gate 時才有作用。

此參數定義外部輸入觸發信號的極性。

此參數將影像觸發信號延遲指定的影像行數。

啟用或停用 Flash 輸出。Flash 信號的脈衝寬度等於一個行週期。

此參數定義所產生 Flash 信號的極性。

此參數指定相對於外部觸發輸入，所產生的 Flash 信號需延遲的行數。因此，可以將 Flash 與外部觸發輸入進行同步。

Flash 信號的脈衝寬度等於一個行週期。

將此參數設為 1 將會產生軟體觸發。這僅在 ImgTriggerMode 設為外部觸發模式且 ImgTrgInSource 設為 SoftwareTrigger 時才有作用。

透過此參數，可以針對影像觸發模式 ExternSw_Gate 產生軟體閘道。

ImgTrgIsBusy 參數表示影像觸發的忙碌狀態。當影像觸發處於忙碌狀態時，該參數會設為 1 以表示目前正在擷取影像。當設為 0 時，表示影像觸發未處於忙碌狀態。

此參數指定 CC1 線（相機控制 1）上可用的信號。

此參數指定 CC2 線（相機控制 2）上可用的信號。

此參數指定 CC3 線（相機控制 3）上可用的信號。

此參數指定 CC4 線（相機控制 4）上可用的信號。

此參數定義 ImgTrgDebouncingTime 參數的最大值。較小的最大值可減少實作去彈跳 Timer 所需的 FPGA 資源。

此參數的有效範圍與允許的步進值取決於設計中設定的 FPGA 時脈頻率。允許的步進值為 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。

此參數指定去彈跳時間，在此時間內輸入影像觸發信號必須保持不變才能被識別為有效。去彈跳時間內的快速信號變化將被濾除。

此參數的有效範圍與允許的步進值取決於設計中設定的 FPGA 時脈頻率。允許的步進值為 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。

此參數指定 LineTrgDebouncingTime 參數的最大時間。較小的最大值可減少實作防彈跳 Timer 所需的 FPGA 資源。

此參數的有效範圍與允許的步進值取決於設計中設定的 FPGA 時脈頻率。允許的步進值為 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。

此參數指定輸入線觸發訊號必須保持不變以被識別為有效訊號的防彈跳時間。防彈跳時間內的快速訊號變更將會被濾除。

此參數的有效範圍與允許的步進值取決於設計中設定的 FPGA 時脈頻率。允許的步進值為 1 / DesignClockFrequencyInMhz。

DesignClockFrequencyInMhz = 設計中 FPGA 時脈的 頻率，單位為 MHz。