コンテンツにスキップ

Brightness and Contrast#

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

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

機能を使用する#

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

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

  1. パラメーターを BslContrastMode 次のいずれかの値(使用している場合)に設定します
  2. BslContrastパラメーターの値を入力します。パラメーターの値の範囲は-1~1です。デフォルトでは、パラメーターは0に設定され、コントラストは変更されません。

明るさの調整#

明るさを調整するには、BslBrightnessパラメーターの値を入力します。パラメーターの値の範囲は-1~1です。デフォルトでは、このパラメーターは0に設定されており、明るさは変更されません。

仕組み#

Contrast#

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

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

Linear Contrast Mode

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

Contrast = 0, Brightness = 0, Linear Contrast Mode

Contrast = 0.3, Brightness = 0, Linear Contrast Mode

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

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

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

S-Curve Contrast Mode

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

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

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

Contrast = 0.3, Brightness = 0, S-Curve Contrast Mode

Contrast = 0.5, Brightness = 0, S-Curve Contrast Mode

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

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

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

明るさ#

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

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

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

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

Contrast = 0.3, Brightness = 0, S-Curve Contrast Mode

Contrast = 0.3, Brightness = 0.3, S-Curve Contrast Mode

追加パラメーター#

使用可能な場合、BslBrightnessRawおよびBslContrastRawパラメーターを使用して、明るさパラメーターとコントラストパラメーターについて、浮動小数値ではなく整数値を入力できます。通常、これらのパラメーターを設定する必要はありません。

特性#

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

カメラモデル 使用できるコントラストモード
a2A1920-51gcBAS Linear
S-Curve
a2A1920-51gcPRO Linear
S-Curve
a2A1920-51gmBAS Linear
S-Curve
a2A1920-51gmPRO Linear
S-Curve
a2A1920-160ucBAS Linear
S-Curve
a2A1920-160ucPRO Linear
S-Curve
a2A1920-160umBAS Linear
S-Curve
a2A1920-160umPRO Linear
S-Curve
a2A2590-22gcBAS Linear
S-Curve
a2A2590-22gcPRO Linear
S-Curve
a2A2590-22gmBAS Linear
S-Curve
a2A2590-22gmPRO Linear
S-Curve
a2A2590-60ucBAS Linear
S-Curve
a2A2590-60ucPRO Linear
S-Curve
a2A2590-60umBAS Linear
S-Curve
a2A2590-60umPRO Linear
S-Curve
a2A3840-13gcBAS Linear
S-Curve
a2A3840-13gcPRO Linear
S-Curve
a2A3840-13gmBAS Linear
S-Curve
a2A3840-13gmPRO Linear
S-Curve
a2A3840-45ucBAS Linear
S-Curve
a2A3840-45ucPRO Linear
S-Curve
a2A3840-45umBAS Linear
S-Curve
a2A3840-45umPRO Linear
S-Curve
a2A4504-5gcBAS Linear
S-Curve
a2A4504-5gcPRO Linear
S-Curve
a2A4504-5gmBAS Linear
S-Curve
a2A4504-5gmPRO Linear
S-Curve
a2A4504-18ucBAS Linear
S-Curve
a2A4504-18ucPRO Linear
S-Curve
a2A4504-18umBAS Linear
S-Curve
a2A4504-18umPRO Linear
S-Curve
a2A5320-7gcBAS Linear
S-Curve
a2A5320-7gcPRO Linear
S-Curve
a2A5320-7gmBAS Linear
S-Curve
a2A5320-7gmPRO Linear
S-Curve
a2A5320-23ucBAS Linear
S-Curve
a2A5320-23ucPRO Linear
S-Curve
a2A5320-23umBAS Linear
S-Curve
a2A5320-23umPRO Linear
S-Curve
a2A5328-4gcBAS Linear
S-Curve
a2A5328-4gcPRO Linear
S-Curve
a2A5328-4gmBAS Linear
S-Curve
a2A5328-4gmPRO Linear
S-Curve
a2A5328-15ucBAS Linear
S-Curve
a2A5328-15ucPRO Linear
S-Curve
a2A5328-15umBAS Linear
S-Curve
a2A5328-15umPRO Linear
S-Curve
acA640-90gc Brightness and Contrast機能はサポートされていません
acA640-90gm Brightness and Contrast機能はサポートされていません
acA640-90uc Brightness and Contrast機能はサポートされていません
acA640-90um Brightness and Contrast機能はサポートされていません
acA640-120gc Brightness and Contrast機能はサポートされていません
acA640-120gm Brightness and Contrast機能はサポートされていません
acA640-120uc Brightness and Contrast機能はサポートされていません
acA640-120um Brightness and Contrast機能はサポートされていません
acA640-121gm Brightness and Contrast機能はサポートされていません
acA640-300gc Brightness and Contrast機能はサポートされていません
acA640-300gm Brightness and Contrast機能はサポートされていません
acA640-750uc Brightness and Contrast機能はサポートされていません
acA640-750um Brightness and Contrast機能はサポートされていません
acA720-290gc Brightness and Contrast機能はサポートされていません
acA720-290gm Brightness and Contrast機能はサポートされていません
acA720-520uc Brightness and Contrast機能はサポートされていません
acA720-520um Brightness and Contrast機能はサポートされていません
acA780-75gc Brightness and Contrast機能はサポートされていません
acA780-75gm Brightness and Contrast機能はサポートされていません
acA800-200gc Brightness and Contrast機能はサポートされていません
acA800-200gm Brightness and Contrast機能はサポートされていません
acA800-510uc Brightness and Contrast機能はサポートされていません
acA800-510um Brightness and Contrast機能はサポートされていません
acA1280-60gc Brightness and Contrast機能はサポートされていません
acA1280-60gm Brightness and Contrast機能はサポートされていません
acA1300-22gc Brightness and Contrast機能はサポートされていません
acA1300-22gm Brightness and Contrast機能はサポートされていません
acA1300-30gc Brightness and Contrast機能はサポートされていません
acA1300-30gm Brightness and Contrast機能はサポートされていません
acA1300-30uc Brightness and Contrast機能はサポートされていません
acA1300-30um Brightness and Contrast機能はサポートされていません
acA1300-60gc Brightness and Contrast機能はサポートされていません
acA1300-60gm Brightness and Contrast機能はサポートされていません
acA1300-60gmNIR Brightness and Contrast機能はサポートされていません
acA1300-75gc Brightness and Contrast機能はサポートされていません
acA1300-75gm Brightness and Contrast機能はサポートされていません
acA1300-200uc Brightness and Contrast機能はサポートされていません
acA1300-200um Brightness and Contrast機能はサポートされていません
acA1440-73gc Brightness and Contrast機能はサポートされていません
acA1440-73gm Brightness and Contrast機能はサポートされていません
acA1440-220uc Brightness and Contrast機能はサポートされていません
acA1440-220um Brightness and Contrast機能はサポートされていません
acA1600-20gc Brightness and Contrast機能はサポートされていません
acA1600-20gm Brightness and Contrast機能はサポートされていません
acA1600-20uc Brightness and Contrast機能はサポートされていません
acA1600-20um Brightness and Contrast機能はサポートされていません
acA1600-60gc Brightness and Contrast機能はサポートされていません
acA1600-60gm Brightness and Contrast機能はサポートされていません
acA1920-25gc Brightness and Contrast機能はサポートされていません
acA1920-25gm Brightness and Contrast機能はサポートされていません
acA1920-25uc Brightness and Contrast機能はサポートされていません
acA1920-25um Brightness and Contrast機能はサポートされていません
acA1920-40gc Brightness and Contrast機能はサポートされていません
acA1920-40gm Brightness and Contrast機能はサポートされていません
acA1920-40uc Brightness and Contrast機能はサポートされていません
acA1920-40ucMED Linear
S-Curve
acA1920-40um Brightness and Contrast機能はサポートされていません
acA1920-40umMED Linear
S-Curve
acA1920-48gc Brightness and Contrast機能はサポートされていません
acA1920-48gm Brightness and Contrast機能はサポートされていません
acA1920-50gc Brightness and Contrast機能はサポートされていません
acA1920-50gm Brightness and Contrast機能はサポートされていません
acA1920-150uc Brightness and Contrast機能はサポートされていません
acA1920-150um Brightness and Contrast機能はサポートされていません
acA1920-155uc Brightness and Contrast機能はサポートされていません
acA1920-155ucMED Linear
S-Curve
acA1920-155um Brightness and Contrast機能はサポートされていません
acA1920-155umMED Linear
S-Curve
acA2000-50gc Brightness and Contrast機能はサポートされていません
acA2000-50gm Brightness and Contrast機能はサポートされていません
acA2000-50gmNIR Brightness and Contrast機能はサポートされていません
acA2000-165uc Brightness and Contrast機能はサポートされていません
acA2000-165um Brightness and Contrast機能はサポートされていません
acA2000-165umNIR Brightness and Contrast機能はサポートされていません
acA2040-25gc Brightness and Contrast機能はサポートされていません
acA2040-25gm Brightness and Contrast機能はサポートされていません
acA2040-25gmNIR Brightness and Contrast機能はサポートされていません
acA2040-35gc Brightness and Contrast機能はサポートされていません
acA2040-35gm Brightness and Contrast機能はサポートされていません
acA2040-55uc Brightness and Contrast機能はサポートされていません
acA2040-55um Brightness and Contrast機能はサポートされていません
acA2040-90uc Brightness and Contrast機能はサポートされていません
acA2040-90um Brightness and Contrast機能はサポートされていません
acA2040-90umNIR Brightness and Contrast機能はサポートされていません
acA2040-120uc Brightness and Contrast機能はサポートされていません
acA2040-120um Brightness and Contrast機能はサポートされていません
acA2440-20gc Brightness and Contrast機能はサポートされていません
acA2440-20gm Brightness and Contrast機能はサポートされていません
acA2440-35uc Brightness and Contrast機能はサポートされていません
acA2440-35ucMED Linear
S-Curve
acA2440-35um Brightness and Contrast機能はサポートされていません
acA2440-35umMED Linear
S-Curve
acA2440-75uc Brightness and Contrast機能はサポートされていません
acA2440-75ucMED Linear
S-Curve
acA2440-75um Brightness and Contrast機能はサポートされていません
acA2440-75umMED Linear
S-Curve
acA2500-14gc Brightness and Contrast機能はサポートされていません
acA2500-14gm Brightness and Contrast機能はサポートされていません
acA2500-14uc Brightness and Contrast機能はサポートされていません
acA2500-14um Brightness and Contrast機能はサポートされていません
acA2500-20gc Brightness and Contrast機能はサポートされていません
acA2500-20gcMED Linear
S-Curve
acA2500-20gm Brightness and Contrast機能はサポートされていません
acA2500-20gmMED Linear
S-Curve
acA2500-60uc Brightness and Contrast機能はサポートされていません
acA2500-60um Brightness and Contrast機能はサポートされていません
acA3088-16gc Brightness and Contrast機能はサポートされていません
acA3088-16gm Brightness and Contrast機能はサポートされていません
acA3088-57uc Brightness and Contrast機能はサポートされていません
acA3088-57ucMED Linear
S-Curve
acA3088-57um Brightness and Contrast機能はサポートされていません
acA3088-57umMED Linear
S-Curve
acA3800-10gc Brightness and Contrast機能はサポートされていません
acA3800-10gm Brightness and Contrast機能はサポートされていません
acA3800-14uc Brightness and Contrast機能はサポートされていません
acA3800-14um Brightness and Contrast機能はサポートされていません
acA4024-8gc Brightness and Contrast機能はサポートされていません
acA4024-8gm Brightness and Contrast機能はサポートされていません
acA4024-29uc Brightness and Contrast機能はサポートされていません
acA4024-29um Brightness and Contrast機能はサポートされていません
acA4096-11gc Brightness and Contrast機能はサポートされていません
acA4096-11gm Brightness and Contrast機能はサポートされていません
acA4096-30uc Brightness and Contrast機能はサポートされていません
acA4096-30ucMED Linear
S-Curve
acA4096-30um Brightness and Contrast機能はサポートされていません
acA4096-30umMED Linear
S-Curve
acA4096-40uc Brightness and Contrast機能はサポートされていません
acA4096-40ucMED Linear
S-Curve
acA4096-40um Brightness and Contrast機能はサポートされていません
acA4096-40umMED Linear
S-Curve
acA4112-8gc Brightness and Contrast機能はサポートされていません
acA4112-8gm Brightness and Contrast機能はサポートされていません
acA4112-20uc Brightness and Contrast機能はサポートされていません
acA4112-20ucMED Linear
S-Curve
acA4112-20um Brightness and Contrast機能はサポートされていません
acA4112-20umMED Linear
S-Curve
acA4112-30uc Brightness and Contrast機能はサポートされていません
acA4112-30ucMED Linear
S-Curve
acA4112-30um Brightness and Contrast機能はサポートされていません
acA4112-30umMED Linear
S-Curve
acA4600-7gc Brightness and Contrast機能はサポートされていません
acA4600-10uc Brightness and Contrast機能はサポートされていません
acA5472-5gc Brightness and Contrast機能はサポートされていません
acA5472-5gm Brightness and Contrast機能はサポートされていません
acA5472-17uc Brightness and Contrast機能はサポートされていません
acA5472-17ucMED Linear
S-Curve
acA5472-17um Brightness and Contrast機能はサポートされていません
acA5472-17umMED Linear
S-Curve
boA4096-93cc Brightness and Contrast機能はサポートされていません
boA4096-93cm Brightness and Contrast機能はサポートされていません
boA4112-68cc Brightness and Contrast機能はサポートされていません
boA4112-68cm Brightness and Contrast機能はサポートされていません
boA6500-36cm Linear
S-Curve
boA8100-16cm Linear
S-Curve
daA1280-54lc Linear
S-Curve
daA1280-54lm Linear
S-Curve
daA1280-54uc Linear
S-Curve
daA1280-54um Linear
S-Curve
daA1600-60lc Linear
S-Curve
daA1600-60lm Linear
S-Curve
daA1600-60uc Linear
S-Curve
daA1600-60um Linear
S-Curve
daA1920-15um Linear
S-Curve
daA1920-30uc Linear
S-Curve
daA1920-30um Linear
S-Curve
daA1920-160uc Linear
S-Curve
daA1920-160um Linear
S-Curve
daA2500-14lc Linear
S-Curve
daA2500-14lm Linear
S-Curve
daA2500-14uc Linear
S-Curve
daA2500-14um Linear
S-Curve
puA1280-54uc Linear
S-Curve
puA1280-54um Linear
S-Curve
puA1600-60uc Linear
S-Curve
puA1600-60um Linear
S-Curve
puA1920-30uc Linear
S-Curve
puA1920-30um Linear
S-Curve
puA2500-14uc Linear
S-Curve
puA2500-14um Linear
S-Curve

サンプルコード#

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

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。