Gamma#

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

機能を使用する#

仕組み#

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

Gamma補正式（赤のピクセル）

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

Gamma補正の有効化#

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

GammaEnableパラメーターをtrueに設定します（使用可能な場合）。
最良の結果を得るには、BlackLevelパラメーターを0に設定します。
パラメーターを 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	BslColorSpace^c
a2A1920-51gcPRO	BslColorSpace^c
a2A1920-51gmBAS	None
a2A1920-51gmPRO	None
a2A1920-160ucBAS	BslColorSpace^c
a2A1920-160ucPRO	BslColorSpace^c
a2A1920-160umBAS	None
a2A1920-160umPRO	None
a2A1920-165g5cBAS	BslColorSpace^c
a2A1920-165g5mBAS	None
a2A2048-35gmSWIR	None
a2A2048-37gcBAS	BslColorSpace^c
a2A2048-37gcPRO	BslColorSpace^c
a2A2048-37gmBAS	None
a2A2048-37gmPRO	None
a2A2048-110umSWIR	None
a2A2048-114g5cBAS	BslColorSpace^c
a2A2048-114g5mBAS	None
a2A2048-114ucBAS	BslColorSpace^c
a2A2048-114ucPRO	BslColorSpace^c
a2A2048-114umBAS	None
a2A2048-114umPRO	None
a2A2440-98g5cBAS	BslColorSpace^c
a2A2440-98g5mBAS	None
a2A2448-23gcBAS	BslColorSpace^c
a2A2448-23gcPRO	BslColorSpace^c
a2A2448-23gmBAS	None
a2A2448-23gmPRO	None
a2A2448-75ucBAS	BslColorSpace^c
a2A2448-75ucPRO	BslColorSpace^c
a2A2448-75umBAS	None
a2A2448-75umPRO	None
a2A2448-105g5cBAS	BslColorSpace^c
a2A2448-105g5mBAS	None
a2A2448-120cc	BslColorSpace^c
a2A2448-120cm	None
a2A2448-210cc	BslColorSpace^c
a2A2448-210cm	None
a2A2560-20gmSWIR	None
a2A2560-70umSWIR	None
a2A2590-22gcBAS	BslColorSpace^c
a2A2590-22gcPRO	BslColorSpace^c
a2A2590-22gmBAS	None
a2A2590-22gmPRO	None
a2A2590-60ucBAS	BslColorSpace^c
a2A2590-60ucPRO	BslColorSpace^c
a2A2590-60umBAS	None
a2A2590-60umPRO	None
a2A2600-20gcBAS	BslColorSpace^c
a2A2600-20gcPRO	BslColorSpace^c
a2A2600-20gmBAS	None
a2A2600-20gmPRO	None
a2A2600-64ucBAS	BslColorSpace^c
a2A2600-64ucPRO	BslColorSpace^c
a2A2600-64umBAS	None
a2A2600-64umPRO	None
a2A2840-14gcBAS	BslColorSpace^c
a2A2840-14gcPRO	BslColorSpace^c
a2A2840-14gmBAS	None
a2A2840-14gmPRO	None
a2A2840-14gmUV	None
a2A2840-48ucBAS	BslColorSpace^c
a2A2840-48ucPRO	BslColorSpace^c
a2A2840-48umBAS	None
a2A2840-48umPRO	None
a2A2840-48umUV	None
a2A2840-67g5cBAS	BslColorSpace^c
a2A2840-67g5mBAS	None
a2A2840-67g5mUV	None
a2A2840-86cc	BslColorSpace^c
a2A2840-86cm	None
a2A3536-9gcBAS	BslColorSpace^c
a2A3536-9gcPRO	BslColorSpace^c
a2A3536-9gmBAS	None
a2A3536-9gmPRO	None
a2A3536-31ucBAS	BslColorSpace^c
a2A3536-31ucPRO	BslColorSpace^c
a2A3536-31umBAS	None
a2A3536-31umPRO	None
a2A3536-42g5cBAS	BslColorSpace^c
a2A3536-42g5mBAS	None
a2A3840-13gcBAS	BslColorSpace^c
a2A3840-13gcPRO	BslColorSpace^c
a2A3840-13gmBAS	None
a2A3840-13gmPRO	None
a2A3840-45ucBAS	BslColorSpace^c
a2A3840-45ucPRO	BslColorSpace^c
a2A3840-45umBAS	None
a2A3840-45umPRO	None
a2A4096-9gcBAS	BslColorSpace^c
a2A4096-9gcPRO	BslColorSpace^c
a2A4096-9gmBAS	None
a2A4096-9gmPRO	None
a2A4096-30ucBAS	BslColorSpace^c
a2A4096-30ucPRO	BslColorSpace^c
a2A4096-30umBAS	None
a2A4096-30umPRO	None
a2A4096-44g5cBAS	BslColorSpace^c
a2A4096-44g5mBAS	None
a2A4096-67cc	BslColorSpace^c
a2A4096-67cm	None
a2A4200-12gcBAS	BslColorSpace^c
a2A4200-12gcPRO	BslColorSpace^c
a2A4200-12gmBAS	None
a2A4200-12gmPRO	None
a2A4200-40ucBAS	BslColorSpace^c
a2A4200-40ucPRO	BslColorSpace^c
a2A4200-40umBAS	None
a2A4200-40umPRO	None
a2A4504-5gcBAS	BslColorSpace^c
a2A4504-5gcPRO	BslColorSpace^c
a2A4504-5gmBAS	None
a2A4504-5gmPRO	None
a2A4504-18ucBAS	BslColorSpace^c
a2A4504-18ucPRO	BslColorSpace^c
a2A4504-18umBAS	None
a2A4504-18umPRO	None
a2A4504-27g5cBAS	BslColorSpace^c
a2A4504-27g5mBAS	None
a2A4504-42cc	BslColorSpace^c
a2A4504-42cm	None
a2A4508-6gcBAS	BslColorSpace^c
a2A4508-6gcPRO	BslColorSpace^c
a2A4508-6gmBAS	None
a2A4508-6gmPRO	None
a2A4508-20ucBAS	BslColorSpace^c
a2A4508-20ucPRO	BslColorSpace^c
a2A4508-20umBAS	None
a2A4508-20umPRO	None
a2A5060-4gcBAS	BslColorSpace^c
a2A5060-4gmBAS	None
a2A5060-15ucBAS	BslColorSpace^c
a2A5060-15umBAS	None
a2A5060-21g5cBAS	BslColorSpace^c
a2A5060-21g5mBAS	None
a2A5320-7gcBAS	BslColorSpace^c
a2A5320-7gcPRO	BslColorSpace^c
a2A5320-7gmBAS	None
a2A5320-7gmPRO	None
a2A5320-23ucBAS	BslColorSpace^c
a2A5320-23ucPRO	BslColorSpace^c
a2A5320-23umBAS	None
a2A5320-23umPRO	None
a2A5320-34g5cBAS	BslColorSpace^c
a2A5320-34g5mBAS	None
a2A5320-52cc	BslColorSpace^c
a2A5320-52cm	None
a2A5328-4gcBAS	BslColorSpace^c
a2A5328-4gcPRO	BslColorSpace^c
a2A5328-4gmBAS	None
a2A5328-4gmPRO	None
a2A5328-15ucBAS	BslColorSpace^c
a2A5328-15ucPRO	BslColorSpace^c
a2A5328-15umBAS	None
a2A5328-15umPRO	None
a2A5328-22g5cBAS	BslColorSpace^c
a2A5328-22g5mBAS	None
a2A5328-35cc	BslColorSpace^c
a2A5328-35cm	None
acA640-121gm	GammaEnable GammaSelector
acA640-300gc	GammaEnable GammaSelector
acA640-300gm	GammaEnable GammaSelector
acA640-750uc	None^a
acA640-750um	None^a
acA720-290gc	GammaEnable GammaSelector
acA720-290gm	GammaEnable GammaSelector
acA720-520uc	None^a
acA720-520um	None^a
acA800-200gc	GammaEnable GammaSelector
acA800-200gm	GammaEnable GammaSelector
acA800-510uc	None^a
acA800-510um	None^a
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	None^a
acA1300-200um	None^a
acA1440-73gc	GammaEnable GammaSelector
acA1440-73gm	GammaEnable GammaSelector
acA1440-220uc	None^a
acA1440-220um	None^a
acA1600-20gc	GammaEnable GammaSelector
acA1600-20uc	None^a
acA1600-60gc	GammaEnable GammaSelector
acA1600-60gm	GammaEnable GammaSelector
acA1920-25gc	GammaEnable GammaSelector
acA1920-25gm	GammaEnable GammaSelector
acA1920-25uc	None^a
acA1920-25um	None^a
acA1920-40gc	GammaEnable GammaSelector
acA1920-40gm	GammaEnable GammaSelector
acA1920-40uc	None^a
acA1920-40ucMED	None^a
acA1920-40um	None^a
acA1920-40umMED	None^a
acA1920-48gc	GammaEnable GammaSelector
acA1920-48gm	GammaEnable GammaSelector
acA1920-50gc	GammaEnable GammaSelector
acA1920-50gm	GammaEnable GammaSelector
acA1920-150uc	None^a
acA1920-150um	None^a
acA1920-155uc	None^a
acA1920-155ucMED	None^a
acA1920-155um	None^a
acA1920-155umMED	None^a
acA2000-50gc	GammaEnable GammaSelector
acA2000-50gm	GammaEnable GammaSelector
acA2000-165uc	None^a
acA2000-165um	None^a
acA2040-25gc	GammaEnable GammaSelector
acA2040-25gm	GammaEnable GammaSelector
acA2040-25gmNIR	GammaEnable GammaSelector
acA2040-35gc	GammaEnable GammaSelector
acA2040-35gm	GammaEnable GammaSelector
acA2040-55uc	None^a
acA2040-55um	None^a
acA2040-90uc	None^a
acA2040-90um	None^a
acA2040-90umNIR	None^a
acA2040-120uc	None^a
acA2040-120um	None^a
acA2440-20gc	GammaEnable GammaSelector
acA2440-20gm	GammaEnable GammaSelector
acA2440-35uc	None^a
acA2440-35ucMED	None^a
acA2440-35um	None^a
acA2440-35umMED	None^a
acA2440-75uc	None^a
acA2440-75ucMED	None^a
acA2440-75um	None^a
acA2440-75umMED	None^a
acA2500-14gc	GammaEnable GammaSelector
acA2500-14gm	GammaEnable GammaSelector
acA2500-14uc	None^a
acA2500-14um	None^a
acA2500-20gc	GammaEnable GammaSelector
acA2500-20gcMED	GammaEnable GammaSelector
acA2500-20gm	GammaEnable GammaSelector
acA2500-20gmMED	GammaEnable GammaSelector
acA2500-60uc	None^a
acA2500-60um	None^a
acA3088-16gc	GammaEnable GammaSelector
acA3088-16gm	GammaEnable GammaSelector
acA3088-57uc	None^a
acA3088-57ucMED	None^a
acA3088-57um	None^a
acA3088-57umMED	None^a
acA3800-10gc	GammaEnable GammaSelector
acA3800-10gm	GammaEnable GammaSelector
acA3800-14uc	None^a
acA3800-14um	None^a
acA4024-8gc	GammaEnable GammaSelector
acA4024-8gm	GammaEnable GammaSelector
acA4024-29uc	None^a
acA4024-29um	None^a
acA4096-11gc	GammaEnable GammaSelector
acA4096-11gm	GammaEnable GammaSelector
acA4096-30uc	None^a
acA4096-30ucMED	None^a
acA4096-30um	None^a
acA4096-30umMED	None^a
acA4096-40uc	None^a
acA4096-40ucMED	None^a
acA4096-40um	None^a
acA4096-40umMED	None^a
acA4112-8gc	GammaEnable GammaSelector
acA4112-8gm	GammaEnable GammaSelector
acA4112-20uc	None^a
acA4112-20ucMED	None^a
acA4112-20um	None^a
acA4112-20umMED	None^a
acA4112-30uc	None^a
acA4112-30ucMED	None^a
acA4112-30um	None^a
acA4112-30umMED	None^a
acA5472-5gc	GammaEnable GammaSelector
acA5472-5gm	GammaEnable GammaSelector
acA5472-17uc	None^a
acA5472-17ucMED	None^a
acA5472-17um	None^a
acA5472-17umMED	None^a
boA1936-400cc	BslColorSpace^c
boA1936-400cm	None
boA2448-250cc	BslColorSpace^c
boA2448-250cm	None
boA2832-190cc	BslColorSpace^c
boA2832-190cm	None
boA4096-93cc	BslColorSpace^c
boA4096-93cm	None
boA4096-180cc	BslColorSpace^c
boA4096-180cm	None
boA4112-68cc	BslColorSpace^c
boA4112-68cm	None
boA4500-45cc	BslColorSpace^c
boA4500-45cm	None
boA4504-100cc	BslColorSpace^c
boA4504-100cm	None
boA5120-150cc	Gamma機能はサポートされていません
boA5120-150cm	Gamma機能はサポートされていません
boA5120-230cc	Gamma機能はサポートされていません
boA5120-230cm	Gamma機能はサポートされていません
boA5320-150cc	BslColorSpace^c
boA5320-150cm	None
boA5328-100cc	BslColorSpace^c
boA5328-100cm	None
boA6500-36cc	BslColorSpace^c
boA6500-36cm	None
boA8100-16cc	BslColorSpace^c
boA8100-16cm	None
boA9344-30cc	Gamma機能はサポートされていません
boA9344-30cm	Gamma機能はサポートされていません
boA9344-70cc	Gamma機能はサポートされていません
boA9344-70cm	Gamma機能はサポートされていません
boA13440-17cm	None
daA720-520uc	BslColorSpace^a
daA720-520um	None
daA1280-54uc	BslColorSpaceMode^b
daA1280-54um	None
daA1440-220uc	BslColorSpace^a
daA1440-220um	None
daA1600-60uc	BslColorSpaceMode^b
daA1600-60um	None
daA1920-15um	None
daA1920-30uc	BslColorSpaceMode^b
daA1920-30um	None
daA1920-160uc	BslColorSpace^a
daA1920-160um	None
daA2448-70uc	BslColorSpace^a
daA2448-70um	None
daA2500-14uc	BslColorSpaceMode^b
daA2500-14um	None
daA3840-45uc	BslColorSpace^a
daA3840-45um	None
dmA720-290gc	BslColorSpace^c
dmA720-290gm	None
dmA1440-73gc	BslColorSpace^c
dmA1440-73gm	None
dmA1920-51gc	BslColorSpace^c
dmA1920-51gm	None
dmA2048-37gc	BslColorSpace^c
dmA2048-37gm	None
dmA2448-23gc	BslColorSpace^c
dmA2448-23gm	None
dmA2840-14gc	BslColorSpace^c
dmA2840-14gm	None
dmA3536-9gc	BslColorSpace^c
dmA3536-9gm	None
dmA4096-9gc	BslColorSpace^c
dmA4096-9gm	None
puA1280-54uc	BslColorSpaceMode^b
puA1280-54um	None
puA1600-60uc	BslColorSpaceMode^b
puA1600-60um	None
puA1920-30uc	BslColorSpaceMode^b
puA1920-30um	None
puA2500-14uc	BslColorSpaceMode^b
puA2500-14um	None
r2L2048-29gc	BslColorSpace^c
r2L2048-58gm	None
r2L2048-62cc	BslColorSpace^c
r2L2048-62g5c	BslColorSpace^c
r2L2048-172cm	None
r2L2048-172g5m	None
r2L4096-14gc	BslColorSpace^c
r2L4096-29gm	None
r2L4096-42cc	BslColorSpace^c
r2L4096-42g5c	BslColorSpace^c
r2L4096-84cm	None
r2L4096-84g5m	None
r2L8192-200cm	None
r2L16384-120cm	None

光源の初期値を選択すると、約0.4の追加ガンマ補正値（sRGBガンマ補正）が適用されます。この値は個別に適用され、Gammaパラメーター値には含まれません。Example：光源の初期値をタングステンに設定し、Gammaパラメーター値を1.2に設定したとします。まず、ピクセル値に約0.4の自動補正値が適用されます。その後、ガンマ補正値1.2が結果のピクセル値に適用されます。
ピクセルフォーマットがYCbCr422またはRGB8に設定されている場合にのみ使用できます。
カラースペースがsRGBに設定されている場合は、ガンマ補正値約0.4が適用されます。この値は個別に適用され、Gammaパラメーター値には含まれません。Example：カラースペースをsRGBに設定し、Gammaパラメーターを1.2に設定したとます。まず、ピクセル値に約0.4の自動補正値が適用されます。その後、ガンマ補正値1.2が結果のピクセル値に適用されます。
Light Source Presetを選択した場合、カラースペースをsRGBに設定すると、Balance White、Color Adjustment、およびColor Transformationの各機能にも影響します。
カラースペースがsRGBに設定されている場合、ガンマ補正値が約0.4に適用され、Gammaパラメーターは読み取り専用になり、Gammaパラメーター値は無視されます。

サンプルコード#

ace 2, boost, and dart R Cameras#

C++ (Native)C++ (Generic)C#C (Generic)Python

// 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カメラ#

C++ (Native)C++ (Generic)C#C (Generic)Python

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

その他のカメラ#

C++ (Native)C++ (Generic)C#C (Generic)Python

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