跳转到内容

Hue and Saturation#

相机的 Color Hexagon 功能可让您一步调整图像中所有颜色的外观。

如果要调整图像中所有颜色的外观，请使用 Color Adjustment 功能（如果有）。

该功能的使用#

调整色相#

调整色相偏移会改变图像的颜色。这对于纠正色彩偏移或创建伪彩图像等很有用。

要调整色相：

  1. 如果您的相机是 Basler dart 或 pulse 相机，则将像素格式设置为 YCbCr422-8 或 RGB8。
  2. 输入 BslHue 参数的值（dart 和 pulse 相机：BslHueValue）。该参数的值范围是 -180° 至 180°。

参数值是指 RGB 颜色立方体的旋转。默认情况下，该参数设置为 0°（无色彩偏移）。

调整饱和度#

调整饱和度会改变色彩的鲜艳程度（强度）。例如，较高的饱和度会使颜色更容易区分。

要调整饱和度：

  1. 如果您的相机是 Basler dart 或 pulse 相机，则将像素格式设置为 YCbCr422-8 或 RGB8。
  2. 输入 BslSaturation 参数的值（dart 和 pulse 相机：BslSaturationValue）。默认情况下，该参数设置为 1（正常饱和度）。

较低的参数值会导致更接近灰色的更为柔和的颜色。较高的参数值会产生更鲜艳的色彩。

附加参数#

如果可用，则 BslHueRaw 和 BslSaturationRaw 参数允许您为色相和饱和度参数输入整数值而不是浮点值。通常，您不需要设置这些参数。

示例代码#

dart 和 pulse 相机#
// Set the Hue parameter to 5 degrees
camera.BslHueValue.SetValue(5);
// Set the Saturation parameter to 1.4
camera.BslSaturationValue.SetValue(1.4);

INodeMap& nodemap = camera.GetNodeMap();
// Set the Hue parameter to 5 degrees
CIntegerParameter(nodemap, "BslHueValue").SetValue(5);
// Set the Saturation parameter to 1.4
CFloatParameter(nodemap, "BslSaturationValue").SetValue(1.4);

// Set the Hue parameter to 5 degrees
camera.Parameters[PLCamera.BslHueValue].SetValue(5);
// Set the Saturation parameter to 1.4
camera.Parameters[PLCamera.BslSaturationValue].SetValue(1.4);

/* 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 Hue parameter to 5 degrees */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslHueValue", 5);
CHECK(errRes);
/* Set the Saturation parameter to 1.4 */
errRes = PylonDeviceSetFloatFeature(hdev, "BslSaturationValue", 1.4);
CHECK(errRes);

# Set the Hue parameter to 5 degrees
camera.BslHueValue.Value = 5
# Set the Saturation parameter to 1.4
camera.BslSaturationValue.Value = 1.4
其他相机#
// Set the Hue parameter to 5 degrees
camera.BslHue.SetValue(5);
// Set the Saturation parameter to 1.4
camera.BslSaturation.SetValue(1.4);

INodeMap& nodemap = camera.GetNodeMap();
// Set the Hue parameter to 5 degrees
CIntegerParameter(nodemap, "BslHue").SetValue(5);
// Set the Saturation parameter to 1.4
CFloatParameter(nodemap, "BslSaturation").SetValue(1.4);

// Set the Hue parameter to 5 degrees
camera.Parameters[PLCamera.BslHue].SetValue(5);
// Set the Saturation parameter to 1.4
camera.Parameters[PLCamera.BslSaturation].SetValue(1.4);

/* 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 Hue parameter to 5 degrees */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslHue", 5);
CHECK(errRes);
/* Set the Saturation parameter to 1.4 */
errRes = PylonDeviceSetFloatFeature(hdev, "BslSaturation", 1.4);
CHECK(errRes);

# Set the Hue parameter to 5 degrees
camera.BslHue.Value = 5
# Set the Saturation parameter to 1.4
camera.BslSaturation.Value = 1.4

您也可以使用 pylon Viewer 轻松设置参数。