Brightness and Contrast#

透過 Brightness and Contrast camera feature，您可以調整影像的色調值。

Brightness 和 contrast 始終作為通用數學 Brightness/Contrast 函數的一部分一起處理。

使用此功能#

調整 Contrast 與 Contrast Mode#

若要調整 contrast：

1. 將 BslContrastMode 參數設為下列其中一個值 (（如果可用)：
   • Linear
   • SCurve
2. 為 BslContrast 參數。此參數的數值範圍為 -1 到 1。預設情況下，此參數設為 0，表示 contrast 保持不變。

調整亮度#

若要調整 brightness，請為 BslBrightness 參數輸入數值。此參數的數值範圍為 -1 到 1。預設情況下，此參數設為 0，表示 brightness 保持不變。

運作原理#

對比度#

調整 contrast 會改變影像中明暗區域之間的差異程度。套用的 contrast 越高，差異就越明顯。

如何套用 contrast 取決於您所選取的 contrast mode。

Linear Contrast Mode#

如果選取此 contrast mode，相機將使用 linear function 來調整 contrast。增加或減少 contrast 會增加或減少線性函數的斜率。

當 contrast 設定大於 0 時，會有更多輸出像素值設為全黑 (0) 或全白（最大像素值）。

如果 contrast 設為 0.3（見第二張圖），從 0 到大約 50 的輸入值會設為全黑，而從大約 205 到 255 的輸入值會設為全白。這表示色調值的整體範圍（即影像的動態範圍）縮小了。影像中最暗和最亮的區域會顯示為全黑或全白，但其他區域會顯得更清晰。

減少 contrast 會有相反的效果。

S-Curve Contrast Mode#

如果選取此 contrast mode，相機將使用 S-curve function 來調整 contrast。

這可讓您在保留影像動態範圍的同時，提升感知 contrast。

您越是增加 contrast，函數圖形就會越呈現 S 形：

上圖顯示，在 S-Curve 模式下增加 contrast 會產生以下效果：

• S 形曲線在其起點和終點附近變得更平緩，而在中心附近變得更陡峭。因此，影像明暗區域的 contrast 降低了，而中間色調的 contrast 提高了。
• 低的輸入像素值會降低，高的輸入像素值會提高。因此，影像中極端明暗的區域會被壓縮，進一步提升感知 contrast。
• 由於曲線始於 (0,0) 並終於 (X_max,Y_max)，因此影像的動態範圍得以保留。

在 S-Curve 模式下，低於 0 的 Contrast 設定將導致相反效果的反向 S 形曲線。

亮度#

調整 Brightness 可透過增加或減少色調值來使影像變亮或變暗。

調整 Brightness 會移動 Brightness/Contrast 功能的樞紐點：

• 增加 Brightness 會將樞紐點向左上方移動。這表示影像會顯得更亮。
• 減少 Brightness 會將樞紐點向右下方移動。這表示影像會顯得更暗。

下圖顯示選取 S-Curve contrast mode 的範例。

其他參數#

若適用， BslBrightnessRaw 和 BslContrastRaw 參數允許您為 Brightness 和 Contrast 參數輸入整數值而非浮點數。通常情況下，您不需要設定這些參數。

詳細資料#

顯示所有相機型號

範例程式碼#

// Set the Brightness parameter to 0.5
camera.BslBrightness.SetValue(0.5);
// Set the contrast mode to Linear
camera.BslContrastMode.SetValue(BslContrastMode_Linear);
// Set the Contrast parameter to 1.2
camera.BslContrast.SetValue(1.2);

INodeMap& nodemap = camera.GetNodeMap();
// Set the Brightness parameter to 0.5
CFloatParameter(nodemap, "BslBrightness").SetValue(0.5);
// Set the contrast mode to Linear
CEnumParameter(nodemap, "BslContrastMode").SetValue("Linear");
// Set the Contrast parameter to 1.2
CFloatParameter(nodemap, "BslContrast").SetValue(1.2);

// Set the Brightness parameter to 0.5
camera.Parameters[PLCamera.BslBrightness].SetValue(0.5);
// Set the contrast mode to Linear
camera.Parameters[PLCamera.BslContrastMode].SetValue(PLCamera.BslContrastMode.Linear);
// Set the Contrast parameter to 1.2
camera.Parameters[PLCamera.BslContrast].SetValue(1.2);

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Set the Brightness parameter to 0.5 */
errRes = PylonDeviceSetFloatFeature(hdev, "BslBrightness", 0.5);
CHECK(errRes);
/* Set the contrast mode to Linear */
errRes = PylonDeviceFeatureFromString(hdev, "BslContrastMode", "Linear");
CHECK(errRes);
/* Set the Contrast parameter to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "BslContrast", 1.2);
CHECK(errRes);

# Set the Brightness parameter to 0.5
camera.BslBrightness.Value = 0.5
# Set the contrast mode to Linear
camera.BslContrastMode.Value = "Linear"
# Set the Contrast parameter to 1.2
camera.BslContrast.Value = 1.2

您也可以使用 pylon Viewer 來輕鬆設定參數。