カメラvTool#

Camera vToolは、カメラデバイスへの便利なアクセスを提供します。

カメラの割り当て#

Camera vToolは、特定のカメラのプロパティを定義していない場合、使用可能なカメラをランダムに割り当てます。このため、シングルカメラ設計では、すぐに起動して実行できます。

マルチカメラ設計で特定のカメラをCamera vToolに割り当てたい場合は、次のセクションをお読みください。

Camera vToolの使用ダイアログ#

Baslerでは、Camera vToolダイアログを使用してカメラをCamera vToolに割り当てることを推奨します。

これを行うには：

1. ペインの レシピ管理 エリア内の vTool設定 ペインで、 [Open Settings]をクリックするか、 または、vToolをダブルクリックします。
   
2. 割り当てるカメラを選択し、をクリックします。 割り当て.
   カメラ名の横に緑色のチェックマークが表示されます。これは、カメラが現在vToolに割り当てられていることを示します。
   

また、ダイアログには、デバイスを識別するために使用されたプロパティが表示されます。例外的に、これらのプロパティの編集が必要になる場合があります。実行するには、[機能]ペインを使用します。

[機能]ペインの使用#

[機能]ペインを使用して、カメラをCamera vToolに割り当てることもできます。

これは、物理的なカメラをコンピューターに接続せずにカメラの割り当てを表示または変更する場合など、例外的な使用でのみ必要になります。

[機能]ペインを使用して特定のカメラを割り当てるには、次の手順を実行します。

1. Workbenchで[Camera vTool]を選択します。
2. [Features - All]ペインを開きます。
3. [vTool] > [Device Enumeration Control] > [Device List Update] > [Execute]をクリックして、利用可能なカメラを一覧表示します。
4. [Device Selector]パラメーターを使用して、使用可能なカメラを参照します。
   これにより、個々のカメラに関する特定の情報を確認し、目的のカメラの選択に役立てることができます。
5. 目的のカメラを特定したら、[Device Choose] > [Execute]をクリックし、特定のカメラをCamera vToolに割り当てます。

6. 割り当てるカメラが一致する必要があるデバイスプロパティをさらに指定するには、[vTool] > [Device Enumeration Control]グループの[Device Property *]を使用します。

   情報

   デバイス情報プロパティの詳細については、「pylon C++APIのCDeviceInfoクラスとPylon/Key名前空間」のドキュメントを参照してください。これにより、カメラの選択を細かく制御でき、正しいカメラを使用して複数のコンピュータで同じレシピを実行できます。

   複数のカメラがシステムに接続されている場合、Baslerは、[DeviceClass]プロパティと[UserDefinedName]プロパティの使用をお勧めします。まず、カメラの[DeviceUserID]パラメーターを設定してから、[UserDefinedName]プロパティを使用してカメラを選択する必要があります。

   新しく設定された[DeviceUserID]を使用できるようにするには、USBカメラをリセットまたは電源を入れ直す必要があることに注意してください。

カメラの設定#

カメラにカメラをCamera vToolに割り当てた後、Workbenchツールバーの[リソースのロック]ボタンをクリックし、割り当てられたカメラデバイスとの排他的接続を確立します。

[Features - All]ペインでカメラを設定できるようになりました。

レシピへのカメラの設定の保存#

Camera vToolに割り当てられたカメラデバイスが、レシピ保存時に接続されていないか、カメラデバイスの設定がその間に別のプログラムによって変更されている可能性があるため、レシピの保存時にカメラの設定は自動的に保存されません。

Instead, use the parameters in the Features - All pane under vTool > Configuration Set Persistence to save the settings of a camera device and accompanied settings after you have configured the parameters.

カメラ設定をレシピに保存するには：

1. Click the Workbenchツールバーの[Lock Resources]をクリックし、 button in the Workbench toolbar to establish an exclusive connection to the camera device assigned.
   
2. [Features - All]ペインで、[Configuration Set Persistence]カテゴリを開き、[Configuration Set Selector]パラメーターを[Camera]に設定して、カメラデバイスのパラメーターセットを選択します。
3. [Configuration Set Fetch]をクリックして、カメラデバイスから設定を取得し、[Configuration Set Staged]パラメーターに保存します。

4. Optional: You can inspect or manually modify the parameter settings by copying the text to a text editor and back into Configuration Set Staged.
   In the text editor, you will see that each line of text contains the name and the value of a parameter separated by a tab or = character. Lines starting with # are treated as comments. A configuration set must start with the following line:
   # {05D8C294-F295-4dfb-9D01-096BD04049F4}

   情報

   または、ユーザーセットを使用し、カメラ設定を永続的に保存することもできます。

5. [Configuration Set Commit]をクリックしてパラメーターを適用し、パラメーターをレシピ設定に保存します。これにより、リソースのロック操作が実行されるたびに、パラメーターが自動的に設定されます。

   情報

   カメラがすでに割り当てられている場合は、パラメーター設定は直ちにカメラに転送されます。転送に失敗した場合、パラメーター設定は[Configuration Set Active]に保存されません。カメラが割り当てられていない場合、設定は割り当て時にカメラに転送されます。この転送が失敗した場合、レシピは開始できません。

   [Camera Instance]設定セットにあるパラメーターなど、一部のカメラパラメーターは、カメラが閉じている間にのみ変更できます。この場合、[Configuration Set Active]に保存されているパラメーターは、カメラを開く前に割り当てられている場合にカメラに転送されます。

6. レシピからパラメーター設定をクリアするには、[Clear Data]をクリックします。

Using Event Notifications and Chunk Data#

The Camera vTool also allows you to access event and chunk data of the camera. You can add additional output pins for events and chunk data to use these to control your application. Camera events, e.g., exposure end, can be used to control external devices. Chunk data, e.g., timestamp or exposure time, can be used to control and synchronize tasks in an application.

Accessing Camera Events#

1. Enable the desired event on the camera.
2. Workbenchで[Camera vTool]を選択します。
3. [Features - All]ペインを開きます。
4. Go to the vTool > Event Output Control group.
5. Execute the Event Pin Add command.
6. ペインの Event Pin Configuration field, enter the configuration of the event pin you want to add. Use the following syntax:
   <MyPinName>.Type=Integer.EventName=<CameraEvent>.ValueName=<CameraEventValue>
   ここで、
   <MyPinName>: Name of the new output pin
   Type: Value type of the event you want to access
   EventName: Event you want to access
   <CameraEvent>: Name of the event as in the camera
   ValueName: Value of the event you want to access, e.g., ExposureEnd
   <CameraEventValue>: Name of the event value as in the camera, e.g.,EventExposureEnd
7. Press Enter.
   The new pin appears in the vTool.

Accessing Chunk Data#

1. Enable the chunk mode and the desired data chunk on the camera.
   
2. Workbenchで[Camera vTool]を選択します。
3. [Features - All]ペインを開きます。
4. Go to the vTool > Chunk Data Output Control group.
5. Execute the Chunk Pin Add command.
6. ペインの Chunk Pin Configuration field, enter the configuration of the data chunk pin you want to add. Use the following syntax:
   <MyPinName>.Type=Float.ValueName=<ChunkName>
   ここで、
   <MyPinName>: Name of the new output pin
   Type: Value type of the chunk data you want to access
   ValueName: Data chunk you want to access
   <ChunkName>: Name of the chunk as in the camera, e.g., ChunkExposureTime
7. Press Enter.
   The new pin appears in the vTool.

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

出力#

画像#

カメラによって取得された画像を返します。この出力画像は、画像を入力として受け入れるすべてのvToolが使用できます。

• データ型：Image
• 画像形式：カメラで構成されたとおり

関連するvTools#

典型的な後継機#

• 較正vTool
• Relative Thresholding vTool
• Auto Thresholding vTool
• Absolute Thresholding vTool
• 色分類子vTool
• バーコードリーダーvTool
• Data Matrix Code Reader vTool
• QR Code Reader vTool
• Measurements Basic vTool
• Geometric Pattern Matching vTool