pylon Software Suite 26.08 リリースノート#
バイナリ互換性#
- Data Processing = 5.1.0
Data Processingの旧バージョンで構築されたアプリケーションとの互換性はありません。 - pylon C++ SDK = 12.0.0
pylon C++ SDK の 12.0.x またはそれ以前の 12.x.x バージョンで構築されたアプリケーションには互換性があります。 - pylon C SDK = 10.1.0
pylon C SDKのバージョン10.1.xまたはそれ以前の10.x.xバージョンで構築されたアプリケーションとの互換性があります。 - pylon .NET SDK = 9.0.0
旧バージョンの pylon .NET SDK で構築されたアプリケーションは互換性がありません。
新機能 / 変更点#
- pylon .NET SDK: [365532] .NET4アセンブリが新しいディレクトリ(/net4.0/)に移動されました。
- GigE: [341243] 複数のGigEカメラを同時に使用する場合の画像取得の信頼性が向上しました。ネットワーク高負荷時のパケットロスが削減され、不完全フレームやドロップフレームが減少します。
- GigE: [365929] パフォーマンスが向上した新しいpylon GigE Filter Driverバージョン5.6.0.1300。
- GigE: [341243] 複数のカメラから同時にストリーミングを行う際のGigE Visionフィルタードライバーのパフォーマンスが向上しました。ドライバーが受信パケットをより効率的に処理するため、CPUのオーバーヘッドが軽減され、高フレームレート時の信頼性が向上します。
- USB: [365927] pylon USB3 Vision Driverがバージョン11.4.0.1020にアップデートされました。
- 一般: [367333] CodeMeter Runtimeがバージョン8.41aにアップデートされました。
- pylon Viewer: [365978] 画像表示のフルスクリーンモードが改善されました。
- pylon Viewer: [366868] Line ProfileおよびHistogram機能の標準UIコントロールが、更新されたボタンとチェックボックスに置き換えられました。
- vTools: [364051] Geometric Pattern Matching Basic、Geometric Pattern Matching Pro、およびTemplate Matching Basicの各vToolsが拡張されました。マッチング結果の基準点に対する位置データ座標を出力できるようになりました。
- vTools: [363491,365717] ROI Creator vToolで、新しい画像のロード時やキャプチャ時に対象領域(ROI)が維持されるようになりました。画像の中央に位置し、画像の約85%をカバーするデフォルトのROIを復元するボタンが追加されました。
修正点#
- GigE: [366943] GigE Basler TLとGigE GenTLトランスポートレイヤーを介してカメラを並行してオープンしたときに、pylon SDKがクラッシュする原因となっていた問題を修正しました。
- USB: [360548] Basler USB3 Vision Driverに加えてlibusbがインストールされている場合に、ブルースクリーンエラーが発生する原因となっていた問題を修正しました。
- pylon C++ SDK: [363501] pylon Supplementary Package for MPEG-4を使用したMP4動画の記録における最大高さと最大幅が、コーデックがサポートする最大値(8191)に設定されました。
- pylon Viewer: [365670] pylon Viewerの起動前に有効にしていた場合でも、起動するたびに新機能のポーリングが無効になってしまう問題を修正しました。
- pylon Viewer: [348000] 画像取得の停止後、ステータスバーにfps値が表示されなくなりました。
- pylon Viewer: [365669] デバイスのリフレッシュを実行せずにUSBカメラを開いている状態、または開いている最中に、AUX電源モードとバスパワーモードの間で電源のON/OFFを繰り返すと、pylon Viewerが頻繁にクラッシュする問題を修正しました。
制限事項#
- pylon Viewer: Stereo ace 2カメラで取得した画像はまだ表示できません。
- pylon Viewer: Intel製HDグラフィックスカードを搭載したコンピューターでは、グラフィックスドライバを最新バージョンにアップデートする必要がある場合があります。
- pylon Viewer: コンピューターの負荷が非常に高い場合など、状況によっては、pylon Viewerでカメラがすでにオープンされている場合にColor Calibratorが動作しないことがあります。これを防ぐには、Color Calibratorを使用する前にカメラをクローズしてください。
- pylon Viewer: Color Calibratorは、すべてのBaslerカラーカメラをサポートしているわけではありません。カメラの機能セットの違いにより、Basler dartおよびboost Vカメラはサポートされていません。
- pylon Viewer: 全体的な安定性とパフォーマンスを向上させるため、pylon Viewerに新しいイメージスロットルが実装されました。これにより、pylon Viewerのビデオ録画機能に影響する新しい制限が導入されます。イメージングパイプラインにおいてカメラあたり毎秒250枚の画像のみが許可されるため、この制限を超えた場合にすべてのフレームを録画する機能が制限されます。
- Workbench: WorkbenchのStatistics機能は、vToolsの実行時間を測定します。Statistics機能で測定される時間は、システムの設定や全体的なCPU負荷によって異なる場合があります。これは、CPUが現在の負荷(動的周波数スケーリングなど)に応じて異なる周波数で動作する場合があるためです。
- Workbench: Workbenchでデータをアクティブに表示する複数のピンデータビューを使用すると、CPU負荷が増加し、全体的なパフォーマンスが低下する可能性があります。Baslerでは、可能な限り使用するピンデータビューを減らすことを推奨しています。
- 3D: Stereo ace 3Dカメラを使用するには、pylon Supplementary Package for Stereo aceのインストールが必要です。pylon Supplementary Package for Stereo aceは、Baslerウェブサイトからダウンロードできます。
- 3D: Basler blaze 3Dカメラを使用するには、pylon Supplementary Package for blazeのインストールが必要です。pylon Supplementary Package for blazeは、Baslerウェブサイトからダウンロードできます。
- 3D: Stereo mini 3Dカメラを使用するには、pylon Supplementary Package for Stereo miniのインストールが必要です。pylon Supplementary Package for Stereo miniは、Baslerウェブサイトからダウンロードできます。
- 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機能を無効にしてから録画を開始します。
- 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」を「オフ」に設定します。
- 次のコマンドを実行して、高度な設定を有効にします。
- GenTL: GenTLバージョン1.4以前のプロデューサーに対するGenTLサポートは制限されています。
- GigE: Baslerのace 2 5GigEおよび1GigEカメラを最適に活用するために、BaslerではデュアルチャンネルDDR4-3600 RAM以上の使用を推奨しています。より低速なRAMを使用すると、バッファアンダーランや画像損失が発生する可能性があります。さらに、pylon GigE Configuratorツールを使用してセットアップ全体を最適化することを推奨しています。
- pylon C++ SDK: InstantCameraArrayクラスは、最大21台のカメラから画像を取得できます。
- GigE: IP Configuratorツールでは、1つのネットワークインターフェイス上の複数のIP設定は完全にはサポートされていません。
- GigE: エラーメッセージ「Failed to allocate resources.」が表示された場合、NICとカメラのIP設定を最適化するためにpylon GigE Configuratorツールを使用することをBaslerはお勧めします。
- pylon C++ SDK: 一部のace 2カメラでは、イベント通知に通常の列挙型の代わりにブール値パラメータを使用する場合があります。この問題に対処するには、次のコードスニペットを使用できます。C++の場合は、camera.EventNotification.TrySetValue(EventNotification_On);に加えて、CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);を使用できます。
- pylon C++ SDK: Visual Studio 2017を使用している場合、MSB4211警告が表示されることがあります。この警告を削除するには、ReleaseおよびDebugプロジェクトのプロパティ([構成プロパティ] -> [全般] -> [Windows SDKバージョン])でWindows SDKのバージョンを指定してください。
- pylon C++ SDK: CMakeを使用してサンプルをビルドする際、オペレーティングシステムのパス長の制限に達する場合があります。パスが最大パス長である260文字を超えていることを示すビルドエラーが発生する可能性があります。これは、CMakeのビルドディレクトリの絶対パスが80文字を超える場合に発生する可能性があります。ビルドディレクトリは、現在の作業ディレクトリ、またはcmakeを呼び出すときに「-B」オプションで指定したディレクトリです。このエラーが発生した場合は、ユーザープロファイル内(C:\Users\など)に直接配置するなど、80文字を超えない短いパスを持つビルドディレクトリを使用してください。
\Samples。Windows 10バージョン1607以降では長いパスを有効にすることができます。詳細については、Microsoftのドキュメントを参照してください。 - GenTL/GigE: GigE Vision用GenTL Producerはアクションコマンドをサポートしていません。
- pylon C SDK: pylon C APIは、まだGenDCおよびBasler blaze 3Dカメラを使用するための便利な機能を提供していません。
- pylon C SDK: GenTL Consumerを使用する場合(CoaXPressなど)、ストリーミングを明示的に開始および停止できるようにするために、追加の機能がpylon Cに追加されました。この機能は、まだpylon Cプログラマーズガイドに記載されていません。pylon C++プログラマーズガイド(「Migrating from Previous Versions - Changes in the IStreamGrabber API」の章を参照)またはpylonC OverlappedGrabプログラミングサンプルを参照してください。
- 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デバッガーのオプションでマネージ互換モードを有効にしてください。
- CXP12-IC-1C: ラインスキャンアプレットの場合、ライン周期とライン露光の範囲が正しく処理されません。最大値が想定よりも小さくなる場合があります。
- iF2D100: アプレットは、最大8192バイトのCXPパケットサイズのみをサポートします。
- GenTL/CXP: SDKが次の接続用に設定されている場合:
pylon Event Logger、初期化直後にロギングを閉じるとデッドロックが発生する可能性があります。一般的なシナリオには次のようなものがあります:(1)Fg_FreeLibraries()直後にFg_InitLibraries()の呼び出し。(2)Fg_...を使用した明示的なライフタイム管理を行わないFg_InitLibraries()およびFg_FreeLibraries()関数の呼び出し。(3)GCCloseLib()直後にGCInitLib()を通じた明示的なライフタイム管理なしで関数が実行されます。 - 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: コンピューターにpylonとFramegrabber SDKの両方がインストールされている場合、pylonのインストール時にCXPオプションの選択を解除することをBaslerはお勧めします。競合するCXPプロデューサーに起因する問題を回避するため、pylonまたはFramegrabber SDKのいずれかがBaslerフレームグラバーおよび/またはインターフェイスカードの操作を担当する必要があります。
- 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 が低下し、画像の損失が発生する可能性があります。
- CXP12-IC-1C: 1つのポートでCXPリンク速度が頻繁に変更されると、速度変更が機能しなくなることがあります。その場合、「Failed to set bitrate of uplink transceivers」および「Failed to set bitrate of downlink transceivers」というエラーメッセージがログに記録されます。カメラの検出では未接続のポートもプローブしてリンク速度を変更するため、アプリケーションが未接続ポートで新しいカメラの検出を頻繁に試行すると、この問題が発生する可能性があります。
- vTools: レシピに Color Classifier vTool と1つ以上の Region vTools(Region Morphology、Region Selection、Region Feature Extraction)が含まれている場合、Blob Analysis Basic ライセンスと Color Blob Analysis Basic ライセンスの両方が購入対象としてリストされます。
- vTools: レシピに Measurements Basic vTool と1つ以上の Measurements Pro vTools が含まれている場合、Measurements Basic ライセンスと Measurements Pro ライセンスの両方が購入対象としてリストされます。
ダウンロード#
このバージョンの pylon Software Suite はここからダウンロードできます。