Gamma#

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

機能を使用する#

仕組み#

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

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

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

Gamma補正の有効化#

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

Set the GammaEnable parameter to true (if available).
For best results, set the BlackLevel parameter to 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: Enables or disables gamma correction.
Gammaセレクター：次のいずれかのガンマ補正モードを選択できます。
- User: The gamma correction value can be set as desired. (Default.)
- sRGB: The camera automatically sets a gamma correction value of approximately 0.4. This value is optimized for image display on sRGB monitors.
BslColorSpaceMode または BslColorSpace：次のいずれかのガンマ補正モードを選択できます。
- RGB: No additional gamma correction value is applied.
- sRGB: The image brightness is optimized for display on an sRGB monitor. A gamma correction value of approximately 0.4 is applied. For more information, see the footnotes in the Specifics section.

特性#

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

カメラモデル	追加パラメーター
a2A640-240gmSWIR	BslColorSpace^c
a2A640-240umSWIR	BslColorSpace^c
a2A1280-80gmSWIR	BslColorSpace^c
a2A1280-125umSWIR	BslColorSpace^c
a2A1920-51gcBAS	BslColorSpace^c
a2A1920-51gcPRO	BslColorSpace^c
a2A1920-51gmBAS	BslColorSpace^c
a2A1920-51gmPRO	BslColorSpace^c
a2A1920-160ucBAS	BslColorSpace^c
a2A1920-160ucPRO	BslColorSpace^c
a2A1920-160umBAS	BslColorSpace^c
a2A1920-160umPRO	BslColorSpace^c
a2A1920-165g5cBAS	BslColorSpace^c
a2A1920-165g5mBAS	BslColorSpace^c
a2A2440-98g5cBAS	BslColorSpace^c
a2A2440-98g5mBAS	BslColorSpace^c
a2A2448-23gcBAS	BslColorSpace^c
a2A2448-23gcPRO	BslColorSpace^c
a2A2448-23gmBAS	BslColorSpace^c
a2A2448-23gmPRO	BslColorSpace^c
a2A2448-75ucBAS	BslColorSpace^c
a2A2448-75ucPRO	BslColorSpace^c
a2A2448-75umBAS	BslColorSpace^c
a2A2448-75umPRO	BslColorSpace^c
a2A2448-105g5cBAS	BslColorSpace^c
a2A2448-105g5mBAS	BslColorSpace^c
a2A2448-120cc	BslColorSpace^c
a2A2448-120cm	BslColorSpace^c
a2A2448-210cc	BslColorSpace^c
a2A2448-210cm	BslColorSpace^c
a2A2590-22gcBAS	BslColorSpace^c
a2A2590-22gcPRO	BslColorSpace^c
a2A2590-22gmBAS	BslColorSpace^c
a2A2590-22gmPRO	BslColorSpace^c
a2A2590-60ucBAS	BslColorSpace^c
a2A2590-60ucPRO	BslColorSpace^c
a2A2590-60umBAS	BslColorSpace^c
a2A2590-60umPRO	BslColorSpace^c
a2A2600-20gcBAS	BslColorSpace^c
a2A2600-20gcPRO	BslColorSpace^c
a2A2600-20gmBAS	BslColorSpace^c
a2A2600-20gmPRO	BslColorSpace^c
a2A2600-64ucBAS	BslColorSpace^c
a2A2600-64ucPRO	BslColorSpace^c
a2A2600-64umBAS	BslColorSpace^c
a2A2600-64umPRO	BslColorSpace^c
a2A2840-14gcBAS	BslColorSpace^c
a2A2840-14gcPRO	BslColorSpace^c
a2A2840-14gmBAS	BslColorSpace^c
a2A2840-14gmPRO	BslColorSpace^c
a2A2840-14gmUV	BslColorSpace^c
a2A2840-48ucBAS	BslColorSpace^c
a2A2840-48ucPRO	BslColorSpace^c
a2A2840-48umBAS	BslColorSpace^c
a2A2840-48umPRO	BslColorSpace^c
a2A2840-48umUV	BslColorSpace^c
a2A2840-67g5cBAS	BslColorSpace^c
a2A2840-67g5mBAS	BslColorSpace^c
a2A2840-67g5mUV	BslColorSpace^c
a2A2840-86cc	BslColorSpace^c
a2A2840-86cm	BslColorSpace^c
a2A3840-13gcBAS	BslColorSpace^c
a2A3840-13gcPRO	BslColorSpace^c
a2A3840-13gmBAS	BslColorSpace^c
a2A3840-13gmPRO	BslColorSpace^c
a2A3840-45ucBAS	BslColorSpace^c
a2A3840-45ucPRO	BslColorSpace^c
a2A3840-45umBAS	BslColorSpace^c
a2A3840-45umPRO	BslColorSpace^c
a2A4096-9gcBAS	BslColorSpace^c
a2A4096-9gcPRO	BslColorSpace^c
a2A4096-9gmBAS	BslColorSpace^c
a2A4096-9gmPRO	BslColorSpace^c
a2A4096-30ucBAS	BslColorSpace^c
a2A4096-30ucPRO	BslColorSpace^c
a2A4096-30umBAS	BslColorSpace^c
a2A4096-30umPRO	BslColorSpace^c
a2A4096-44g5cBAS	BslColorSpace^c
a2A4096-44g5mBAS	BslColorSpace^c
a2A4096-67cc	BslColorSpace^c
a2A4096-67cm	BslColorSpace^c
a2A4200-12gcBAS	BslColorSpace^c
a2A4200-12gcPRO	BslColorSpace^c
a2A4200-12gmBAS	BslColorSpace^c
a2A4200-12gmPRO	BslColorSpace^c
a2A4200-40ucBAS	BslColorSpace^c
a2A4200-40ucPRO	BslColorSpace^c
a2A4200-40umBAS	BslColorSpace^c
a2A4200-40umPRO	BslColorSpace^c
a2A4504-5gcBAS	BslColorSpace^c
a2A4504-5gcPRO	BslColorSpace^c
a2A4504-5gmBAS	BslColorSpace^c
a2A4504-5gmPRO	BslColorSpace^c
a2A4504-18ucBAS	BslColorSpace^c
a2A4504-18ucPRO	BslColorSpace^c
a2A4504-18umBAS	BslColorSpace^c
a2A4504-18umPRO	BslColorSpace^c
a2A4504-27g5cBAS	BslColorSpace^c
a2A4504-27g5mBAS	BslColorSpace^c
a2A4504-42cc	BslColorSpace^c
a2A4504-42cm	BslColorSpace^c
a2A4508-6gcBAS	BslColorSpace^c
a2A4508-6gcPRO	BslColorSpace^c
a2A4508-6gmBAS	BslColorSpace^c
a2A4508-6gmPRO	BslColorSpace^c
a2A4508-20ucBAS	BslColorSpace^c
a2A4508-20ucPRO	BslColorSpace^c
a2A4508-20umBAS	BslColorSpace^c
a2A4508-20umPRO	BslColorSpace^c
a2A5320-7gcBAS	BslColorSpace^c
a2A5320-7gcPRO	BslColorSpace^c
a2A5320-7gmBAS	BslColorSpace^c
a2A5320-7gmPRO	BslColorSpace^c
a2A5320-23ucBAS	BslColorSpace^c
a2A5320-23ucPRO	BslColorSpace^c
a2A5320-23umBAS	BslColorSpace^c
a2A5320-23umPRO	BslColorSpace^c
a2A5320-34g5cBAS	BslColorSpace^c
a2A5320-34g5mBAS	BslColorSpace^c
a2A5320-52cc	BslColorSpace^c
a2A5320-52cm	BslColorSpace^c
a2A5328-4gcBAS	BslColorSpace^c
a2A5328-4gcPRO	BslColorSpace^c
a2A5328-4gmBAS	BslColorSpace^c
a2A5328-4gmPRO	BslColorSpace^c
a2A5328-15ucBAS	BslColorSpace^c
a2A5328-15ucPRO	BslColorSpace^c
a2A5328-15umBAS	BslColorSpace^c
a2A5328-15umPRO	BslColorSpace^c
a2A5328-22g5cBAS	BslColorSpace^c
a2A5328-22g5mBAS	BslColorSpace^c
a2A5328-35cc	BslColorSpace^c
a2A5328-35cm	BslColorSpace^c
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	BslColorSpace^c
boA2448-250cc	BslColorSpace^c
boA2448-250cm	BslColorSpace^c
boA2832-190cc	BslColorSpace^c
boA2832-190cm	BslColorSpace^c
boA4096-93cc	BslColorSpace^c
boA4096-93cm	BslColorSpace^c
boA4096-180cc	BslColorSpace^c
boA4096-180cm	BslColorSpace^c
boA4112-68cc	BslColorSpace^c
boA4112-68cm	BslColorSpace^c
boA4500-45cc	BslColorSpace^c
boA4500-45cm	BslColorSpace^c
boA4504-100cc	BslColorSpace^c
boA4504-100cm	BslColorSpace^c
boA5120-150cc	Gamma機能はサポートされていません
boA5120-150cm	Gamma機能はサポートされていません
boA5120-230cc	Gamma機能はサポートされていません
boA5120-230cm	Gamma機能はサポートされていません
boA5320-150cc	BslColorSpace^c
boA5320-150cm	BslColorSpace^c
boA5328-100cc	BslColorSpace^c
boA5328-100cm	BslColorSpace^c
boA6500-36cc	BslColorSpace^c
boA6500-36cm	BslColorSpace^c
boA8100-16cc	BslColorSpace^c
boA8100-16cm	BslColorSpace^c
boA9344-30cc	Gamma機能はサポートされていません
boA9344-30cm	Gamma機能はサポートされていません
boA9344-70cc	Gamma機能はサポートされていません
boA9344-70cm	Gamma機能はサポートされていません
boA13440-17cm	None
daA720-520uc	BslColorSpace^a
daA720-520um	BslColorSpace^a
daA1280-54uc	BslColorSpaceMode^b
daA1280-54um	BslColorSpaceMode^b
daA1440-220uc	BslColorSpace^a
daA1440-220um	BslColorSpace^a
daA1600-60uc	BslColorSpaceMode^b
daA1600-60um	BslColorSpaceMode^b
daA1920-15um	BslColorSpaceMode^b
daA1920-30uc	BslColorSpaceMode^b
daA1920-30um	BslColorSpaceMode^b
daA1920-160uc	BslColorSpace^a
daA1920-160um	BslColorSpace^a
daA2448-70uc	BslColorSpace^a
daA2448-70um	BslColorSpace^a
daA2500-14uc	BslColorSpaceMode^b
daA2500-14um	BslColorSpaceMode^b
daA3840-45uc	BslColorSpace^a
daA3840-45um	BslColorSpace^a
puA1280-54uc	BslColorSpaceMode^b
puA1280-54um	BslColorSpaceMode^b
puA1600-60uc	BslColorSpaceMode^b
puA1600-60um	BslColorSpaceMode^b
puA1920-30uc	BslColorSpaceMode^b
puA1920-30um	BslColorSpaceMode^b
puA2500-14uc	BslColorSpaceMode^b
puA2500-14um	BslColorSpaceMode^b

If you select a light source preset, an additional gamma correction value of approximately 0.4 is applied (sRGB gamma correction). This value is applied separately and not included in the Gamma parameter value. Example: You have set the light source preset to Tungsten and the Gamma parameter value to 1.2. First, an automatic correction value of approximately 0.4 is applied to the pixel values. After that, a gamma correction value of 1.2 is applied to the resulting pixel values.
ピクセルフォーマットがYCbCr422またはRGB8に設定されている場合にのみ使用できます。
If the color space is set to sRGB, a gamma correction value of approximately 0.4 is applied. This value is applied separately and not included in the Gamma parameter value. Example: You set the color space to sRGB and the Gamma parameter to 1.2. First, an automatic correction value of approximately 0.4 is applied to the pixel values. After that, a gamma correction value of 1.2 is applied to the resulting pixel values.
If you have selected a Light Source Preset, setting the color space to sRGB will also affect the Balance White, Color Adjustment, and Color Transformation features.
If the color space is set to sRGB, a gamma correction value of approximately 0.4 is applied, the Gamma parameter becomes read-only, and the Gamma parameter value is ignored.

サンプルコード#

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