Brightness and Contrast#

Brightness and Contrast カメラ機能を使用すると、画像の色調値を調整できます。

明るさとコントラストは、常に共通の数学的Brightness/Contrast機能の一部として一緒に処理されます。

機能を使用する#

コントラストの調整とコントラストモード#

コントラストを調整するには、次の手順に従います。

1. パラメーターを BslContrastMode 次のいずれかの値（使用している場合）に設定します：
   • Linear
   • SCurve
2. Enter a value for the BslContrast parameter. The parameter's value range is from -1 to 1. By default, the parameter is set to 0 which means that the contrast remains unchanged.

明るさの調整#

To adjust the brightness, enter a value for the BslBrightness parameter. The parameter's value range is from -1 to 1. By default, the parameter is set to 0 which means that the brightness remains unchanged.

仕組み#

Contrast#

コントラストを調整すると、画像の明るい領域と暗い領域の差の度合いが変わります。適用するコントラストが大きいほど、違いがはっきりします。

コントラストの適用方法は、選択したコントラストモードによって異なります。

Linear Contrast Mode#

このコントラストモードを選択すると、カメラは一次関数を使用してコントラストを調整します。コントラストを増減すると、一次関数のグラデーションが増減します。

コントラスト設定が0より大きい場合、出力ピクセル値は完全な黒（0）または完全な白（最大ピクセル値）に設定されます。

コントラストが0.3に設定されている場合（2番目の図を参照）、0～50の入力値が完全な黒に設定され、約205～255の入力値が完全な白に設定されます。つまり、画像のダイナミックレンジである色調値の全体的な範囲が縮小されます。画像の最も暗い領域と最も明るい領域は、完全に黒または完全に白で表示されますが、他の領域はより明確に表示されます。

コントラストを下げると、逆の効果があります。

S-Curve Contrast Mode#

このコントラストモードを選択すると、カメラは、S字カーブ関数を使用してコントラストを調整します。

これにより、画像のダイナミックレンジを維持しながら、知覚されるコントラストを向上させることができます。

コントラストを高くするにつれ、機能のグラフのS字形は次のようになります。

上の図は、S-Curveモードでコントラストを上げると、次のような効果があることを示しています。

• S字曲線では、開始点と終了点あたりで平坦になり、中央あたりが急勾配になります。その結果、画像の明るい部分と暗い部分のコントラストが低減し、中間調のコントラストが増加します。
• 低入力ピクセル値が小さくなり、高入力ピクセル値が大きくなります。その結果、画像の極端な暗い部分と明るい部分が圧縮され、コントラストがさらに向上します。
• 曲線は常に（0,0）から開始し、（X_max,Y_max）で終了するため、画像のダイナミックレンジは保持されます。

S-Curveモードで0より低いコントラスト設定を行うと、逆効果の反転Sカーブが生成されます。

明るさ#

明るさを調整すると、色調値を増減して画像を明るくしたり暗くしたりできます。

明るさを調整すると、Brightness/Contrast機能の中心点が移動します。

• 明るさを上げると、中心点が左上に移動します。これは、画像が明るく表示されることを意味します。
• 明るさを下げると、中心点が右下に移動します。これは、画像が暗く表示されることを意味します。

以下の図は、S-Curveコントラストモードを選択した場合の例を示します。

追加パラメーター#

If available, the BslBrightnessRaw and BslContrastRaw parameters allow you to enter integer values instead of float values for the brightness and contrast parameters. Normally, you don't need to set these parameters.

特性#

すべてのカメラモデルを表示します

サンプルコード#

// 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を使用して、パラメーターを簡単に設定することもできます。