Brightness and Contrast#

「Brightness and Contrast 」相機功能可讓您調整影像的色調值。

Brightness 和 Contrast 始終作為共同數學 Brightness/Contrast 函數的一部分一起處理。

使用功能#

調整對比度與對比度模式#

要調整對比度：

1. 將相機中的 BslContrastMode 將參數設為下列其中一個值（若適用）：
   • Linear
   • SCurve
2. 為 BslContrast 參數。該參數的值範圍從 -1 到 1。預設情況下，該參數設定為 0，這表示對比度保持不變。

調整 Brightness#

若要調整亮度，請輸入以下項目的值： BslBrightness 參數。該參數的值範圍從 -1 到 1。預設情況下，該參數設定為 0，這表示亮度保持不變。

運作原理#

對比度#

調整對比度會改變影像中明亮區域與黑暗區域之間的差異程度。您套用的對比度越高，差異就會越明顯。

對比度的應用方式取決於您所選的對比度模式。

線性對比模式#

若選取此對比度模式，相機將使用線性函數來調整對比度。增加或減少對比度，即會增加或減少該線性函數的斜率。

當對比度設定值大於 0 時，會有更多輸出像素值被設定為完全黑色（0）或完全白色（最大像素值）。

若將對比度設定為 0.3（參見第二張圖），輸入值介於 0 至約 50 之間的範圍將被設定為完全黑色，而輸入值介於約 205 至 255 之間的範圍則被設定為完全白色。這意味著整體色調值範圍（即影像的動態範圍）將被縮小。 影像中最暗和最亮的區域將呈現完全黑色或完全白色，但其餘區域則會顯得更為清晰。

降低對比度則會產生相反的效果。

S 型曲線對比模式#

若選取此對比度模式，相機將使用S 型曲線函數來調整對比度。

這可讓您在保留影像動態範圍的同時，改善感官對比度。

您增加對比度越多，函數圖形就會越呈現 S 形：

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

• S 曲線在其起點和終點附近變得更平緩，而在中心附近變得更陡峭。因此，影像明亮和黑暗區域的對比度會降低，而中間色調的對比度會增加。
• 低的輸入像素值會降低，高的輸入像素值會增加。因此，影像中極端黑暗和明亮的區域會被壓縮，這進一步改善了感官對比度。
• 由於曲線總是從 (0,0) 開始並在 (X_max,Y_max) 結束，因此影像的動態範圍得以保留。

在 S-Curve 模式下，低於 0 的對比度設定將導致產生相反效果的反向 S 曲線。

亮度#

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

調整亮度會移動 Brightness/Contrast 函數的樞紐點：

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

下圖所示為選取「S 曲線」對比模式時的範例。

其他參數#

如果可用， BslBrightnessRaw 進行明確的生命週期管理即呼叫 BslContrastRaw 這些參數允許您為亮度與對比度參數輸入整數值，而非浮點數值。通常，您無需設定這些參數。

詳細資料#

顯示所有相機型號

範例程式碼#

// 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

您也可以 use the pylon Viewer 來輕鬆設定參數。