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.

これにより仮想センサーのサイズが大きくなりますが、画像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.

これにより仮想センサーのサイズが小さくなりますが、画像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

pylonViewerアを使用して、パラメーターを簡単に設定することもできます。