コンテンツにスキップ

Brightness and Contrast#

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

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

機能を使用する#

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

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

  1. パラメーターを BslContrastMode 次のいずれかの値（使用している場合）に設定します：
  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#

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

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

追加パラメーター#

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.

特性#

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

カメラモデル 使用できるコントラストモード
a2A640-240gmSWIR Linear
S-Curve
a2A640-240umSWIR Linear
S-Curve
a2A1280-80gmSWIR Linear
S-Curve
a2A1280-125umSWIR Linear
S-Curve
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
a2A1920-165g5cBAS Linear
S-Curve
a2A1920-165g5mBAS Linear
S-Curve
a2A2440-98g5cBAS Linear
S-Curve
a2A2440-98g5mBAS Linear
S-Curve
a2A2448-23gcBAS Linear
S-Curve
a2A2448-23gcPRO Linear
S-Curve
a2A2448-23gmBAS Linear
S-Curve
a2A2448-23gmPRO Linear
S-Curve
a2A2448-75ucBAS Linear
S-Curve
a2A2448-75ucPRO Linear
S-Curve
a2A2448-75umBAS Linear
S-Curve
a2A2448-75umPRO Linear
S-Curve
a2A2448-105g5cBAS Linear
S-Curve
a2A2448-105g5mBAS Linear
S-Curve
a2A2448-120cc Linear
S-Curve
a2A2448-120cm Linear
S-Curve
a2A2448-210cc Linear
S-Curve
a2A2448-210cm 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
a2A2600-20gcBAS Linear
S-Curve
a2A2600-20gcPRO Linear
S-Curve
a2A2600-20gmBAS Linear
S-Curve
a2A2600-20gmPRO Linear
S-Curve
a2A2600-64ucBAS Linear
S-Curve
a2A2600-64ucPRO Linear
S-Curve
a2A2600-64umBAS Linear
S-Curve
a2A2600-64umPRO Linear
S-Curve
a2A2840-14gcBAS Linear
S-Curve
a2A2840-14gcPRO Linear
S-Curve
a2A2840-14gmBAS Linear
S-Curve
a2A2840-14gmPRO Linear
S-Curve
a2A2840-14gmUV Linear
S-Curve
a2A2840-48ucBAS Linear
S-Curve
a2A2840-48ucPRO Linear
S-Curve
a2A2840-48umBAS Linear
S-Curve
a2A2840-48umPRO Linear
S-Curve
a2A2840-48umUV Linear
S-Curve
a2A2840-67g5cBAS Linear
S-Curve
a2A2840-67g5mBAS Linear
S-Curve
a2A2840-67g5mUV Linear
S-Curve
a2A2840-86cc Linear
S-Curve
a2A2840-86cm 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
a2A4096-9gcBAS Linear
S-Curve
a2A4096-9gcPRO Linear
S-Curve
a2A4096-9gmBAS Linear
S-Curve
a2A4096-9gmPRO Linear
S-Curve
a2A4096-30ucBAS Linear
S-Curve
a2A4096-30ucPRO Linear
S-Curve
a2A4096-30umBAS Linear
S-Curve
a2A4096-30umPRO Linear
S-Curve
a2A4096-44g5cBAS Linear
S-Curve
a2A4096-44g5mBAS Linear
S-Curve
a2A4096-67cc Linear
S-Curve
a2A4096-67cm Linear
S-Curve
a2A4200-12gcBAS Linear
S-Curve
a2A4200-12gcPRO Linear
S-Curve
a2A4200-12gmBAS Linear
S-Curve
a2A4200-12gmPRO Linear
S-Curve
a2A4200-40ucBAS Linear
S-Curve
a2A4200-40ucPRO Linear
S-Curve
a2A4200-40umBAS Linear
S-Curve
a2A4200-40umPRO 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
a2A4504-27g5cBAS Linear
S-Curve
a2A4504-27g5mBAS Linear
S-Curve
a2A4504-42cc Linear
S-Curve
a2A4504-42cm Linear
S-Curve
a2A4508-6gcBAS Linear
S-Curve
a2A4508-6gcPRO Linear
S-Curve
a2A4508-6gmBAS Linear
S-Curve
a2A4508-6gmPRO Linear
S-Curve
a2A4508-20ucBAS Linear
S-Curve
a2A4508-20ucPRO Linear
S-Curve
a2A4508-20umBAS Linear
S-Curve
a2A4508-20umPRO 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
a2A5320-34g5cBAS Linear
S-Curve
a2A5320-34g5mBAS Linear
S-Curve
a2A5320-52cc Linear
S-Curve
a2A5320-52cm 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
a2A5328-22g5cBAS Linear
S-Curve
a2A5328-22g5mBAS Linear
S-Curve
a2A5328-35cc Linear
S-Curve
a2A5328-35cm Linear
S-Curve
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機能はサポートされていません
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-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-20uc 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-165uc Brightness and Contrast機能はサポートされていません
acA2000-165um 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
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
boA1936-400cc Linear
S-Curve
boA1936-400cm Linear
S-Curve
boA2448-250cc Linear
S-Curve
boA2448-250cm Linear
S-Curve
boA2832-190cc Linear
S-Curve
boA2832-190cm Linear
S-Curve
boA4096-93cc Linear
S-Curve
boA4096-93cm Linear
S-Curve
boA4096-180cc Linear
S-Curve
boA4096-180cm Linear
S-Curve
boA4112-68cc Linear
S-Curve
boA4112-68cm Linear
S-Curve
boA4500-45cc Linear
S-Curve
boA4500-45cm Linear
S-Curve
boA4504-100cc Linear
S-Curve
boA4504-100cm Linear
S-Curve
boA5120-150cc Brightness and Contrast機能はサポートされていません
boA5120-150cm Brightness and Contrast機能はサポートされていません
boA5120-230cc Brightness and Contrast機能はサポートされていません
boA5120-230cm Brightness and Contrast機能はサポートされていません
boA5320-150cc Linear
S-Curve
boA5320-150cm Linear
S-Curve
boA5328-100cc Linear
S-Curve
boA5328-100cm Linear
S-Curve
boA6500-36cc Linear
S-Curve
boA6500-36cm Linear
S-Curve
boA8100-16cc Linear
S-Curve
boA8100-16cm Linear
S-Curve
boA9344-30cc Brightness and Contrast機能はサポートされていません
boA9344-30cm Brightness and Contrast機能はサポートされていません
boA9344-70cc Brightness and Contrast機能はサポートされていません
boA9344-70cm Brightness and Contrast機能はサポートされていません
boA13440-17cm Brightness and Contrast機能はサポートされていません
daA720-520uc Linear
S-Curve
daA720-520um Linear
S-Curve
daA1280-54uc Linear
S-Curve
daA1280-54um Linear
S-Curve
daA1440-220uc Linear
S-Curve
daA1440-220um 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
daA2448-70uc Linear
S-Curve
daA2448-70um Linear
S-Curve
daA2500-14uc Linear
S-Curve
daA2500-14um Linear
S-Curve
daA3840-45uc Linear
S-Curve
daA3840-45um 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);

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