PGI 機能セット#

PGI機能セットを使用すると、画像の品質を最適化できます。

PGI機能セットの主な目的は、ヒューマンビジョンのニーズを満たすように画像を最適化することです。最大4つの画像最適化プロセスを組み合わせます。

機能を使用する#

仕組み#

お使いのカメラモデルに応じて、次の画像最適化セットが実行されます。

ノイズ低減#

ノイズ低減（「ノイズ除去」とも呼ばれます）により、画像の明るさまたはカラー情報のランダムな変化が低減されます。

鮮明度の向上#

この最適化により、画像の鮮明度が上がります。鮮明度が高いほど、画像オブジェクトの輪郭がはっきりします。これは、カメラが数字や文字を正しく識別する必要がある用途で特に役立ちます。

4×4 or 5×5 Debayering#

4×4 or 5×5 debayering (also called "demosaicing") carries out color interpolation on regions of 4×4 or 5×5 pixels on the sensor and is therefore more elaborate than the "simple" 2×2 debayering used otherwise by the camera.

カラーアンチエイリアス#

色の誤差、特にシャープエッジや空間周波数の高い画像のセクションにおけるものは、デベイヤリングアルゴリズムでよく見られる副次的な影響です。無色の構造でも、突然、色が表示されます。カラーアンチエイリアシングの最適化では、変色が解析され、補正されます。

PGI画像の最適化の詳細については、Better Image Quality with Basler PGIホワイトペーパーを参照してください。

PGI機能セットの有効化#

The implementation of this feature varies depending on the camera:

• ace 2 Pro and dart R Cameras
• ace U/Lカメラ
• dart Classic/E and pulse Cameras

ace 2 Pro and dart R Cameras#

To enable the PGI image optimizations on Basler ace 2 Pro and dart R cameras:

• If your camera is a mono camera, PGI image optimizations are enabled automatically when any of the following parameters isn't set to its default value:

  • NoiseReduction
  • SharpnessEnhancement
  • BslScalingFactor (if available)

• お使いのカメラがカラーカメラの場合は次の手順に従います。

  1. Make sure that the BslDemosaicingMode parameter is set to Auto.
  2. Set the pixel format to a non-Bayer color pixel format, i.e., to one of the available RGB, BGR, or YUV pixel formats.

ace U/Lカメラ#

Basler ace UおよびL カメラでPGI画像最適化（使用可能な場合）を有効にするには、次の手順に従います。

• カメラが モノ camera, set the PgiMode parameter to On.

• お使いのカメラがカラーカメラの場合は次の手順に従います。

  1. ピクセルフォーマットを非Bayerカラーのピクセルフォーマットに設定します。つまり、使用可能なRGB、BGR、またはYUVピクセルフォーマットのいずれかに設定します。一部のカメラモデルでは、PGI機能セットはいずれかのYUVピクセルフォーマットでのみ使用できます。
  2. パラメーターを DemosaicingMode parameter to BaslerPGI.

dart Classic/E and pulse Cameras#

To enable the PGI image optimizations (if available) on Basler dart Classic, dart E, and pulse cameras:

1. カメラがカラーカメラの場合、ピクセルフォーマットを非Bayerカラーのピクセルフォーマット（RGB、BGR、またはYUVのいずれかのピクセルフォーマット）に設定します。
2. If you want to manually configure noise reduction, set the PgiMode parameter to On_ManualNoiseReduction. You can now configure noise reduction and improved sharpness.
3. If you want the noise reduction to be applied automatically, set the PgiMode parameter to On_AutomaticNoiseReduction. You can now configure improved sharpness.

PGI画像最適化の設定#

PGI機能セットを有効にすると、個々の画像最適化プロセスを設定できます。

どの画像最適化機能が使用可能で設定可能かは、カメラのモデルによって異なります。

ノイズ低減の設定#

If this optimization is configurable, set the NoiseReduction parameter to specify the desired noise reduction. The higher the parameter value, the more noise reduction is applied.

この最適化を設定できない場合は、ノイズ低減が自動的に適用されます。

ノイズ低減は、鮮明度の向上とともに使用することをお勧めします。このパラメーター値が高すぎると、画像の微細な構成が不明確になったり、消えたりすることがあります。

鮮明度の向上の設定#

If this optimization is configurable, set the SharpnessEnhancement parameter to specify the desired level of sharpness. The higher the parameter value, the more sharpening is applied.

この最適化を設定できない場合は、鮮明度は自動的に改善されます。

ほとんどの場合、低いパラメーター値を設定するとともにノイズ低減を併用した場合に最適な結果が得られます。

Configuring 4×4 or 5×5 Debayering#

If available, 4×4 or 5×5 debayering is performed automatically whenever the PGI feature set is enabled. You can't configure this optimization.

カラーアンチエイリアスの設定#

使用可能な場合、PGI機能セットが有効になると、カラーアンチエイリアスが自動的に実行されます。この最適化は設定できません。

特性#

すべてのカメラモデルを表示します

サンプルコード#

ace 2 Pro and dart R Cameras#

// Set the pixel format to a non-Bayer format (color cameras only)
camera.PixelFormat.SetValue(PixelFormat_RGB8);
// Configure noise reduction
camera.BslNoiseReduction.SetValue(0.2);
// Configure improved sharpness
camera.BslSharpnessEnhancement.SetValue(1.0);

INodeMap& nodemap = camera.GetNodeMap();
// Set the pixel format to a non-Bayer format (color cameras only)
CEnumParameter(nodemap, "PixelFormat").SetValue("RGB8");
// Configure noise reduction
CFloatParameter(nodemap, "BslNoiseReduction").SetValue(0.2);
// Configure improved sharpness
CFloatParameter(nodemap, "BslSharpnessEnhancement").SetValue(1.0);

// Set the pixel format to a non-Bayer format (color cameras only)
camera.Parameters[PLCamera.PixelFormat].SetValue(PLCamera.PixelFormat.RGB8);
// Configure noise reduction
camera.Parameters[PLCamera.BslNoiseReduction].SetValue(0.2);
// Configure improved sharpness
camera.Parameters[PLCamera.BslSharpnessEnhancement].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 */
/* Set the pixel format to a non-Bayer format (color cameras only) */
errRes = PylonDeviceFeatureFromString(hdev, "PixelFormat", "RGB8");
CHECK(errRes);
/* Configure noise reduction */
errRes = PylonDeviceSetFloatFeature(hdev, "BslNoiseReduction", 0.2);
CHECK(errRes);
/* Configure improved sharpness */
errRes = PylonDeviceSetFloatFeature(hdev, "BslSharpnessEnhancement", 1.0);
CHECK(errRes);

# Set the pixel format to a non-Bayer format (color cameras only)
camera.PixelFormat.Value = "RGB8"
# Configure noise reduction
camera.BslNoiseReduction.Value = 0.2
# Configure improved sharpness
camera.BslSharpnessEnhancement.Value = 1.0

ace U/L USB 3.0カメラ#

// Enable the PGI feature set (mono cameras only)
camera.PgiMode.SetValue(PgiMode_On);
// Enable the PGI feature set (color cameras only)
camera.DemosaicingMode.SetValue(DemosaicingMode_BaslerPGI);
// Configure noise reduction (if available)
camera.NoiseReduction.SetValue(0.2);
// Configure improved sharpness (if available)
camera.SharpnessEnhancement.SetValue(1.0);

INodeMap& nodemap = camera.GetNodeMap();
// Enable the PGI feature set (mono cameras only)
CEnumParameter(nodemap, "PgiMode").SetValue("On");
// Enable the PGI feature set (color cameras only)
CEnumParameter(nodemap, "DemosaicingMode").SetValue("BaslerPGI");
// Configure noise reduction (if available)
CFloatParameter(nodemap, "NoiseReduction").SetValue(0.2);
// Configure improved sharpness (if available)
CFloatParameter(nodemap, "SharpnessEnhancement").SetValue(1.0);

// Enable the PGI feature set (mono cameras only)
camera.Parameters[PLCamera.PgiMode].SetValue(PLCamera.PgiMode.On);
// Enable the PGI feature set (color cameras only)
camera.Parameters[PLCamera.DemosaicingMode].SetValue(PLCamera.DemosaicingMode.BaslerPGI);
// Configure noise reduction (if available)
camera.Parameters[PLCamera.NoiseReduction].SetValue(0.2);
// Configure improved sharpness (if available)
camera.Parameters[PLCamera.SharpnessEnhancement].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 */
/* Enable the PGI feature set (mono cameras only) */
errRes = PylonDeviceFeatureFromString(hdev, "PgiMode", "On");
CHECK(errRes);
/* Enable the PGI feature set (color cameras only) */
errRes = PylonDeviceFeatureFromString(hdev, "DemosaicingMode", "BaslerPGI");
CHECK(errRes);
/* Configure noise reduction (if available) */
errRes = PylonDeviceSetFloatFeature(hdev, "NoiseReduction", 0.2);
CHECK(errRes);
/* Configure improved sharpness (if available) */
errRes = PylonDeviceSetFloatFeature(hdev, "SharpnessEnhancement", 1.0);
CHECK(errRes);

# Enable the PGI feature set (mono cameras only)
camera.PgiMode.Value = "On"
# Enable the PGI feature set (color cameras only)
camera.DemosaicingMode.Value = "BaslerPGI"
# Configure noise reduction (if available)
camera.NoiseReduction.Value = 0.2
# Configure improved sharpness (if available)
camera.SharpnessEnhancement.Value = 1.0

ace U/L GigEカメラ#

// Enable the PGI feature set (mono cameras only)
camera.PgiMode.SetValue(PgiMode_On);
// Enable the PGI feature set (color cameras only)
camera.DemosaicingMode.SetValue(DemosaicingMode_BaslerPGI);
// Configure noise reduction (if available)
camera.NoiseReductionAbs.SetValue(0.2);
// Configure improved sharpness (if available)
camera.SharpnessEnhancementAbs.SetValue(1.0);

INodeMap& nodemap = camera.GetNodeMap();
// Enable the PGI feature set (mono cameras only)
CEnumParameter(nodemap, "PgiMode").SetValue("On");
// Enable the PGI feature set (color cameras only)
CEnumParameter(nodemap, "DemosaicingMode").SetValue("BaslerPGI");
// Configure noise reduction (if available)
CFloatParameter(nodemap, "NoiseReductionAbs").SetValue(0.2);
// Configure improved sharpness (if available)
CFloatParameter(nodemap, "SharpnessEnhancementAbs").SetValue(1.0);

// Enable the PGI feature set (mono cameras only)
camera.Parameters[PLCamera.PgiMode].SetValue(PLCamera.PgiMode.On);
// Enable the PGI feature set (color cameras only)
camera.Parameters[PLCamera.DemosaicingMode].SetValue(PLCamera.DemosaicingMode.BaslerPGI);
// Configure noise reduction (if available)
camera.Parameters[PLCamera.NoiseReductionAbs].SetValue(0.2);
// Configure improved sharpness (if available)
camera.Parameters[PLCamera.SharpnessEnhancementAbs].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 */
/* Enable the PGI feature set (mono cameras only) */
errRes = PylonDeviceFeatureFromString(hdev, "PgiMode", "On");
CHECK(errRes);
/* Enable the PGI feature set (color cameras only) */
errRes = PylonDeviceFeatureFromString(hdev, "DemosaicingMode", "BaslerPGI");
CHECK(errRes);
/* Configure noise reduction (if available) */
errRes = PylonDeviceSetFloatFeature(hdev, "NoiseReductionAbs", 0.2);
CHECK(errRes);
/* Configure improved sharpness (if available) */
errRes = PylonDeviceSetFloatFeature(hdev, "SharpnessEnhancementAbs", 1.0);
CHECK(errRes);

# Enable the PGI feature set (mono cameras only)
camera.PgiMode.Value = "On"
# Enable the PGI feature set (color cameras only)
camera.DemosaicingMode.Value = "BaslerPGI"
# Configure noise reduction (if available)
camera.NoiseReductionAbs.Value = 0.2
# Configure improved sharpness (if available)
camera.SharpnessEnhancementAbs.Value = 1.0

dart Classic/E and pulse Cameras#

// Enable the PGI feature set with manual noise reduction
camera.PgiMode.SetValue(PgiMode_Manual);
// Configure noise reduction
camera.NoiseReduction.SetValue(0.2);
// Configure improved sharpness
camera.SharpnessEnhancement.SetValue(1.0);

INodeMap& nodemap = camera.GetNodeMap();
// Enable the PGI feature set with manual noise reduction
CEnumParameter(nodemap, "PgiMode").SetValue("Manual");
// Configure noise reduction
CFloatParameter(nodemap, "NoiseReduction").SetValue(0.2);
// Configure improved sharpness
CFloatParameter(nodemap, "SharpnessEnhancement").SetValue(1.0);

// Enable the PGI feature set with manual noise reduction
camera.Parameters[PLCamera.PgiMode].SetValue(PLCamera.PgiMode.Manual);
// Configure noise reduction
camera.Parameters[PLCamera.NoiseReduction].SetValue(0.2);
// Configure improved sharpness
camera.Parameters[PLCamera.SharpnessEnhancement].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 */
/* Enable the PGI feature set with manual noise reduction */
errRes = PylonDeviceFeatureFromString(hdev, "PgiMode", "Manual");
CHECK(errRes);
/* Configure noise reduction */
errRes = PylonDeviceSetFloatFeature(hdev, "NoiseReduction", 0.2);
CHECK(errRes);
/* Configure improved sharpness */
errRes = PylonDeviceSetFloatFeature(hdev, "SharpnessEnhancement", 1.0);
CHECK(errRes);

# Enable the PGI feature set with manual noise reduction
camera.PgiMode.Value = "Manual"
# Configure noise reduction
camera.NoiseReduction.Value = 0.2
# Configure improved sharpness
camera.SharpnessEnhancement.Value = 1.0

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