Gamma#

相机的 Gamma 功能使您可以优化所采集图像的亮度，以便在显示器上显示。

该功能的使用#

运作原理#

相机根据以下公式（以彩色相机和红色像素值 (R) 为例）将 Gamma 校正值 (γ) 应用于每个像素的亮度值：

Gamma 校正公式（红色像素）

具体的最大像素值 (Rmax) 视情况而有所不同，例如在 8 位像素格式下为 255，在 10 位像素格式下为 1023。

启用 Gamma 校正#

要启用 Gamma 校正：

将 GammaEnable 参数设置为 true（如果可用）。
为了获得最佳效果，请将 BlackLevel 参数设置为 0。
设置 Gamma 将参数设置为所需值。该参数值的范围是 0 至 ≈4。
- Gamma = 1：整体亮度保持不变。
- Gamma < 1: The overall brightness increases.
- Gamma > 1：整体亮度降低。

在所有情况下，黑色像素（亮度 = 0）和白色像素（亮度 = 最大值）都不会被调整。

信息

如果启用 Gamma 校正，并且像素格式设置为 12 位像素格式，则会丢失一些图像信息。像素数据输出仍将是 12 位，但是像素值将在 Gamma 校正过程中插入。
On boA13440-17cm cameras, gamma correction can only be enabled, if the pixel format is set to an 8-bit pixel format.

附加参数#

根据您的相机型号,可以使用以下附加参数：

GammaEnable：启用或禁用 Gamma 校正。
GammaSelector：允许您选择以下 Gamma 校正模式：
- User：可以根据需要设置 Gamma 校正值（默认）。
- sRGB：相机自动将 Gamma 校正值设定为约 0.4。该值针对 sRGB 显示器上的图像显示进行了优化。
BslColorSpaceMode 或 BslColorSpace：允许您选择以下 Gamma 校正模式：
- RGB：不应用其他 Gamma 校正值。
- sRGB：图像亮度已优化，可在 sRGB 监视器上显示。应用约 0.4 的 Gamma 校正值。有关更多信息，请参见详情部分中的脚注。

详情#

显示所有相机型号

相机型号	附加参数
a2A640-240gmSWIR	无
a2A640-240umSWIR	无
a2A1280-80gmSWIR	无
a2A1280-125umSWIR	无
a2A1920-51gcBAS	BslColorSpace^c
a2A1920-51gcPRO	BslColorSpace^c
a2A1920-51gmBAS	无
a2A1920-51gmPRO	无
a2A1920-160ucBAS	BslColorSpace^c
a2A1920-160ucPRO	BslColorSpace^c
a2A1920-160umBAS	无
a2A1920-160umPRO	无
a2A1920-165g5cBAS	BslColorSpace^c
a2A1920-165g5mBAS	无
a2A2048-35gmSWIR	无
a2A2048-110umSWIR	无
a2A2440-98g5cBAS	BslColorSpace^c
a2A2440-98g5mBAS	无
a2A2448-23gcBAS	BslColorSpace^c
a2A2448-23gcPRO	BslColorSpace^c
a2A2448-23gmBAS	无
a2A2448-23gmPRO	无
a2A2448-75ucBAS	BslColorSpace^c
a2A2448-75ucPRO	BslColorSpace^c
a2A2448-75umBAS	无
a2A2448-75umPRO	无
a2A2448-105g5cBAS	BslColorSpace^c
a2A2448-105g5mBAS	无
a2A2448-120cc	BslColorSpace^c
a2A2448-120cm	无
a2A2448-210cc	BslColorSpace^c
a2A2448-210cm	无
a2A2560-20gmSWIR	无
a2A2560-70umSWIR	无
a2A2590-22gcBAS	BslColorSpace^c
a2A2590-22gcPRO	BslColorSpace^c
a2A2590-22gmBAS	无
a2A2590-22gmPRO	无
a2A2590-60ucBAS	BslColorSpace^c
a2A2590-60ucPRO	BslColorSpace^c
a2A2590-60umBAS	无
a2A2590-60umPRO	无
a2A2600-20gcBAS	BslColorSpace^c
a2A2600-20gcPRO	BslColorSpace^c
a2A2600-20gmBAS	无
a2A2600-20gmPRO	无
a2A2600-64ucBAS	BslColorSpace^c
a2A2600-64ucPRO	BslColorSpace^c
a2A2600-64umBAS	无
a2A2600-64umPRO	无
a2A2840-14gcBAS	BslColorSpace^c
a2A2840-14gcPRO	BslColorSpace^c
a2A2840-14gmBAS	无
a2A2840-14gmPRO	无
a2A2840-14gmUV	无
a2A2840-48ucBAS	BslColorSpace^c
a2A2840-48ucPRO	BslColorSpace^c
a2A2840-48umBAS	无
a2A2840-48umPRO	无
a2A2840-48umUV	无
a2A2840-67g5cBAS	BslColorSpace^c
a2A2840-67g5mBAS	无
a2A2840-67g5mUV	无
a2A2840-86cc	BslColorSpace^c
a2A2840-86cm	无
a2A3840-13gcBAS	BslColorSpace^c
a2A3840-13gcPRO	BslColorSpace^c
a2A3840-13gmBAS	无
a2A3840-13gmPRO	无
a2A3840-45ucBAS	BslColorSpace^c
a2A3840-45ucPRO	BslColorSpace^c
a2A3840-45umBAS	无
a2A3840-45umPRO	无
a2A4096-9gcBAS	BslColorSpace^c
a2A4096-9gcPRO	BslColorSpace^c
a2A4096-9gmBAS	无
a2A4096-9gmPRO	无
a2A4096-30ucBAS	BslColorSpace^c
a2A4096-30ucPRO	BslColorSpace^c
a2A4096-30umBAS	无
a2A4096-30umPRO	无
a2A4096-44g5cBAS	BslColorSpace^c
a2A4096-44g5mBAS	无
a2A4096-67cc	BslColorSpace^c
a2A4096-67cm	无
a2A4200-12gcBAS	BslColorSpace^c
a2A4200-12gcPRO	BslColorSpace^c
a2A4200-12gmBAS	无
a2A4200-12gmPRO	无
a2A4200-40ucBAS	BslColorSpace^c
a2A4200-40ucPRO	BslColorSpace^c
a2A4200-40umBAS	无
a2A4200-40umPRO	无
a2A4504-5gcBAS	BslColorSpace^c
a2A4504-5gcPRO	BslColorSpace^c
a2A4504-5gmBAS	无
a2A4504-5gmPRO	无
a2A4504-18ucBAS	BslColorSpace^c
a2A4504-18ucPRO	BslColorSpace^c
a2A4504-18umBAS	无
a2A4504-18umPRO	无
a2A4504-27g5cBAS	BslColorSpace^c
a2A4504-27g5mBAS	无
a2A4504-42cc	BslColorSpace^c
a2A4504-42cm	无
a2A4508-6gcBAS	BslColorSpace^c
a2A4508-6gcPRO	BslColorSpace^c
a2A4508-6gmBAS	无
a2A4508-6gmPRO	无
a2A4508-20ucBAS	BslColorSpace^c
a2A4508-20ucPRO	BslColorSpace^c
a2A4508-20umBAS	无
a2A4508-20umPRO	无
a2A5320-7gcBAS	BslColorSpace^c
a2A5320-7gcPRO	BslColorSpace^c
a2A5320-7gmBAS	无
a2A5320-7gmPRO	无
a2A5320-23ucBAS	BslColorSpace^c
a2A5320-23ucPRO	BslColorSpace^c
a2A5320-23umBAS	无
a2A5320-23umPRO	无
a2A5320-34g5cBAS	BslColorSpace^c
a2A5320-34g5mBAS	无
a2A5320-52cc	BslColorSpace^c
a2A5320-52cm	无
a2A5328-4gcBAS	BslColorSpace^c
a2A5328-4gcPRO	BslColorSpace^c
a2A5328-4gmBAS	无
a2A5328-4gmPRO	无
a2A5328-15ucBAS	BslColorSpace^c
a2A5328-15ucPRO	BslColorSpace^c
a2A5328-15umBAS	无
a2A5328-15umPRO	无
a2A5328-22g5cBAS	BslColorSpace^c
a2A5328-22g5mBAS	无
a2A5328-35cc	BslColorSpace^c
a2A5328-35cm	无
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	无
boA2448-250cc	BslColorSpace^c
bo2448-250cm	无
boA2832-190cc	BslColorSpace^c
bo2832-190cm	无
boA4096-93cc	BslColorSpace^c
boA4096-93cm	无
boA4096-180cc	BslColorSpace^c
bo4096-180cm	无
boA4112-68cc	BslColorSpace^c
boA4112-68cm	无
boA4500-45cc	BslColorSpace^c
boA4500-45cm	无
boA4504-100cc	BslColorSpace^c
boA4504-100cm	无
boA5120-150cc	不支持 Gamma 功能
boA5120-150cm	不支持 Gamma 功能
boA5120-230cc	不支持 Gamma 功能
boA5120-230cm	不支持 Gamma 功能
boA5320-150cc	BslColorSpace^c
boA5320-150cm	无
boA5328-100cc	BslColorSpace^c
boA5328-100cm	无
boA6500-36cc	BslColorSpace^c
boA6500-36cm	无
boA8100-16cc	BslColorSpace^c
boA8100-16cm	无
boA9344-30cc	不支持 Gamma 功能
boA9344-30cm	不支持 Gamma 功能
boA9344-70cc	不支持 Gamma 功能
boA9344-70cm	不支持 Gamma 功能
boA13440-17cm	无
daA720-520uc	BslColorSpace^a
daA720-520um	无
daA1280-54uc	BslColorSpaceMode ^b
daA1280-54um	无
daA1440-220uc	BslColorSpace^a
daA1440-220um	无
daA1600-60uc	BslColorSpaceMode ^b
daA1600-60um	无
daA1920-15um	无
daA1920-30uc	BslColorSpaceMode ^b
daA1920-30um	无
daA1920-160uc	BslColorSpace^a
daA1920-160um	无
daA2448-70uc	BslColorSpace^a
daA2448-70um	无
daA2500-14uc	BslColorSpaceMode ^b
daA2500-14um	无
daA3840-45uc	BslColorSpace^a
daA3840-45um	无
dmA720-290gc	BslColorSpace^c
dmA720-290gm	无
dmA1440-73gc	BslColorSpace^c
dmA1440-73gm	无
dmA1920-51gc	BslColorSpace^c
dmA1920-51gm	无
puA1280-54uc	BslColorSpaceMode ^b
puA1280-54um	无
puA1600-60uc	BslColorSpaceMode ^b
puA1600-60um	无
puA1920-30uc	BslColorSpaceMode ^b
puA1920-30um	无
puA2500-14uc	BslColorSpaceMode ^b
puA2500-14um	无
r2L2048-29gc	BslColorSpace^c
r2L2048-58gm	无
r2L2048-62cc	BslColorSpace^c
r2L2048-62g5c	BslColorSpace^c
r2L2048-172cm	无
r2L2048-172g5m	无
r2L4096-14gc	BslColorSpace^c
r2L4096-29gm	无
r2L4096-42cc	BslColorSpace^c
r2L4096-42g5c	BslColorSpace^c
r2L4096-84cm	无
r2L4096-84g5m	无
r2L8192-200cm	无
r2L16384-120cm	无

如果选择光源预设，则将应用大约 0.4 的附加 Gamma 校正值（sRGB Gamma 校正）。此值是单独应用的，不会包含在 Gamma 参数值中。示例：您已将光源预设设置为“钨丝”，然后将 Gamma 参数值设为 1.2。首先，将近似 0.4 的自动校正值应用于像素值。之后，将 1.2 的 Gamma 校正值应用于所得的像素值。
仅在像素格式设置为 YCbCr422 或 RGB8 时可用。
如果将色彩空间设置为 sRGB，将应用大约 0.4 的 Gamma 校正值。此值是单独应用的，不会包含在 Gamma 参数值中。示例：您将色彩空间设置为 sRGB 且将 Gamma 参数设置为 1.2。首先，将大约 0.4 的自动校正值应用于像素值。之后，将 1.2 的 Gamma 校正值应用于所得的像素值。
如果您已选定 Light Source Preset，将色彩空间设置为 sRGB 也会影响 Balance White、Color Adjustment 和 Color Transformation 功能。
如果将色彩空间设置为 sRGB，则将应用大约 0.4 的 Gamma 校正值，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 轻松设置参数。