カメラのエミュレーション#

カメラエミュレーション機能を使用すると、物理的なカメラデバイスをコンピューターに接続しなくても、基本的なカメラ機能をテストしたり、テスト画像を作成したりできます。

カメラエミュレーションデバイスには、pylon APIやpylon Viewerを使用してアクセスできます。

概要#

GigE VisionやUSB3 Visionのようなカメラトランスポート層に加えて、pylonはシンプルなカメラエミュレーションデバイスを作成できるトランスポート層を提供してします。これにより、物理的なカメラを必要とせずにアプリケーションを開発できます。また、マルチカメラアプリケーションを開発したい場合や、手元に十分なカメラがない場合にも便利です。

最大256個のカメラエミュレーションデバイスを作成できます。

カメラエミュレーションデバイスには、画像取得と標準カメラ機能のエミュレーションに加え、次のような物理的なカメラにはない機能もあります。

• 画像処理アルゴリズムを最適化するなどの目的で、カスタム試験画像を表示できます。
• 失敗したバッファーを生成して、例外処理ルーチンをテストすることができます。

カメラエミュレーションの有効化#

カメラエミュレーションは、pylon Viewer、pylon APIの、またはその両方で有効にできます。

カメラエミュレーションサポートのインストール#

• pylon for Linuxを使用している場合、カメラエミュレーションサポートはデフォルトでインストールされます。
• pylon for Windowsを使用していて、ランタイム再頒布可能パッケージを介してpylonをインストールした場合、カメラエミュレーションサポートはデフォルトでインストールされます。
• Windows用pylonを使用しており、pylon Software Suiteインストーラー経由でpylonをインストールしている場合：
  • インストール時にCamera UserまたはDeveloperプロファイルを選択した場合、カメラエミュレーションサポートはデフォルトでインストールされます。
  • インストール時にCustomプロファイルを選択した場合、カメラエミュレーションサポートはCamera Emulation Supportオプションを選択した場合にのみインストールされます。選択しなかった場合は、インストーラーを再度実行して、そのオプションを選択してください。

pylon Viewerでカメラエミュレーションを有効にする#

pylon Viewerでカメラエミュレーションを有効にするには：

1. カメラエミュレーションサポートがインストールされていることを確認します。
2. pylon ViewerのToolsメニューで、Optionsをクリックします。
3. Optionsダイアログで、Camera Emulationをクリックします。
4. Camera Emulationページで、必要なカメラエミュレーションデバイスの数を入力し、OKをクリックします。
   少し待つと、エミュレーションデバイスがDevicesペインに表示されます。
   pylon Viewerを使用してアクセスできます。pylon API内のデバイスにもアクセスする場合は、以下の手順に従います。

pylon APIでカメラエミュレーションを有効にする#

pylon APIでカメラエミュレーションを有効にするには：

1. カメラエミュレーションサポートがインストールされていることを確認します。
2. 次を追加します。 システム環境変数 名前： PYLON_CAMEMU 、その値を希望するエミュレーションデバイスの数に設定します。
   例： PYLON_CAMEMU=2
   これにより、2つのエミュレーションデバイスが提供されます。
   これらはpylon APIを使用してアクセスできます。pylon Viewerでもデバイスにアクセスする場合は、以下に従ってください。 上記の手順.

標準的なカメラ機能#

カメラエミュレーションデバイスは、次の標準カメラ機能をエミュレートできます。

• Acquisition Frame Rate
• Acquisition Status
• Device Information Parameters
• Exposure Mode
• Exposure Time
• Gain
• Image ROI
• Pixel Format
• 結果として得られるAcquisition Frame Rate
• Test Images
• トリガー画像取得

追加機能#

次の機能は、カメラエミュレーションデバイスのみで使用でき、物理的なBaslerカメラでは使用できません。

カスタムTest Imagesの表示#

標準の試験画像の表示に加えて、カメラエミュレーションでは、ディスクからロードされたカスタム試験画像を表示できます。

カスタム試験画像を表示するには：

1. パラメーターを TestImageSelector パラメータを Off.
   これにより、標準の Test Images の使用が無効になります。
2. パラメーターを ImageFileMode パラメータを On.
   これにより、カスタムの Test Images の使用が有効になります。
3. を表示する場合 単一の Test Images、画像ファイル名をフルパスで指定します。 ImageFilename パラメータ。
   例： c:\images\my-test-image.png

4. 複数の試験画像を表示する場合は、次の手順に従います。

   1. すべての試験画像が1つのディレクトリーに表示されるように配置します。
      ディレクトリーにサブディレクトリーを入れないでください。
   2. ファイルが含まれているディレクトリのフルパスを指定します。 ImageFilename パラメータ。
      例： c:\images\

5. Test Imagesを表示するには、少なくとも1つの画像を取り込みます。pylon Viewerで画像を表示する場合は、ツールバーのシングルショットまたは連続撮影ボタンをクリックします。

トラブルシューティング#

• カスタムの Test Images が表示されない場合（つまり、表示された画像が真っ黒である場合）、pylonがファイルを読み込めませんでした。で指定したファイル名またはパスを確認してください。 ImageFilename パラメータ。ディレクトリ名を指定した場合は、そのディレクトリにサブディレクトリが含まれていないことを確認してください。
• カスタム試験画像がモノクロで表示されている場合は、カラーピクセルフォーマット（BGR／BGRA／RGB）に切り替えます。
• カスタムの Test Images がフルサイズで表示されない場合は、調整してください。 画像ROI パラメータ（Width, Height, OffsetXおよび OffsetYを使用します。
  画像が 4096 x 4096 より大きい場合：設定する前に Width および Height パラメータを確認し、 WidthMax および HeightMax パラメータの値が正しい最大画像サイズに調整されていることを確認してください。

失敗したバッファーの生成#

バッファーの強制失敗機能を使用すると、障害が発生したバッファーを生成して、不良なカメラ接続をシミュレートできます。これは、例外処理ルーチンをテストする場合などに便利です。

失敗したバッファーを生成するには：

1. 画像取得を開始します。
2. パラメーターを ForceFailedBufferCount パラメータに、生成する失敗したバッファの数を設定します。
3. 実行します： ForceFailedBuffer コマンド。
   これで、カメラエミュレーションデバイスによって破損した画像が生成されます。破損した画像の数は、次の値によって異なります。 ForceFailedBufferCount パラメータ。

外部リンク#

• Windowsでパスと環境変数を設定する方法 （Computer Hope)
• 方法：Linuxで環境変数を設定 (Dowd and Associates)

サンプルコード#

// ** Custom Test Images **
// Disable standard test images
camera.TestImageSelector.SetValue(TestImageSelector_Off);
// Enable custom test images
camera.ImageFileMode.SetValue(ImageFileMode_On);
// Load custom test image from disk
camera.ImageFilename.SetValue("c:\\images\\image1.png");
// ** Force Failed Buffer **
// Set the number of failed buffers to generate to 40
camera.ForceFailedBufferCount.SetValue(40);
// Generate 40 failed buffers
camera.ForceFailedBuffer.Execute();

INodeMap& nodemap = camera.GetNodeMap();
// ** Custom Test Images **
// Disable standard test images
CEnumParameter(nodemap, "TestImageSelector").SetValue("Off");
// Enable custom test images
CEnumParameter(nodemap, "ImageFileMode").SetValue("On");
// Load custom test image from disk
CStringParameter(nodemap, "ImageFilename").SetValue("c:\\images\\image1.png");
// ** Force Failed Buffer **
// Set the number of failed buffers to generate to 40
CIntegerParameter(nodemap, "ForceFailedBufferCount").SetValue(40);
// Generate 40 failed buffers
CCommandParameter(nodemap, "ForceFailedBuffer").Execute();

// ** Custom Test Images **
// Disable standard test images
camera.Parameters[PLCamera.TestImageSelector].SetValue(PLCamera.TestImageSelector.Off);
// Enable custom test images
camera.Parameters[PLCamera.ImageFileMode].SetValue(PLCamera.ImageFileMode.On);
// Load custom test image from disk
camera.Parameters[PLCamera.ImageFilename].SetValue("c:\\images\\image1.png");
// ** Force Failed Buffer **
// Set the number of failed buffers to generate to 40
camera.Parameters[PLCamera.ForceFailedBufferCount].SetValue(40);
// Generate 40 failed buffers
camera.Parameters[PLCamera.ForceFailedBuffer].Execute();

/* 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 */
/* ** Custom Test Images ** */
/* Disable standard test images */
errRes = PylonDeviceFeatureFromString(hdev, "TestImageSelector", "Off");
CHECK(errRes);
/* Enable custom test images */
errRes = PylonDeviceFeatureFromString(hdev, "ImageFileMode", "On");
CHECK(errRes);
/* Load custom test image from disk */
errRes = PylonDeviceFeatureFromString(hdev, "ImageFilename", "c:\\images\\image1.png");
CHECK(errRes);
/* ** Force Failed Buffer ** */
/* Set the number of failed buffers to generate to 40 */
errRes = PylonDeviceSetIntegerFeature(hdev, "ForceFailedBufferCount", 40);
CHECK(errRes);
/* Generate 40 failed buffers */
errRes = PylonDeviceExecuteCommandFeature(hdev, "ForceFailedBuffer");
CHECK(errRes);

# ** Custom Test Images **
# Disable standard test images
camera.TestImageSelector.Value = "Off"
# Enable custom test images
camera.ImageFileMode.Value = "On"
# Load custom test image from disk
camera.ImageFilename.Value = "c:\\images\\image1.png"
# ** Force Failed Buffer **
# Set the number of failed buffers to generate to 40
camera.ForceFailedBufferCount.Value = 40
# Generate 40 failed buffers
camera.ForceFailedBuffer.Execute()

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