VisualApplets
Operator Reference

Operator Library: Hardware Platform

This operator represents the image data interface between a CXP dual-tap camera and VisualApplets. You can use the operator for single channel, dual channel or quad channel CXP interfaces. You select the type of interface with the parameter ConnectionCount. The operator outputs raw image data for each tap port, no matter which format the camera delivers. You then need to convert this image data into the format sent by the camera. To convert the image data, use appropriate operators for aggregating and casting raw byte values to pixel values. Certain situations during operation may be communicated via the event system as described below. Additionally, the operator has various parameters signaling the status of the connection to the camera.

CXP Standard Multi-Tap Definition

Usually, the image pixels are scanned sequentially from the top left to the bottom right. However, with the steadily growing number of pixels on modern image sensors, this approach does not produce acceptable frame rates. To tackle this issue, sensor manufacturers help themselves by scanning multiple pixels at the same time. The CXP standard accommodates this technique by introducing the concept of taps. A tap can be seen as a scanning device, which reads the image pixels sequentially. The way an image is scanned is defined as the Tap Geometry, which the host reads from the device.

It is recommended in the CXP standard, that a frame grabber host supports the three tap formats 1X-1Y, 1X-1Y2, and 1X-2YE. The tap format 1X-1Y represents the default characteristic scanning the image pixel by pixel from top left to bottom right, while the other formats represent two tap geometries, that are depicted in the following figure:

Although data from each tap is formed into separate streams, it is important to note that there is no fixed mapping between the stream-ID and the tap. However, it is safe to assume, that this mapping remains constant during acquisition. The TapG code, and thus, the required information to find this mapping, is provided in the CXP image header, which can be read on the optional MetaDataTap0/1 ports.

在 VisualApplets 中進行實例化

此 operator在其輸出端（tap）上提供影像資料。此輸出始終存在。單輸出端（single tap）為 1，雙輸出端（dual-tap）相機則需要設定為 2。除了這些標準輸出連接埠之外，您還可以針對每個輸出端（tap）專門設定一個選用的 MetaData 輸出，用於 CXP 標頭（header）中繼資料，也就是說，對於雙輸出端（dual-tap）應用，您可以定義最多 2 個 MetaDataTap 連接埠。在 operator 實例化期間會出現以下彈出對話方塊，並且可以設定為下列排列組合：

選用的 MetaDataTap 連接埠

兩個中繼資料連接埠的格式完全相同。 它在 VisualApplets 中以 32 位元輸出提供，如以下圖片所示：

每個 CXP 個別畫面（frame）都提供對應的無錯誤影像標頭（header）。若影像標頭（header）不正確，則不會將任何影像串流資料載入 VisualApplets 管線（pipeline）中。壓縮的影像標頭（header）由 6 個 word 組成。最後一個位元組用於附加資訊，僅供內部使用。特別的是，HeaderError 位元用於通知影像標頭（header）本身是否有錯誤。

裝置資源使用量

根據參數 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:

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

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

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