pylon Software Suite 25.06 リリースノート#
バイナリ互換性#
- pylon C++ SDK = 10.3.0
pylon C++ SDK のバージョン 10.3.x またはそれ以前の 10.x.x バージョンで構築されたアプリケーションとの互換性があります。
新機能 / 変更点#
- vTools: [322976] Grid Creator vTool が追加されました。
- pylon Viewer: [336981] 3Dカメラの操作性が向上しました。
- pylon Viewer: [336090] 録画機能で、bmp、tif、png、jpeg、raw形式の静止画シーケンスの保存がサポートされるようになりました。
- pylon Viewer: [326399] 現在の画像をbmp、tif、png、jpeg、dng、raw形式で保存できるようになりました。
- pylon Viewer: [329111] Histogram および Line Profile 機能のパフォーマンスが向上しました。
- vTools: [335669, 335660, 337193, 334690] Histogram Extractor vTool が追加されました。このツールは画像からヒストグラムを抽出し、モノクロ画像の場合はモノチャンネルに、カラー画像の場合は適切なカラーチャンネルに配置します。
- vTools: [321505] Array Element Selector vTool が追加されました。Array Element Selector vToolを使用すると、配列の単一の要素を選択し、指定したインデックス位置のデータを出力できます。
修正点#
- pylon Viewer: [338283] Firmware Updaterにおけるスケーリングの問題が修正されました。
- pylon IP Configurator: [337978] フォントファミリーが正しく設定されない問題が修正されました。
- pylon C++ SDK: [329360] TriggerSelectorが新しい値に設定されている場合に、boost VカメラでInstantCameraオブジェクトのオープンが失敗することがある問題が修正されました。
- Doc: [313977] 特定のIPアドレスを持つGigEカメラのデバイスオブジェクトを作成するためのサンプルに、これまで欠落していたデバイスクラスが追加されました。
- vTools: [337959] コンソールメッセージを削除することにより、OPC UA Client vToolが改善されました。
- vTools: [334601] OPC UA Client vToolが新しい Interface グループに移動されました。
- vTools: [335779] レシピに入力ピンがない場合にサーバーアドレスが保存されない問題が修正されました。これにより、サーバーアドレスが常に保存されるようになります。
- PylonVToolCreatorRuntime: [336519] 領域メタデータを正しく設定できない問題が修正されました。
- vTools: [338632] Image Stitcher vToolの PaddingValue パラメータに関するドキュメントの記載漏れが追加されました。
- vTools: [338143] 設定の読み込みおよび保存時のスレッドセーフティが確保されました。
制限事項#
- Workbench: Workbenchでデータをアクティブに表示する複数のピンデータビューを使用すると、CPU負荷が増加し、全体的なパフォーマンスが低下する可能性があります。Baslerでは、可能な限り使用するピンデータビューを減らすことを推奨しています。
- Workbench: WorkbenchのStatistics機能は、vToolsの実行時間を測定します。Statistics機能で測定される時間は、システムの設定や全体的なCPU負荷によって異なる場合があります。これは、CPUが現在の負荷(動的周波数スケーリングなど)に応じて異なる周波数で動作する場合があるためです。
- pylon Viewer: 全体的な安定性とパフォーマンスを向上させるため、pylon Viewerに新しいイメージスロットルが実装されました。これにより、pylon Viewerのビデオ録画機能に影響する新しい制限が導入されます。イメージングパイプラインにおいてカメラあたり毎秒250枚の画像のみが許可されるため、この制限を超えた場合にすべてのフレームを録画する機能が制限されます。
- pylon Viewer: Color Calibratorは、すべてのBaslerカラーカメラをサポートしているわけではありません。カメラの機能セットの違いにより、Basler dartおよびboost Vカメラはサポートされていません。
- pylon Viewer: コンピューターの負荷が非常に高い場合など、状況によっては、pylon Viewerでカメラがすでにオープンされている場合にColor Calibratorが動作しないことがあります。これを防ぐには、Color Calibratorを使用する前にカメラをクローズしてください。
- pylon Viewer: Intel製HDグラフィックスカードを搭載したコンピューターでは、グラフィックスドライバを最新バージョンにアップデートする必要がある場合があります。
- pylon Viewer: Stereo ace 2カメラで取得した画像はまだ表示できません。
- pylon C++ SDK: CMakeを使用してサンプルをビルドする際、オペレーティングシステムのパス長の制限に達する場合があります。パスが最大パス長である260文字を超えていることを示すビルドエラーが発生する可能性があります。これは、CMakeのビルドディレクトリの絶対パスが80文字を超える場合に発生する可能性があります。ビルドディレクトリは、現在の作業ディレクトリ、またはcmakeを呼び出すときに「-B」オプションで指定したディレクトリです。このエラーが発生した場合は、ユーザープロファイル内(C:\Users\など)に直接配置するなど、80文字を超えない短いパスを持つビルドディレクトリを使用してください。
\Samples。Windows 10バージョン1607以降では長いパスを有効にすることができます。詳細については、Microsoftのドキュメントを参照してください。 - pylon C++ SDK: Visual Studio 2017を使用している場合、MSB4211警告が表示されることがあります。この警告を削除するには、ReleaseおよびDebugプロジェクトのプロパティ([構成プロパティ] -> [全般] -> [Windows SDKバージョン])でWindows SDKのバージョンを指定してください。
- pylon C++ SDK: 一部のace 2カメラでは、イベント通知に通常の列挙型の代わりにブール値パラメータを使用する場合があります。この問題に対処するには、次のコードスニペットを使用できます。C++の場合は、camera.EventNotification.TrySetValue(EventNotification_On);に加えて、CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);を使用できます。
- GigE: エラーメッセージ「Failed to allocate resources.」が表示された場合、NICとカメラのIP設定を最適化するためにpylon GigE Configuratorツールを使用することをBaslerはお勧めします。
- GigE: IP Configuratorツールでは、1つのネットワークインターフェイス上の複数のIP設定は完全にはサポートされていません。
- pylon C++ SDK: InstantCameraArrayクラスは、最大21台のカメラから画像を取得できます。
- GigE: Baslerのace 2 5GigEおよび1GigEカメラを最適に活用するために、BaslerではデュアルチャンネルDDR4-3600 RAM以上の使用を推奨しています。より低速なRAMを使用すると、バッファアンダーランや画像損失が発生する可能性があります。さらに、pylon GigE Configuratorツールを使用してセットアップ全体を最適化することを推奨しています。
- GenTL: GenTLバージョン1.4以前のプロデューサーに対するGenTLサポートは制限されています。
- USB: Basler U3Vデバイスが非同期化される可能性があるため、Intel製USBホストで使用されている電源管理をオフにする必要があります。この場合、システムの起動後にBasler U3Vデバイスが使用できなくなることがあります。次の手順に従って、USB3バスのLPMパッケージを無効にしてください。
- 次のコマンドを実行して、高度な設定を有効にします。
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - 電源オプションでLPM設定を変更します。
- コントロールパネルで電源オプションを開きます。
- 選択した電源プランの「プラン設定の変更」をクリックします。
- 「詳細な電源設定の変更」をクリックします。
- 「電源オプション」ダイアログの「詳細設定」タブで、「USB設定」を選択します。
- 「USB 3のセレクティブサスペンドの設定」または「USB 3 Link Power Management」を「オフ」に設定します。
- 次のコマンドを実行して、高度な設定を有効にします。
- MP4: MP4ビデオを録画するには、pylon Supplementary Package for MPEG-4がインストールされている必要があります。pylon Supplementary Package for MPEG-4は、Baslerウェブサイトからダウンロードできます。
- MP4: 解像度が20 MP以上のカメラでビデオファイルの録画を行う際、Qualityパラメータが80%以上に設定されていると、録画に失敗する場合があります。回避策として、Qualityパラメータをより低い値に設定してください。
- MP4: 録画機能は、ace 2 ProカメラのCompression Beyond機能をサポートしていません。録画が開始され、Compression Beyond機能が有効になっている場合、pylon ViewerはまずカメラのCompression Beyond機能を無効にしてから録画を開始します。
- 3D: Basler blaze 3Dカメラを使用するには、pylon Supplementary Package for blazeのインストールが必要です。pylon Supplementary Package for blazeは、Baslerウェブサイトからダウンロードできます。
- 3D: Stereo ace 3Dカメラを使用するには、pylon Supplementary Package for Stereo aceのインストールが必要です。pylon Supplementary Package for Stereo aceは、Baslerウェブサイトからダウンロードできます。
- vTools: 特定のデータ型の接続がレシピに保存されている場合、代替データ型は使用できなくなります。レシピを再読み込みして入力ピンへの元の接続を削除すると、入力ピンには元の接続のデータ型のみが提供されます。
- GenTL/GigE: GigE Vision用GenTL Producerはアクションコマンドをサポートしていません。
- GenTL/GigE: GigE Vision用GenTL Producerはマルチキャスト構成をサポートしていません。
- pylon .NET SDK: このバージョンの.NET APIにアップデートする場合、新しいアセンブリを参照するように.NETプロジェクトファイルをアップデートする必要があります。これは、VB2015の互換性修正(インターフェイスクラスBasler.Pylon.IParameterListEnumがrefクラスBasler.Pylon.ParameterListEnumに変更されたため)に起因します。
- pylon .NET SDK: .NETプロジェクトでネイティブデバッグが有効になっており、プロジェクトがpylonアセンブリを参照している場合、Visual Studio 2012またはVisual Studio 2013のデバッガーで実行するとアプリケーションがクラッシュする可能性があります。この問題を回避するには、Visual Studioデバッガーのオプションでマネージ互換モードを有効にしてください。
- CXP IC: ラインスキャンアプレットの場合、ライン周期とライン露光の範囲が正しく処理されません。最大値が想定よりも小さくなることがあります。
- GenTL/CXP: コンパイルがVisual Studio 2022で行われるようになったため、ライブラリをロードするにはVisual Studio 2022再頒布可能パッケージのインストールが必要です。
- GenTL/CXP: 実際のバッファサイズ制限は2 Gbitであるため、ProducerにおけるWidthおよびHeightの許容値に制限が課され、その結果、画像の最大サイズは2GBになります。
- GenTL/CXP: FPSの制限は、バッファ数と画像サイズに応じて50.000 fpsから90.000の間になります。より詳細な概算値として、10個のバッファと最小画像サイズ48x1では約50,000 FPSの制限になり、50個のバッファと最小画像サイズ48x1では約90,000 FPSの制限になり、50個のバッファと画像サイズ8192x1では約50,000 FPSの制限になります。
- GenTL/CXP: 画像取得中にカメラパラメータを変更した場合、その変更はフレームグラバーに反映されません。これは、GenTL Producerが取得の開始前に、関連するパラメータ(幅、高さ、画像フォーマットなど)を取得し、これらをフレームグラバーと同期させるためです。
- GenTL/CXP: GenTL標準によると、デバイスIDは2つのセッション間で一定である必要があります。しかし、アプレットを変更するとGenTLデバイスIDが変更されます。したがって、デバイスIDは、デバイスIDが生成されたアプレットと同じ名前を持つアプレットの場合にのみ再利用できます。
- GenTL/CXP: コンピューターにBasler Framegrabber SDKのバージョンがインストールされている場合、CoaXPressカメラおよびインターフェースカードを使用する際に非互換性の問題が発生する可能性があります。そのため、BaslerではFramegrabber SDKとpylonを並行してインストールしないことを推奨しています。
- GenTL/CXP: Linuxでセキュアブート(UEFIモード)を使用するには、信頼された証明書で署名されたドライバーが必要です。ドライバーはソースコードとして提供されるため、信頼されたBasler証明書で署名する方法はありません。ドライバーを使用するには、セキュアブートを無効にするか、次のUbuntuブログのエントリに記載されているようにドライバーに自己署名を適用してください。https://ubuntu.com/blog/how-to-sign-things-for- secure-boot
- GenTL/CXP: グラブに使用するバッファを割り当てる際、バッファアドレスは8バイト単位にアライメントされている必要があります。ヒープメモリを使用している場合、これは自動的に満たされます。
- GenTL/CXP: Basler CXP-12 Interface Card 1Cを使用して50000 fpsを超える非常に高いフレームレートでグラブすることはサポートされていません。
- GenTL/CXP: まれに、コンピューターの起動後にカメラが見つからないことがあります。これを解決するには、カメラの電源を入れ直してください。
- GenTL/CXP: カメラのDeviceUserIDが変更された場合、GenTL APIを介してその変更を反映させるには、GenTL Producerの再起動が必要です。GenTLを介してGUIでカメラと対話する場合(pylon Viewerなど)、変更を有効にするにはそのアプリケーションの再起動が必要です。
- GenTL/CXP: アプレットの変更中、インターフェイスカードに接続されているカメラはアクセスできなくなっているにもかかわらず、デバイスリストに表示され続けます。この状態でカメラを開こうとすると、エラーメッセージが表示されます。
- GenTL/CXP: DSGetBufferInfo経由でクエリ可能なGenTLの BUFFER_INFO_FRAME_ID には、CXPイメージヘッダーからのソースタグが含まれません。代わりに、コンピューターに配信されたすべてのフレームのカウンターが含まれます。
- GenTL/CXP: バッファオーバーフローが原因でインターフェースカード上で画像が失われた場合(ユーザーアプリケーションが画像を配信するためのバッファの(再)キューイングを十分な速度で行わない場合など)、失われた画像は次に配信されるバッファによって示されます。失われた画像は INCOMPLETE としてマークされ、ファイルサイズは 0 になり、カスタムエラーコード BUFFER_INFO_BASLER_XAPI_ERROR_CODE が 42 に設定されます。さらに、失われたフレームが1つストリーム情報に追加されます。なお、オーバーフローによって何フレーム失われたかに関係なく、追加される失われたフレームは常に正確に1つであることに注意してください。
- GenTL/CXP: Basler CXP-12 Interface Card 1C/2C/4C および imaWorx CXP-12 Quad キャプチャカードには、PCIe Gen 3 x8(Direct Memory Access)以上に対応するホストインターフェースが必要です。より低速なホストインターフェースを使用すると、カメラの Acquisition Frame Rate が低下し、画像の損失が発生する可能性があります。
ダウンロード#
このバージョンの pylon Software Suite はここからダウンロードできます。