VisualApplets
Operator Reference

運算子庫：硬體平台

此運算子代表 CXP 雙抽頭（dual-tap）相機與 VisualApplets 之間的影像資料介面。您可以將此運算子用於單通道、雙通道或四通道 CXP 介面。您可以使用 ConnectionCount 參數來選擇介面類型。無論相機提供何種格式，該運算子都會輸出每個 tap 連接埠的原始影像資料。然後，您需要將此影像資料轉換為相機所傳送的格式。若要轉換影像資料，請使用適當的運算子來進行組合，並將原始位元組值轉型（cast）為像素值。操作過程中的某些特定情況可能會透過如下所述的事件系統進行通訊。此外，該運算子還具備各種用以發送與相機連線狀態信號的參數。

CXP 標準多重抽頭（Multi-Tap）定義

通常，影像像素是從左上角到右下角依序掃描。然而，隨著現代影像感測器上的像素數量持續穩定成長，這種方法已無法產生可接受的幀率。為了解決這個問題，感測器製造商採用同時掃描多個像素的方法。CXP 標準透過引入 taps 的概念來支援此技術。tap 可以被視為一個依序讀取影像像素的掃描裝置。影像的掃描方式被定義為 Tap Geometry，主機從裝置中讀取此幾何形狀。

CXP 標準建議畫面擷取卡主機應支援 1X-1Y、1X-1Y2 與 1X-2YE 這三種 tap 格式。其中 1X-1Y 格式代表從左上角到右下角逐像素掃描的預設特性，而其他格式則代表下圖中所描繪的兩種 tap 幾來自：

儘管來自每個 tap 的資料被組成獨立的資料流，但請務不過，資料流 ID 與 tap 之間沒有固定的對應關係。不過可以確定的是，此對應關係在擷取過程中保持恆定。The TapG 代碼，因此尋找此對應關係所需的資訊提供在 CXP 影像標頭中，可以在選用的 MetaDataTap0/1 連接埠上讀取。

在 VisualApplets 中進行實例化

運算子在其輸出 tap 上提供影像資料。此輸出隨時存在。單 tap 時為 1，雙 tap 相機則需設定為 2。除了這些標準輸出連接埠之外，您還可以專門為每個 tap 輸出設定選用的 CXP 標頭中繼資料 MetaData 輸出，亦即針對雙 tap 應用程式，您最多可以定義 2 個 MetaDataTap 連接埠。在運算子實例化期間會出現以下彈出對話方塊，並可設定為以下排列組合：

選擇性 MetaDataTap 連接埠

兩個中繼資料連接埠的格式是相同的。 它在 VisualApplets 中以 32 位元輸出提供，並顯示在下圖中：

每個 CXP 張影格都提供對應的無錯誤影像標頭。對於不正確的影像標頭，不會將任何影像串流資料饋送至 VisualApplets 管線中。壓縮的影像標頭由 6 個字組組成。最後一個位元組用於附加資訊，該資訊僅供內部使用。特別是，HeaderError 位元可用於通知影像標頭本身是否有錯誤。

裝置資源使用情況

根據參數 ConnectionCount 的選擇，運算子會使用一個或多個類型為 CameraPort 的資源。對於事件 system，會使用類型為 EventPort 的資源。如果 ConnectionCount 設定為 X4（四通道），將會開啟以下資源對話方塊：

錯誤處理與事件系統

當運算子偵測到接收到的重建影格大於或小於相機在 CXP 影像標頭中所宣告的大小時計數，安全機制將會啟動。隨後，運算子會切斷超出範圍的像素和行，使後續的處理管線一律看到影像標頭中定義的影格尺寸。若接收到的影格尺寸小於影像標頭中指定的尺寸，運算子將會以未定義的資料填滿接收到的影格，以達到影像標頭中所定義的指定影格尺寸。填滿較小的影格可能會導致後續影格遺失。隨後會透過事件將遺失情況回報給執行階段軟體（Framegrabber SDK）（請參閱下列段落）。尺寸不符也會觸發事件。

For a set of very critical errors, the operator will forward asynchronous events to the host runtime software (Framegrabber SDK). The event name in the Framegrabber API is <hierarchical operator name>\CxpStreamStatus, e.g. Device1\Process0\Camera\CxpStreamStatus. The event payload is provided as four 16-bit data words. The event format is defined as follows:

事件分為兩種類型：損壞實體事件和遺失實體事件。word 3 的 bit 0 描述了發生的事件類型。如果事件緩衝區已滿，可能會發生事件遺失的情況。當標記損壞實體的事件遺失時，將設定 word 3 的 bit 1。當標記遺失實體的事件遺失時，將設定 word 3 的 bit 2，並且 bit 3 到 15 將提供指示遺失畫格的遺失事件數量。如果設定了 bit 2 但 Counter 為 0，則表示發生了計數器溢位。

每個事件都會引起軟體中斷。為了減少事件數量，可以將多個具有相同畫格標籤的事件合併在一起。在這種情況下，某些錯誤旗標會被組合。如果事件遺失，遺失事件之前的事件將包含有關該遺失事件的資訊，並且無法與具有相同畫格標籤的其他事件進行合併。

因 CRC 錯誤而引起的事件會回報一個畫格標籤，該標籤可能與發生 CRC 錯誤的畫格不完全相關。畫格標籤可能是前一個或後一個畫格的標籤。這種情況只有在攝影機發送包含 2 個或更多畫格之間過渡的 CXP 封包時才會發生。CRC 計算在封包結束時完成，但串流資料是在即時 (on-the-fly) 重建的。這意味著可能會出現以下情況：在運算子發送前一個畫格之後，才偵測到 CRC 錯誤。在正常情況下（攝影機封包不包含正在進行的畫格結尾和下一個畫格開頭的資料），CRC 錯誤期間的畫格標籤將始終正確。對於所有其他情況，只要完整的畫格串流資料小於 8k 的最大封包大小，每個封包內可能只有 1 個畫格重疊。在這種情況下，軟體應用程式應將帶有畫格標籤 - 1 的前一個畫格以及帶有畫格標籤 + 1 的後一個畫格也視為可能損壞。