Image Enhancer vTool#
Image Enhancer vTool 透過 Image 輸入接腳接收影像,並透過 Image 輸出接腳輸出過濾後的影像。
如果您在增強之前使用 ROI Creator vTool 來指定興趣區,Image Enhancer vTool 將透過其 Roi 輸入接腳接收 ROI 資料。在這種情況下,只會增強興趣區,從而加快處理速度。
Image Enhancer vTool 可在 Preprocessing Basic 授權中使用。若要購買授權,請造訪 Basler 網站。

運作原理#
Image Enhancer vTool 提供兩種增強操作:
Stretch Histogram#
透過拉伸直方圖,可以修改直方圖的上下限。小於或等於下限的所有灰階值都會對應到灰階值 0。大於或等於上限的所有灰階值都會對應到最大灰階值(即 8 位元 Pixel Format 為 255,其他 Pixel Format 則為 65535)。以數學術語來說,直方圖拉伸是由兩個使用者定義的限制所定義的線性轉換。
有兩種方法可以指定灰階值範圍的新上下限:
- Adaptive:灰階值範圍是透過分析個別影像的直方圖來決定的。透過指定相對等級,您可以捨棄範圍上下端的灰階值區段。
- Fixed:您可以手動指定灰階值範圍的新上下限。這些限制對所有影像都是相同的。
資訊
對於彩色影像,adaptive 模式會分別處理三個色頻。因此,影像的整體色彩外觀可能會改變。
使用 fixed 模式時,相同的限制會套用到所有色頻。
在 fixed 模式下,處理速度極快,處理時間微不足道。在 adaptive 模式下,雖然會分析每個影像的直方圖,但處理速度依然非常快。
Equalize Histogram#
均勻化直方圖是指將影像的所有灰階值均勻分佈在整個範圍內,例如 0–255。透過此操作,直方圖中灰階值較密集的區域會被拉伸,而分佈稀疏的區域則會被壓縮。這會產生一個線性的直方圖。
資訊
對於彩色影像,三個色頻的直方圖會被分開均勻化。因此,影像的整體色彩外觀可能會改變。
由於直方圖及其等化針對所處理的每個影像進行計算,因此處理時間取決於影像大小。
使用案例#
具有常數直方圖的影像#
在此情境中,輸入影像的灰階值範圍是固定的,但對比度稍低。例如,如果灰階值範圍介於 0 到 100 之間,您可以將上下限設為 0 和 100。隨後,生成的影像會被拉伸至完整的灰階值範圍,從而獲得對比度良好且明亮的影像。
具有變化直方圖的影像#
在此情境中,輸入影像的灰階值範圍可能會隨時間而變化。然而,應用程式要求恆定的直方圖或灰階值對比度。在這種情況下,您可以使用具有自適應限制的拉伸方法或等化方法。
針對一般使用情境,請使用拉伸。如果直方圖中的灰階值分佈非常不均勻,則最好使用等化。
設定 vTool#
若要設定 Image Enhancer Basic vTool:

- 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下該 vTool。
隨即會開啟 Image Enhancer Basic 對話方塊。 - 在 Enhancer Operation 區域中,選取所需的運算。
- 如果您已選取 拉伸直方圖,請選取拉伸方法。
- 如果您已選取 Adaptive,請指定排序等級 (rank)。
- 如果您已選取 Fixed,請指定下限和上限。
您可以在針腳資料檢視中查看增強處理的結果。
Inputs#
Image#
直接接收來自 Camera vTool 或輸出影像之 vTool(例如 Image Format Converter vTool)的影像。
- 資料類型:Image
- 影像格式:8 位元至 16 位元單色或彩色影像(請參閱Supported Pixel Formats)
ROI#
接收來自 ROI Creator vTool 或任何其他輸出區域或矩形的 vTool 的興趣區域 (ROI)。多個矩形或區域會在內部合併,以形成單一興趣區域。
- 資料類型:RectangleF、RectangleF Array、Region、Region Array
Outputs#
Image#
傳回過濾後的影像。輸出影像可由任何接受影像作為輸入的 vTool 使用。
- 資料類型:Image
- 影像格式:彩色或單色影像(請參閱支援的 Pixel Format)
支援的 Pixel Format#
根據輸入影像的像素格式,Image Combiner vTool 會輸出以下像素格式:
| Input Pixel Format | Output Pixel Format |
|---|---|
| Bayer GR 8 | RGB 8 Planar |
| Bayer GR 16 | RGB 16 Planar |
| Bayer RG 8 | RGB 8 Planar |
| BGRA 8 Packed | RGB 8 Planar |
| BGR 8 Packed | RGB 8 Planar |
| Mono 8 | Mono 8 |
| Mono 10 | Mono 10 |
| Mono 12 | Mono 12 |
| Mono 16 | Mono 16 |
| RGB 8 Packed | RGB 8 Planar |
| RGB 16 Packed | RGB 16 Planar |
| RGB 8 Planar | RGB 8 Planar |
| RGB 16 Planar | RGB 16 Planar |
相關 vTools#
典型前置項目#
典型後續元件#
- 任何影像處理 vTool