コンテンツにスキップ

Gamma#

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

機能を使用する#

仕組み#

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

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

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

Gamma補正の有効化#

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

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

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

情報

ガンマ補正を有効にし、ピクセルフォーマットを12ビットピクセルフォーマットに設定すると、一部の画像情報が失われます。ピクセルデータ出力は12ビットのままですが、ガンマ補正処理中にピクセル値が補間されます。

追加パラメーター#

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

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

特性#

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

カメラモデル 追加パラメーター
a2A1920-51gcBAS BslColorSpacec
a2A1920-51gcPRO BslColorSpacec
a2A1920-51gmBAS BslColorSpacec
a2A1920-51gmPRO BslColorSpacec
a2A1920-160ucBAS BslColorSpacec
a2A1920-160ucPRO BslColorSpacec
a2A1920-160umBAS BslColorSpacec
a2A1920-160umPRO BslColorSpacec
a2A2590-22gcBAS BslColorSpacec
a2A2590-22gcPRO BslColorSpacec
a2A2590-22gmBAS BslColorSpacec
a2A2590-22gmPRO BslColorSpacec
a2A2590-60ucBAS BslColorSpacec
a2A2590-60ucPRO BslColorSpacec
a2A2590-60umBAS BslColorSpacec
a2A2590-60umPRO BslColorSpacec
a2A3840-13gcBAS BslColorSpacec
a2A3840-13gcPRO BslColorSpacec
a2A3840-13gmBAS BslColorSpacec
a2A3840-13gmPRO BslColorSpacec
a2A3840-45ucBAS BslColorSpacec
a2A3840-45ucPRO BslColorSpacec
a2A3840-45umBAS BslColorSpacec
a2A3840-45umPRO BslColorSpacec
a2A4504-5gcBAS BslColorSpacec
a2A4504-5gcPRO BslColorSpacec
a2A4504-5gmBAS BslColorSpacec
a2A4504-5gmPRO BslColorSpacec
a2A4504-18ucBAS BslColorSpacec
a2A4504-18ucPRO BslColorSpacec
a2A4504-18umBAS BslColorSpacec
a2A4504-18umPRO BslColorSpacec
a2A5320-7gcBAS BslColorSpacec
a2A5320-7gcPRO BslColorSpacec
a2A5320-7gmBAS BslColorSpacec
a2A5320-7gmPRO BslColorSpacec
a2A5320-23ucBAS BslColorSpacec
a2A5320-23ucPRO BslColorSpacec
a2A5320-23umBAS BslColorSpacec
a2A5320-23umPRO BslColorSpacec
a2A5328-4gcBAS BslColorSpacec
a2A5328-4gcPRO BslColorSpacec
a2A5328-4gmBAS BslColorSpacec
a2A5328-4gmPRO BslColorSpacec
a2A5328-15ucBAS BslColorSpacec
a2A5328-15ucPRO BslColorSpacec
a2A5328-15umBAS BslColorSpacec
a2A5328-15umPRO BslColorSpacec
acA640-90gc GammaEnable
GammaSelector
acA640-90gm GammaEnable
GammaSelector
acA640-90uc Nonea
acA640-90um Nonea
acA640-120gc GammaEnable
GammaSelector
acA640-120gm GammaEnable
GammaSelector
acA640-120uc Nonea
acA640-120um Nonea
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
acA780-75gc GammaEnable
GammaSelector
acA780-75gm GammaEnable
GammaSelector
acA800-200gc GammaEnable
GammaSelector
acA800-200gm GammaEnable
GammaSelector
acA800-510uc Nonea
acA800-510um Nonea
acA1280-60gc GammaEnable
GammaSelector
acA1280-60gm GammaEnable
GammaSelector
acA1300-22gc GammaEnable
GammaSelector
acA1300-22gm GammaEnable
GammaSelector
acA1300-30gc GammaEnable
GammaSelector
acA1300-30gm GammaEnable
GammaSelector
acA1300-30uc Nonea
acA1300-30um Nonea
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-20gm GammaEnable
GammaSelector
acA1600-20uc Nonea
acA1600-20um 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-50gmNIR GammaEnable
GammaSelector
acA2000-165uc Nonea
acA2000-165um Nonea
acA2000-165umNIR 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
acA4600-7gc GammaEnable
GammaSelector
acA4600-10uc Nonea
acA5472-5gc GammaEnable
GammaSelector
acA5472-5gm GammaEnable
GammaSelector
acA5472-17uc Nonea
acA5472-17ucMED Nonea
acA5472-17um Nonea
acA5472-17umMED Nonea
boA4096-93cc BslColorSpacec
boA4096-93cm BslColorSpacec
boA4112-68cc BslColorSpacec
boA4112-68cm BslColorSpacec
boA6500-36cm BslColorSpacec
boA8100-16cm BslColorSpacec
daA1280-54lc BslColorSpaceModeb
daA1280-54lm BslColorSpaceModeb
daA1280-54uc BslColorSpaceModeb
daA1280-54um BslColorSpaceModeb
daA1600-60lc BslColorSpaceModeb
daA1600-60lm BslColorSpaceModeb
daA1600-60uc BslColorSpaceModeb
daA1600-60um BslColorSpaceModeb
daA1920-15um BslColorSpaceModeb
daA1920-30uc BslColorSpaceModeb
daA1920-30um BslColorSpaceModeb
daA1920-160uc BslColorSpacea
daA1920-160um BslColorSpacea
daA2500-14lc BslColorSpaceModeb
daA2500-14lm BslColorSpaceModeb
daA2500-14uc BslColorSpaceModeb
daA2500-14um BslColorSpaceModeb
puA1280-54uc BslColorSpaceModeb
puA1280-54um BslColorSpaceModeb
puA1600-60uc BslColorSpaceModeb
puA1600-60um BslColorSpaceModeb
puA1920-30uc BslColorSpaceModeb
puA1920-30um BslColorSpaceModeb
puA2500-14uc BslColorSpaceModeb
puA2500-14um BslColorSpaceModeb

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

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

  3. カラースペースがsRGBに設定されている場合は、ガンマ補正値約0.4が適用されます。この値は個別に適用され、Gammaパラメーター値には含まれません。:カラースペースを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、およびdart IMXカメラ#

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

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

その他のカメラ#

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

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