コンテンツにスキップ

Gamma#

Gammaカメラ機能を使用すると、取得した画像の明るさを最適化してモニタに表示できます。

機能を使用する#

仕組み#

カメラは、次の式(例として示すカラーカメラの赤のピクセル値(R))に従って、各画素の明るさの値にガンマ補正値(γ)を適用します。

Gamma補正式(赤のピクセル)

最大ピクセル値(Rmax)は、例えば、8ビットピクセルフォーマットの場合は255、10ビットピクセルフォーマットの場合は1023に等しくなります。

Gamma補正の有効化#

ガンマ補正を有効にするには、次の手順に従います。

  1. GammaEnableパラメーターをtrueに設定します(使用可能な場合)。
  2. 最良の結果を得るには、BlackLevelパラメーターを0に設定します。
  3. パラメーターを Gamma パラメーターを必要な値に設定します。パラメーター値の範囲は0~約4です。
    • Gamma = 1:全体の明るさに変化はありません
    • Gamma < 1: The overall brightness increases.
    • Gamma > 1:全体の明るさが下がります

いずれの場合も、黒のピクセル(明るさ = 0)と白のピクセル(明るさ = 最大)は調整されません。

情報

  • ガンマ補正を有効にし、ピクセルフォーマットを12ビットピクセルフォーマットに設定すると、一部の画像情報が失われます。ピクセルデータ出力は12ビットのままですが、ガンマ補正処理中にピクセル値が補間されます。
  • On boA13440-17cm cameras, gamma correction can only be enabled, if the pixel format is set to an 8-bit pixel format.

追加パラメーター#

カメラのモデルに応じて、次の追加パラメーターを使用できます。

  • GammaEnable:ガンマ補正を有効または無効にします。
  • Gammaセレクター:次のいずれかのガンマ補正モードを選択できます。
    • User:ガンマ補正値を必要に応じて設定できます。(デフォルト)
    • sRGB:カメラは自動的にガンマ補正値を約0.4に設定します。この値は、sRGBモニターでの画像表示用に最適化されます。
  • BslColorSpaceMode または BslColorSpace:次のいずれかのガンマ補正モードを選択できます。
    • RGB:追加のガンマ補正値は適用されません。
    • sRGB:画像の輝度はsRGBモニターでの表示用に最適化されています。ガンマ補正値約0.4が適用されます。詳細については、「詳細」セクションの脚注を参照してください。

特性#

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

カメラモデル 追加パラメーター
a2A640-240gmSWIR None
a2A640-240umSWIR None
a2A1280-80gmSWIR None
a2A1280-125umSWIR None
a2A1920-51gcBAS BslColorSpacec
a2A1920-51gcPRO BslColorSpacec
a2A1920-51gmBAS None
a2A1920-51gmPRO None
a2A1920-160ucBAS BslColorSpacec
a2A1920-160ucPRO BslColorSpacec
a2A1920-160umBAS None
a2A1920-160umPRO None
a2A1920-165g5cBAS BslColorSpacec
a2A1920-165g5mBAS None
a2A2048-35gmSWIR None
a2A2048-37gcBAS BslColorSpacec
a2A2048-37gcPRO BslColorSpacec
a2A2048-37gmBAS None
a2A2048-37gmPRO None
a2A2048-110umSWIR None
a2A2048-114g5cBAS BslColorSpacec
a2A2048-114g5mBAS None
a2A2048-114ucBAS BslColorSpacec
a2A2048-114ucPRO BslColorSpacec
a2A2048-114umBAS None
a2A2048-114umPRO None
a2A2440-98g5cBAS BslColorSpacec
a2A2440-98g5mBAS None
a2A2448-23gcBAS BslColorSpacec
a2A2448-23gcPRO BslColorSpacec
a2A2448-23gmBAS None
a2A2448-23gmPRO None
a2A2448-75ucBAS BslColorSpacec
a2A2448-75ucPRO BslColorSpacec
a2A2448-75umBAS None
a2A2448-75umPRO None
a2A2448-105g5cBAS BslColorSpacec
a2A2448-105g5mBAS None
a2A2448-120cc BslColorSpacec
a2A2448-120cm None
a2A2448-210cc BslColorSpacec
a2A2448-210cm None
a2A2560-20gmSWIR None
a2A2560-70umSWIR None
a2A2590-22gcBAS BslColorSpacec
a2A2590-22gcPRO BslColorSpacec
a2A2590-22gmBAS None
a2A2590-22gmPRO None
a2A2590-60ucBAS BslColorSpacec
a2A2590-60ucPRO BslColorSpacec
a2A2590-60umBAS None
a2A2590-60umPRO None
a2A2600-20gcBAS BslColorSpacec
a2A2600-20gcPRO BslColorSpacec
a2A2600-20gmBAS None
a2A2600-20gmPRO None
a2A2600-64ucBAS BslColorSpacec
a2A2600-64ucPRO BslColorSpacec
a2A2600-64umBAS None
a2A2600-64umPRO None
a2A2840-14gcBAS BslColorSpacec
a2A2840-14gcPRO BslColorSpacec
a2A2840-14gmBAS None
a2A2840-14gmPRO None
a2A2840-14gmUV None
a2A2840-48ucBAS BslColorSpacec
a2A2840-48ucPRO BslColorSpacec
a2A2840-48umBAS None
a2A2840-48umPRO None
a2A2840-48umUV None
a2A2840-67g5cBAS BslColorSpacec
a2A2840-67g5mBAS None
a2A2840-67g5mUV None
a2A2840-86cc BslColorSpacec
a2A2840-86cm None
a2A3536-9gcBAS BslColorSpacec
a2A3536-9gcPRO BslColorSpacec
a2A3536-9gmBAS None
a2A3536-9gmPRO None
a2A3536-31ucBAS BslColorSpacec
a2A3536-31ucPRO BslColorSpacec
a2A3536-31umBAS None
a2A3536-31umPRO None
a2A3536-42g5cBAS BslColorSpacec
a2A3536-42g5mBAS None
a2A3840-13gcBAS BslColorSpacec
a2A3840-13gcPRO BslColorSpacec
a2A3840-13gmBAS None
a2A3840-13gmPRO None
a2A3840-45ucBAS BslColorSpacec
a2A3840-45ucPRO BslColorSpacec
a2A3840-45umBAS None
a2A3840-45umPRO None
a2A4096-9gcBAS BslColorSpacec
a2A4096-9gcPRO BslColorSpacec
a2A4096-9gmBAS None
a2A4096-9gmPRO None
a2A4096-30ucBAS BslColorSpacec
a2A4096-30ucPRO BslColorSpacec
a2A4096-30umBAS None
a2A4096-30umPRO None
a2A4096-44g5cBAS BslColorSpacec
a2A4096-44g5mBAS None
a2A4096-67cc BslColorSpacec
a2A4096-67cm None
a2A4200-12gcBAS BslColorSpacec
a2A4200-12gcPRO BslColorSpacec
a2A4200-12gmBAS None
a2A4200-12gmPRO None
a2A4200-40ucBAS BslColorSpacec
a2A4200-40ucPRO BslColorSpacec
a2A4200-40umBAS None
a2A4200-40umPRO None
a2A4504-5gcBAS BslColorSpacec
a2A4504-5gcPRO BslColorSpacec
a2A4504-5gmBAS None
a2A4504-5gmPRO None
a2A4504-18ucBAS BslColorSpacec
a2A4504-18ucPRO BslColorSpacec
a2A4504-18umBAS None
a2A4504-18umPRO None
a2A4504-27g5cBAS BslColorSpacec
a2A4504-27g5mBAS None
a2A4504-42cc BslColorSpacec
a2A4504-42cm None
a2A4508-6gcBAS BslColorSpacec
a2A4508-6gcPRO BslColorSpacec
a2A4508-6gmBAS None
a2A4508-6gmPRO None
a2A4508-20ucBAS BslColorSpacec
a2A4508-20ucPRO BslColorSpacec
a2A4508-20umBAS None
a2A4508-20umPRO None
a2A5060-4gcBAS BslColorSpacec
a2A5060-4gmBAS None
a2A5060-15ucBAS BslColorSpacec
a2A5060-15umBAS None
a2A5060-21g5cBAS BslColorSpacec
a2A5060-21g5mBAS None
a2A5320-7gcBAS BslColorSpacec
a2A5320-7gcPRO BslColorSpacec
a2A5320-7gmBAS None
a2A5320-7gmPRO None
a2A5320-23ucBAS BslColorSpacec
a2A5320-23ucPRO BslColorSpacec
a2A5320-23umBAS None
a2A5320-23umPRO None
a2A5320-34g5cBAS BslColorSpacec
a2A5320-34g5mBAS None
a2A5320-52cc BslColorSpacec
a2A5320-52cm None
a2A5328-4gcBAS BslColorSpacec
a2A5328-4gcPRO BslColorSpacec
a2A5328-4gmBAS None
a2A5328-4gmPRO None
a2A5328-15ucBAS BslColorSpacec
a2A5328-15ucPRO BslColorSpacec
a2A5328-15umBAS None
a2A5328-15umPRO None
a2A5328-22g5cBAS BslColorSpacec
a2A5328-22g5mBAS None
a2A5328-35cc BslColorSpacec
a2A5328-35cm None
acA640-121gm GammaEnable
GammaSelector
acA640-300gc GammaEnable
GammaSelector
acA640-300gm GammaEnable
GammaSelector
acA640-750uc Nonea
acA640-750um Nonea
acA720-290gc GammaEnable
GammaSelector
acA720-290gm GammaEnable
GammaSelector
acA720-520uc Nonea
acA720-520um Nonea
acA800-200gc GammaEnable
GammaSelector
acA800-200gm GammaEnable
GammaSelector
acA800-510uc Nonea
acA800-510um Nonea
acA1280-60gc GammaEnable
GammaSelector
acA1280-60gm GammaEnable
GammaSelector
acA1300-60gc GammaEnable
GammaSelector
acA1300-60gm GammaEnable
GammaSelector
acA1300-60gmNIR GammaEnable
GammaSelector
acA1300-75gc GammaEnable
GammaSelector
acA1300-75gm GammaEnable
GammaSelector
acA1300-200uc Nonea
acA1300-200um Nonea
acA1440-73gc GammaEnable
GammaSelector
acA1440-73gm GammaEnable
GammaSelector
acA1440-220uc Nonea
acA1440-220um Nonea
acA1600-20gc GammaEnable
GammaSelector
acA1600-20uc Nonea
acA1600-60gc GammaEnable
GammaSelector
acA1600-60gm GammaEnable
GammaSelector
acA1920-25gc GammaEnable
GammaSelector
acA1920-25gm GammaEnable
GammaSelector
acA1920-25uc Nonea
acA1920-25um Nonea
acA1920-40gc GammaEnable
GammaSelector
acA1920-40gm GammaEnable
GammaSelector
acA1920-40uc Nonea
acA1920-40ucMED Nonea
acA1920-40um Nonea
acA1920-40umMED Nonea
acA1920-48gc GammaEnable
GammaSelector
acA1920-48gm GammaEnable
GammaSelector
acA1920-50gc GammaEnable
GammaSelector
acA1920-50gm GammaEnable
GammaSelector
acA1920-150uc Nonea
acA1920-150um Nonea
acA1920-155uc Nonea
acA1920-155ucMED Nonea
acA1920-155um Nonea
acA1920-155umMED Nonea
acA2000-50gc GammaEnable
GammaSelector
acA2000-50gm GammaEnable
GammaSelector
acA2000-165uc Nonea
acA2000-165um Nonea
acA2040-25gc GammaEnable
GammaSelector
acA2040-25gm GammaEnable
GammaSelector
acA2040-25gmNIR GammaEnable
GammaSelector
acA2040-35gc GammaEnable
GammaSelector
acA2040-35gm GammaEnable
GammaSelector
acA2040-55uc Nonea
acA2040-55um Nonea
acA2040-90uc Nonea
acA2040-90um Nonea
acA2040-90umNIR Nonea
acA2040-120uc Nonea
acA2040-120um Nonea
acA2440-20gc GammaEnable
GammaSelector
acA2440-20gm GammaEnable
GammaSelector
acA2440-35uc Nonea
acA2440-35ucMED Nonea
acA2440-35um Nonea
acA2440-35umMED Nonea
acA2440-75uc Nonea
acA2440-75ucMED Nonea
acA2440-75um Nonea
acA2440-75umMED Nonea
acA2500-14gc GammaEnable
GammaSelector
acA2500-14gm GammaEnable
GammaSelector
acA2500-14uc Nonea
acA2500-14um Nonea
acA2500-20gc GammaEnable
GammaSelector
acA2500-20gcMED GammaEnable
GammaSelector
acA2500-20gm GammaEnable
GammaSelector
acA2500-20gmMED GammaEnable
GammaSelector
acA2500-60uc Nonea
acA2500-60um Nonea
acA3088-16gc GammaEnable
GammaSelector
acA3088-16gm GammaEnable
GammaSelector
acA3088-57uc Nonea
acA3088-57ucMED Nonea
acA3088-57um Nonea
acA3088-57umMED Nonea
acA3800-10gc GammaEnable
GammaSelector
acA3800-10gm GammaEnable
GammaSelector
acA3800-14uc Nonea
acA3800-14um Nonea
acA4024-8gc GammaEnable
GammaSelector
acA4024-8gm GammaEnable
GammaSelector
acA4024-29uc Nonea
acA4024-29um Nonea
acA4096-11gc GammaEnable
GammaSelector
acA4096-11gm GammaEnable
GammaSelector
acA4096-30uc Nonea
acA4096-30ucMED Nonea
acA4096-30um Nonea
acA4096-30umMED Nonea
acA4096-40uc Nonea
acA4096-40ucMED Nonea
acA4096-40um Nonea
acA4096-40umMED Nonea
acA4112-8gc GammaEnable
GammaSelector
acA4112-8gm GammaEnable
GammaSelector
acA4112-20uc Nonea
acA4112-20ucMED Nonea
acA4112-20um Nonea
acA4112-20umMED Nonea
acA4112-30uc Nonea
acA4112-30ucMED Nonea
acA4112-30um Nonea
acA4112-30umMED Nonea
acA5472-5gc GammaEnable
GammaSelector
acA5472-5gm GammaEnable
GammaSelector
acA5472-17uc Nonea
acA5472-17ucMED Nonea
acA5472-17um Nonea
acA5472-17umMED Nonea
boA1936-400cc BslColorSpacec
boA1936-400cm None
boA2448-250cc BslColorSpacec
boA2448-250cm None
boA2832-190cc BslColorSpacec
boA2832-190cm None
boA4096-93cc BslColorSpacec
boA4096-93cm None
boA4096-180cc BslColorSpacec
boA4096-180cm None
boA4112-68cc BslColorSpacec
boA4112-68cm None
boA4500-45cc BslColorSpacec
boA4500-45cm None
boA4504-100cc BslColorSpacec
boA4504-100cm None
boA5120-150cc Gamma機能はサポートされていません
boA5120-150cm Gamma機能はサポートされていません
boA5120-230cc Gamma機能はサポートされていません
boA5120-230cm Gamma機能はサポートされていません
boA5320-150cc BslColorSpacec
boA5320-150cm None
boA5328-100cc BslColorSpacec
boA5328-100cm None
boA6500-36cc BslColorSpacec
boA6500-36cm None
boA8100-16cc BslColorSpacec
boA8100-16cm None
boA9344-30cc Gamma機能はサポートされていません
boA9344-30cm Gamma機能はサポートされていません
boA9344-70cc Gamma機能はサポートされていません
boA9344-70cm Gamma機能はサポートされていません
boA13440-17cm None
daA720-520uc BslColorSpacea
daA720-520um None
daA1280-54uc BslColorSpaceModeb
daA1280-54um None
daA1440-220uc BslColorSpacea
daA1440-220um None
daA1600-60uc BslColorSpaceModeb
daA1600-60um None
daA1920-15um None
daA1920-30uc BslColorSpaceModeb
daA1920-30um None
daA1920-160uc BslColorSpacea
daA1920-160um None
daA2448-70uc BslColorSpacea
daA2448-70um None
daA2500-14uc BslColorSpaceModeb
daA2500-14um None
daA3840-45uc BslColorSpacea
daA3840-45um None
dmA720-290gc BslColorSpacec
dmA720-290gm None
dmA1440-73gc BslColorSpacec
dmA1440-73gm None
dmA1920-51gc BslColorSpacec
dmA1920-51gm None
dmA2048-37gc BslColorSpacec
dmA2048-37gm None
dmA2448-23gc BslColorSpacec
dmA2448-23gm None
dmA2840-14gc BslColorSpacec
dmA2840-14gm None
dmA3536-9gc BslColorSpacec
dmA3536-9gm None
dmA4096-9gc BslColorSpacec
dmA4096-9gm None
puA1280-54uc BslColorSpaceModeb
puA1280-54um None
puA1600-60uc BslColorSpaceModeb
puA1600-60um None
puA1920-30uc BslColorSpaceModeb
puA1920-30um None
puA2500-14uc BslColorSpaceModeb
puA2500-14um None
r2L2048-29gc BslColorSpacec
r2L2048-58gm None
r2L2048-62cc BslColorSpacec
r2L2048-62g5c BslColorSpacec
r2L2048-172cm None
r2L2048-172g5m None
r2L4096-14gc BslColorSpacec
r2L4096-29gm None
r2L4096-42cc BslColorSpacec
r2L4096-42g5c BslColorSpacec
r2L4096-84cm None
r2L4096-84g5m None
r2L8192-200cm None
r2L16384-120cm None

  1. 光源の初期値を選択すると、約0.4の追加ガンマ補正値(sRGBガンマ補正)が適用されます。この値は個別に適用され、Gammaパラメーター値には含まれません。Example:光源の初期値をタングステンに設定し、Gammaパラメーター値を1.2に設定したとします。まず、ピクセル値に約0.4の自動補正値が適用されます。その後、ガンマ補正値1.2が結果のピクセル値に適用されます。

  2. ピクセルフォーマットがYCbCr422またはRGB8に設定されている場合にのみ使用できます。

  3. カラースペースがsRGBに設定されている場合は、ガンマ補正値約0.4が適用されます。この値は個別に適用され、Gammaパラメーター値には含まれません。Example:カラースペースをsRGBに設定し、Gammaパラメーターを1.2に設定したとます。まず、ピクセル値に約0.4の自動補正値が適用されます。その後、ガンマ補正値1.2が結果のピクセル値に適用されます。
    Light Source Presetを選択した場合、カラースペースをsRGBに設定すると、Balance WhiteColor Adjustment、およびColor Transformationの各機能にも影響します。

  4. カラースペースがsRGBに設定されている場合、ガンマ補正値が約0.4に適用され、Gammaパラメーターは読み取り専用になり、Gammaパラメーター値は無視されます。

サンプルコード#

ace 2, boost, and dart R Cameras#
// Set the Gamma value to 1.2
camera.Gamma.SetValue(1.2);
// Set the color space to sRGB
camera.BslColorSpace.SetValue(BslColorSpace_sRGB);
INodeMap& nodemap = camera.GetNodeMap();
// Set the Gamma value to 1.2
CFloatParameter(nodemap, "Gamma").SetValue(1.2);
// Set the color space to sRGB
CEnumParameter(nodemap, "BslColorSpace").SetValue("sRGB");
// Set the Gamma value to 1.2
camera.Parameters[PLCamera.Gamma].SetValue(1.2);
// Set the color space to sRGB
camera.Parameters[PLCamera.BslColorSpace].SetValue(PLCamera.BslColorSpace.sRGB);
/* 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 Gamma value to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "Gamma", 1.2);
CHECK(errRes);
/* Set the color space to sRGB */
errRes = PylonDeviceFeatureFromString(hdev, "BslColorSpace", "sRGB");
CHECK(errRes);
# Set the Gamma value to 1.2
camera.Gamma.Value = 1.2
# Set the color space to sRGB
camera.BslColorSpace.Value = "sRGB"
ace Classic/U/L GigEカメラ#
// Enable the Gamma feature
camera.GammaEnable.SetValue(true);
// Set the gamma type to User
camera.GammaSelector.SetValue(GammaSelector_User);
// Set the Gamma value to 1.2
camera.Gamma.SetValue(1.2);
INodeMap& nodemap = camera.GetNodeMap();
// Enable the Gamma feature
CBooleanParameter(nodemap, "GammaEnable").SetValue(true);
// Set the gamma type to User
CEnumParameter(nodemap, "GammaSelector").SetValue("User");
// Set the Gamma value to 1.2
CFloatParameter(nodemap, "Gamma").SetValue(1.2);
// Enable the Gamma feature
camera.Parameters[PLCamera.GammaEnable].SetValue(true);
// Set the gamma type to User
camera.Parameters[PLCamera.GammaSelector].SetValue(PLCamera.GammaSelector.User);
// Set the Gamma value to 1.2
camera.Parameters[PLCamera.Gamma].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 */
/* Enable the Gamma feature */
errRes = PylonDeviceSetBooleanFeature(hdev, "GammaEnable", 1);
CHECK(errRes);
/* Set the gamma type to User */
errRes = PylonDeviceFeatureFromString(hdev, "GammaSelector", "User");
CHECK(errRes);
/* Set the Gamma value to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "Gamma", 1.2);
CHECK(errRes);
# Enable the Gamma feature
camera.GammaEnable.Value = True
# Set the gamma type to User
camera.GammaSelector.Value = "User"
# Set the Gamma value to 1.2
camera.Gamma.Value = 1.2
その他のカメラ#
// Set the Gamma value to 1.2
camera.Gamma.SetValue(1.2);
INodeMap& nodemap = camera.GetNodeMap();
// Set the Gamma value to 1.2
CFloatParameter(nodemap, "Gamma").SetValue(1.2);
// Set the Gamma value to 1.2
camera.Parameters[PLCamera.Gamma].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 Gamma value to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "Gamma", 1.2);
CHECK(errRes);
# Set the Gamma value to 1.2
camera.Gamma.Value = 1.2

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