Scaling#

Scaling（相机功能）可让您放大和缩小图像。

该功能的使用#

运作原理#

The Scaling feature introduces a virtual sensor plane that can be scaled using the BslScalingFactor parameter. The BslScaledSensorWidth and BslScaledSensorHeight parameters indicate the current size of the virtual sensor.

• 较低的缩放系数会增加虚拟传感器的大小。
• 较高的缩放系数会降低虚拟传感器的大小。

示例： Assume your camera sensor has a resolution of 2592 x 1944 pixels. If you set the BslScalingFactor parameter to 0.5, the virtual sensor will be twice the size of the physical sensor, i.e., 5184 x 3888 pixels.

放大#

To zoom in, set the BslScalingFactor parameter to a value lower than 1.0.

这增加了虚拟传感器的大小，而 Image ROI 大小和位置保持不变。

示例： In the example below, the BslScalingFactor parameter is set to 0.5. The size of the virtual sensor halves while the image ROI size and position remain the same.

因此，图像内容将放大显示并移动到左上角。

缩小#

To zoom out, set the BslScalingFactor parameter to a value higher than 1.0.

这降低了虚拟传感器的大小，而 Image ROI 大小和位置保持不变。

示例： In the example below, the BslScalingFactor parameter is set to 2.0. The size of the virtual sensor doubles while the image ROI size and position remain the same.

因此，图像内容将缩小显示并移动到左上角。

示例代码#

// Set scaling to 0.5, i.e., set the size of the
// virtual sensor to 2x the size of the physical sensor
camera.BslScalingFactor.SetValue(0.5);
// Get the size of the virtual sensor
double scaledWidth = camera.BslScaledSensorWidth.GetValue();
double scaledHeight = camera.BslScaledSensorHeight.GetValue();
// Disable scaling
camera.BslScalingFactor.SetValue(1.0);

INodeMap& nodemap = camera.GetNodeMap();
// Set scaling to 0.5, i.e., set the size of the
// virtual sensor to 2x the size of the physical sensor
CFloatParameter(nodemap, "BslScalingFactor").SetValue(0.5);
// Get the size of the virtual sensor
double scaledWidth = CFloatParameter(nodemap, "BslScaledSensorWidth").GetValue();
double scaledHeight = CFloatParameter(nodemap, "BslScaledSensorHeight").GetValue();
// Disable scaling
CFloatParameter(nodemap, "BslScalingFactor").SetValue(1.0);

// Set scaling to 0.5, i.e., set the size of the
// virtual sensor to 2x the size of the physical sensor
camera.Parameters[PLCamera.BslScalingFactor].SetValue(0.5);
// Get the size of the virtual sensor
double scaledWidth = camera.Parameters[PLCamera.BslScaledSensorWidth].GetValue();
double scaledHeight = camera.Parameters[PLCamera.BslScaledSensorHeight].GetValue();
// Disable scaling
camera.Parameters[PLCamera.BslScalingFactor].SetValue(1.0);

/* 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 */
double scaledWidth = 0;
double scaledHeight = 0;
/* Set scaling to 0.5, i.e., set the size of the */
/* virtual sensor to 2x the size of the physical sensor */
errRes = PylonDeviceSetFloatFeature(hdev, "BslScalingFactor", 0.5);
CHECK(errRes);
/* Get the size of the virtual sensor */
errRes = PylonDeviceGetFloatFeature(hdev, "BslScaledSensorWidth", &scaledWidth);
CHECK(errRes);
errRes = PylonDeviceGetFloatFeature(hdev, "BslScaledSensorHeight", &scaledHeight);
CHECK(errRes);
/* Disable scaling */
errRes = PylonDeviceSetFloatFeature(hdev, "BslScalingFactor", 1.0);
CHECK(errRes);

# Set scaling to 0.5, i.e., set the size of the
# virtual sensor to 2x the size of the physical sensor
camera.BslScalingFactor.Value = 0.5
# Get the size of the virtual sensor
scaledWidth = camera.BslScaledSensorWidth.Value
scaledHeight = camera.BslScaledSensorHeight.Value
# Disable scaling
camera.BslScalingFactor.Value = 1.0

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