Hue and Saturation#

Hue and Saturation camera feature를 사용하면 이미지의 모든 색상 외관을 한 번에 조정할 수 있습니다.

이미지의 개별 색상 외관을 조정하려면 Color Adjustment 기능(사용 가능한 경우)을 사용하십시오.

기능 사용법#

색상(Hue) 조절#

색조를 조정하면 이미지의 색상이 이동합니다. 이는 예를 들어 색상 편향을 수정하거나 거짓 색상(false-color) 이미지를 만드는 데 유용할 수 있습니다.

색조를 조정하는 방법:

1. 카메라가 Basler dart 또는 pulse 카메라인 경우 Pixel Format을 다음으로 설정하십시오. YCbCr422-8 또는 RGB8.
2. 다음 파라미터에 값을 입력합니다: BslHue 파라미터(dart 및 pulse 카메라: BslHueValue). 파라미터의 값 범위는 -180°에서 180° 사이입니다.

파라미터 값은 RGB 컬러 큐브의 회전을 나타냅니다. 기본적으로 파라미터는 0°(색상 이동 없음)로 설정되어 있습니다.

채도(Saturation) 조절#

채도를 조정하면 색상의 선명도(강도)가 변경됩니다. 예를 들어 채도가 높을수록 색상을 더 쉽게 구별할 수 있습니다.

채도를 조정하는 방법:

1. 카메라가 Basler dart 또는 pulse 카메라인 경우 Pixel Format을 다음으로 설정하십시오. YCbCr422-8 또는 RGB8.
2. 다음 파라미터에 값을 입력합니다: BslSaturation 파라미터(dart 및 pulse 카메라: BslSaturationValue). 기본적으로 파라미터는 1(일반 채도)로 설정되어 있습니다.

파라미터 값이 낮을수록 회색에 가까운 차분한 색상이 되고, 파라미터 값이 높을수록 더 선명하고 생생한 색상이 됩니다.

추가 Parameters#

사용 가능한 경우, BslHueRaw 및 BslSaturationRaw 파라미터를 사용하면 Hue and Saturation 파라미터에 부동 소수점 값 대신 정수 값을 입력할 수 있습니다. 일반적으로 이러한 파라미터는 설정할 필요가 없습니다.

샘플 코드#

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를 사용하여 파라미터를 손쉽게 설정할 수 있습니다.