カメラvTool#

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

Camera vToolを使用するには、pylon Software Suiteをダウンロードしてください。

カメラの割り当て#

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

代わりに、Features - All ペインの vTool > Configuration Set Persistence にあるパラメータを使用して、カメラデバイスの設定およびパラメータの設定完了後の関連設定を保存します。

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

1. Click the Workbenchツールバーの[Lock Resources]をクリックし、 Workbench ツールバーのボタンを使用して、割り当てられたカメラデバイスへの排他的接続を確立します。
   
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]をクリックします。

Event Notification と Chunk Data の使用#

Camera vTool を使用すると、カメラのイベントデータやチャンクデータにもアクセスできます。イベントやチャンクデータ用の出力ピンを追加して、これらを使用してアプリケーションを制御できます。露出終了などのカメライベントを使用して、外部デバイスを制御できます。Timestamp や Exposure Time などのチャンクデータを使用して、アプリケーション内のタスクの制御や同期を行うことができます。

カメライベントへのアクセス#

1. カメラで目的の event を有効にします。
2. Workbenchで[Camera vTool]を選択します。
3. [Features - All]ペインを開きます。
4. vTool > Event Output Control グループに移動します。
5. Event Pin Add コマンドを実行します。
6. ペインの Event Pin の設定 フィールドに、追加するイベントピンの設定を入力します。次の構文を使用します。
   <MyPinName>.Type=<MyPinType>.EventName=<CameraEvent>.ValueName=<CameraEventValue>
   ここで、
   <MyPinName>: 新しい出力ピンの名前
   <MyPinType>: アクセスするイベントのデータ型 (許可される値: Boolean、Float、Integer、String)
   <CameraEvent>: カメラにおけるアクセス対象のイベント名
   <CameraEventValue>: カメラにおけるイベント値の名前 (例: EventExposureEnd)
7. Enter キーを押します。
   新しいピンが vTool に表示されます。

設定例#

名前が ExposureEnd、データ型が Integer で、露出終了カメライベントからの情報を出力する出力ピンを作成すると仮定します。これを行うには、次の文字列を入力します。

ExposureEnd.Type=Integer.EventName=ExposureEnd.ValueName=EventExposureEnd

チャンクデータへのアクセス#

1. カメラで chunk mode および目的のデータチャンクを有効にします。
   
2. Workbenchで[Camera vTool]を選択します。
3. [Features - All]ペインを開きます。
4. vTool > Chunk Data Output Control グループに移動します。
5. Chunk Pin Add コマンドを実行します。
6. ペインの Chunk Pin の設定 フィールドに、追加するデータチャンクピンの設定を入力します。次の構文を使用します。
   <MyPinName>.Type=<MyPinType>.ValueName=<ChunkName>
   ここで、
   <MyPinName>: 新しい出力ピンの名前
   <MyPinType>: カメラ内でアクセスしたいチャンクデータの値の型
   <ChunkName>: カメラ内でアクセスしたいチャンクの名前（例：ChunkExposureTime）
7. Enter キーを押します。
   新しいピンが vTool に表示されます。

設定例#

カメラの Exposure Time チャンクからの情報を出力する、データ型が Integer で ExposureTimeChunk という名前の出力ピンを作成すると仮定します。これを行うには、次の文字列を入力します。

ExposureTimeChunk.Type=Float.ValueName=ChunkExposureTime

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

出力#

画像#

カメラによって取得された画像を返します。この出力画像は、画像を入力として受け入れるすべての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