Operator BaseRgbCamera

運算子庫:硬體平台

此運算子將來自 Camera Link BASE RGB 配置相機的影像資料傳輸至 VisualApplets 中。 支援 Camera Link 標準的所有 RGB BASE 配置。

The operator uses one resource of type CameraPort exclusively. You can select Camera Link port A ( 0 ) or Camera Link port B ( 1 ) of the frame grabber. The same resource index can only be used once per applet.

microEnable 5 ironman VD8-PoCL:在 mE5 VD8-PoCL (ironman) 上,只有連接埠 A 提供所有相機功能,即 CC 訊號與序列介面。 在 mE5 VD8-PoCL (ironman) 上,連接埠 B 既不提供 CC 訊號也不提供序列介面。 儘管如此,如果相機先前已經過預先編程,則可以在自由執行 (free-run) 模式下操作相機。 連接埠 B 的這些限制僅適用於 mE5 VD8-PoCL (ironman),不適用於使用此運算子的任何其他擷取卡型號 (LightBridge、marathon 等)。

[重要] 「Tap」的定義

在本手冊中,one tap 的含義是指任意 Bit Width 的一個解碼色彩分量。

請注意,在 CameraLink Specification Version 2.1 中,one tap 被定義為包含所有色彩分量的一個彩色像素。

下表顯示了 VisualApplets 標記法與 CameraLink Specification Version 2.1 之間的對應關係:

VA 標記法 CameraLink 標記法
Tap3x8 ................ 8-bit RGB Medium 1 tap

表 57. VA 標記法與 CL Specification Version 2.1 的對應關係


下圖顯示此模式下的像素對應 (Tap3x8bit):

適用於硬體平台
mE5 marathon VCLx
mE5 marathon VCL
LightBridge VCL
mE5 VD8-PoCL (ironman)

I/O Properties

Property Value
Operator Type M
Output Link O,影像資料輸出

Supported Link Format

Link Parameter Output Link O
Bit Width [3,63]1
Arithmetic 無號數
Parallelism 任何,請參閱參數說明
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D,VALT_LINE1D}
Color Format VAF_COLOR
Color Flavor FL_RGB
Max. Img Width Any
Max. Img Height Any

1

由於 RGB 元組的關係,bitwidth 必須是 3 的倍數。

參數 BitWidth 可以設定為大於或小於相機實際傳送之位元寬度的值。

如果參數設定的值小於相機實際傳送的 bitwidth, 則會截斷像素分量的最低有效位 (LSB)。 每個像素分量僅將最高有效位 (MSB) 傳輸至 VisualApplets 中。

如果參數設定的值大於相機實際傳送的 bitwidth, 則原始像素分量會設定在輸出分量的 MSB 位置。LSB 會填入零。

在這兩種情況下,相對亮度保持不變,即白色像素仍然是白色,黑暗像素仍然是黑暗。

Parameters

DvalMode
Type dynamic write parameter
Default DVAL_Enabled
Range {DVAL_Enabled, DVAL_Disabled}

此參數指定是用 DVAL 來遮罩有效像素,還是忽略它。 當忽略 DVAL 時,會根據 LVAL 與 FVAL 狀態來選取有效像素。

FvalMode
Type 動態/靜態寫入參數
Default CameraLinkStandard
Range {CameraLinkStandard, IgnoreFval}
  • CameraLinkStandard

    此運算子預期接收來自相機的畫面有效 (FVAL) 訊號。 在此情況下,運算子將根據 FVAL 大小輸出畫面。

  • IgnoreFval

    如果使用此設定,運算子將忽略來自相機的任何 FVAL 訊號。 所有輸入行都將被使用並合併為一個具有無限高度的單一影像。

    [注意] 僅適用於輸出影像協定 VALT_IMAGE2D

    此參數僅在輸出設定為影像協定 VALT_IMAGE2D 時可用。 如果選取 VALT_LINE1D,則該參數會停用,且無論如何都會忽略 FVAL。

    [警告] VisualApplets 連結規則違規

    當相機運算子輸出無限高度的畫面時,可能會超過連結屬性中定義的最大影像高度 (Max. Img Height)。 這會導致違反 VisualApplets 連結規則。 請確保使用有效的高度。 使用 SplitImage 運算子來限制影像高度,並將無限影像分割成多個區塊。

此參數的目的是允許在同一個 applet 中動態使用面陣相機和線陣相機。

BaseMode
Type dynamic write parameter
Default Tap3x8bit
Range {Tap3x8bit}

此參數指定 BASE 配置模式。

CameraStatus
Type 動態讀取參數
Default
Range

LightBridge/marathon:[0;2^8-1]

mE5 VD8 ironman:[0;2^4-1]

bit[0]:PCLK 可用

bit[1]:FVAL 當前值

bit[2]:LVAL 當前值

bit[3]:DVAL 當前值

bit[4-7]: 保留(僅限 LightBridge 與 marathon)

CameraLinkCoreReset
Type dynamic write parameter
Default 0
Range [0; 1]

Reserved for support issues.

PixelClock
Type 動態讀取參數
Default 0
Range [0; 85] MHz

相機通道的像素時脈速率(以 MHz 為單位)。

MinimalParallelism
Type 靜態讀取參數
Default 1
Range [1; 1024]

輸出連結 O 能夠傳輸攝影機的最大頻寬而不遺失資料所需的最小 Parallelism。 此數值取決於當前選定的設計時脈頻率。 頻率越高,Parallelism 數值可以越低。