Gamma#

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

機能を使用する#

仕組み#

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

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

Gamma補正の有効化#

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

1. パラメーターを GammaEnable parameter to true (（使用している場合）に設定します).
2. For best results, set the BlackLevel parameter to 0.
3. パラメーターを Gamma パラメーターを必要な値に設定します。パラメーター値の範囲は0～約4です。
   • Gamma = 1：全体の明るさに変化はありません。
   • Gamma < 1: The overall brightness increases.
   • Gamma > 1：全体の明るさが下がります。

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

追加パラメーター#

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

• GammaEnable: Enables or disables gamma correction.
• GammaSelector：次のいずれかのガンマ補正モードを選択できます。
  • 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 特性 section.

特性#

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

サンプルコード#

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