Gray Value Transformer vTool#
灰階轉換是一個實用的前置處理步驟，可用於改善或變更影像的灰階範圍。
Gray Value Transformer vTool 透過 Image 輸入接腳接收影像，並透過 Image 輸出接腳輸出轉換後的影像。
如果您在轉換前使用 ROI Creator vTool 指定感興趣區域，Gray Value Transformer vTool 將透過其 Roi 輸入接腳接收 ROI 資料。在這種情況下，灰階轉換只會在感興趣區域上進行，從而加快處理速度。
Gray Value Transformer vTool 適用於 Preprocessing Basic 授權。若要購買授權，請造訪 Basler 網站。
Gray Value Transformer vTool 版本#
Gray Value Transformer vTool 提供兩個版本：Starter 與 Basic。
這兩個版本之間只有一個區別：Starter 版本僅接受 RectangleF 資料類型作為 Roi 輸入接腳的輸入。Basic 版本則接受 RectangleF、RectangleF Array、Region 以及 Region Array 資料類型。
運作原理#
Gray Value Transformer vTool 提供兩種常見的灰階轉換方式：
- 反相 (Inversion)：此轉換將灰階直方圖從左到右翻轉，也就是反轉直方圖的軸線。透過這種方式，明亮的像素會變暗，反之亦然。
如果您選擇反相，則無法使用乘法和加法等 Arithmetic 運算。 -
Arithmetic 運算：
- 乘法 (Multiplication)：輸入影像中的所有灰階值都會乘以指定的係數。例如，您可以將影像乘以大於 1 的係數，以增加影像對比度並讓影像更亮。這種效果類似於放大，並會擴散直方圖。
- 加法 (Addition)：將指定的值加到輸入影像中的所有灰階值。加上正值會讓影像更亮（尤其是在暗部區域），而加上負值則會讓亮部區域變暗。
乘法運算會在加法運算之前執行。
資訊
由於乘法和加法會改變影像的灰階範圍，因此可能會發生灰階不足或溢位的情況。超出範圍的灰階值會自動設為輸入影像格式的最高或最低灰階值。
範例：在 8 位元影像中，轉換為負值的灰階值將設為 0，而高於 255 的灰階值將設為 255。
這兩種方法都可以協助您達成以下目的：
- 產生更符合使用者期望的影像
- 讓感興趣的影像特徵更為突出
- 讓後續的影像處理更加容易
設定 vTool#
若要設定 Gray Value Transformer vTool：
- 在 vTool Settings 區域中的 Recipe Management 窗格內，按一下 Open Settings 或按兩下該 vTool。
隨即會開啟 Gray Value Transformer Starter/Basic 對話方塊。 - 在 Transformer Operation 區域中，選取所需的轉換。
- 如果您已在步驟 2 中選取 Arithmetic operation，請指定所需的 Multiplication 與 Addition 值。
您可以在 pin data view 中檢視轉換結果。
Inputs#
Image#
直接接收來自 Camera vTool 或輸出影像之 vTool（例如 Image Format Converter vTool）的影像。
- 資料類型：Image
- 影像格式：8 位元至 16 位元單色或彩色影像（請參閱Supported Pixel Formats）
ROI#
接受來自 ROI Creator vTool 或任何其他輸出區域或矩形的 vTool 之興趣區域。多個矩形或區域會在內部合併，以形成單一興趣區域。Starter 版本僅接受 RectangleF。
- 資料類型：RectangleF、RectangleF Array、Region、Region Array
Outputs#
Image#
傳回轉換後的影像。輸出影像可由任何接受影像作為輸入的 vTool 使用。
- 資料類型：Image
- 影像格式：彩色或單色影像 彩色或單色影像（請參閱 Supported Pixel Formats）
支援的 Pixel Format#
根據輸入影像的 Pixel Format，Gray Value Transformer vTool 會輸出以下 Pixel Format：
| 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 |