pylon Software Suite 26.04 リリースノート#
バイナリ互換性#
- Data Processing = 4.1.2
Data Processingの4.1.xまたはそれ以前の4.x.xバージョンで構築されたアプリケーションと互換性があります。 - pylon C++ SDK = 11.5.0
pylon C++ SDKの11.5.xまたはそれ以前の11.x.xバージョンで構築されたアプリケーションと互換性があります。 - pylon C SDK = 10.1.0
pylon C SDKの10.1.xまたはそれ以前の10.x.xバージョンで構築されたアプリケーションは互換性があります。 - pylon .NET SDK = 9.1.0
pylon .NET SDKの9.1.xまたはそれ以前の9.x.xバージョンで構築されたアプリケーションとは互換性がありません。
新機能 / 変更点#
- 全般: [345556] pylonがBasler Stereo miniカメラモデルをサポートするようになりました。
- pylon C++ SDK: [345556] Basler Stereo miniカメラなどの複数のソース(センサー)をサポートするカメラについて、コンポーネントのソースをクエリできるようにCPylonDataComponent::GetSourceId()関数を追加しました。
- pylon .NET SDK: [345556] Basler Stereo miniカメラなどの複数のソース(センサー)をサポートするカメラについて、コンポーネントのソースをクエリできるように、DataComponentクラスにSourceId Propertyを拡張しました。
- pylon Viewer: [353958] Stereo miniカメラのサポートを追加しました。
- pylon Viewer: [356546] ウェルカムダイアログが再設計されました。
- pylon Viewer: [355094] FeaturesペインのvToolルートノードが自動的に展開されるようになりました。
- Workbench: [349127] Recipe ManagementペインにLicenseタブを追加しました。vToolについてBasler Salesにお問い合わせの際に共有できる便利なライセンス情報が表示されます。
- vTools: [313321] ユーザーエクスペリエンスを向上させ、Measurements BasicおよびRectangle Measurements Pro vToolsにRectangle入力ピンを追加しました。
- vTools: [356715] すべてのMatching vToolsにAlignment Transformation Output機能を追加しました。これにより、アライメント変換データが最初の一致に対してのみ単一の値として出力されるか、検出されたすべての一致に対して配列として出力されるかを指定できます。この機能が存在する前に作成されたレシピには、デフォルトで単一の値(Single Value)の動作が割り当てられます。これは後で変更できます。
- vTools: [297188] Geometric Pattern Matching vToolのティーチング用の新しい開発者向けサンプルを追加しました。
- vTools: [300360] Calibration vToolのティーチング用の新しい開発者向けサンプルを追加しました。
- vTools: [356715] Template Matching Starter vToolにAlignment Transformation Output機能を追加しました。これにより、アライメント変換データが最初の一致に対してのみ単一の値として出力されるか、検出されたすべての一致に対して配列として出力されるかを指定できます。この機能が存在する前に作成されたレシピには、デフォルトで単一の値(Single Value)の動作が割り当てられます。これは後で変更できます。
- vTools: [358796] Demultiplexer vToolを追加しました。これにより、1つの入力ソースからの受信データアイテム(更新)を1つまたは複数の出力ピンに送信できるようになります。
修正点#
- Data Processing: [358028] スマートインスタントカメラが画像制限に達したとき、または取得スレッドがエラーで終了したときにアプリケーションがハングする問題を修正しました。
- pylon Viewer: [356481] vToolのFeatures - Allペインで列のサイズを変更する際に、FeatureおよびValue列が可視領域の外に移動してしまう問題を修正しました。
- pylon Viewer: [356546] ウェルカムダイアログ内のリンクが正しく機能しない問題を修正しました。
- pylon Viewer: [359830] Firmware Updaterでカメラを開いたときにpylon Viewerがクラッシュする原因となる問題を修正しました。
- pylon Viewer: [349493] 一部のaceカメラでチャンクデータがFeaturesペインに表示されない問題を修正しました。
- Workbench: [356486] 汎用vTool設定ダイアログでのツールチップの位置が正しくない問題を修正しました。
制限事項#
- 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のビデオ録画機能に新しい制限が導入されます。イメージングパイプラインにおいてカメラあたり1秒間に250枚の画像のみが許可されるため、この制限を超えた場合にすべてのフレームを録画する機能が制限されます。
- Workbench: WorkbenchのStatistics機能は、vToolsの実行時間を測定します。Statistics機能で測定された時間は、システムの構成や全体的なCPU負荷によって異なる場合があります。これは、CPUが現在の負荷に応じて(動的な周波数Scalingなどにより)異なる周波数で動作する場合があるためです。
- Workbench: Workbench上でデータをアクティブに表示するピンデータビューを複数使用すると、CPU負荷が上昇し、全体的なパフォーマンスが低下する可能性があります。可能な限り、使用するピンデータビューの数を少なくすることをBaslerでは推奨しています。
- pylon C++ SDK: GenICam File Access機能を使用してGigEカメラからファイルをダウンロードする際、ファイルサイズが4で割り切れない場合、現在0バイトのファイルがダウンロードされます。これにより、ユーザーデータ(例:Vignetting Correctionデータ、Shading Correctionデータ、3Dデータなど)を含むキャリブレーションおよび設定ファイルで特に問題が発生する可能性があります。
- 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デバイスが非同期化される可能性があるため、インテル製USBホストで使用される電源管理はオフにする必要があります。この場合、システムの起動後にBasler U3Vデバイスを使用できなくなることがあります。次の手順に従って、USB3バス上のLPMパッケージを無効にしてください。
- 次のコマンドを実行して、高度な設定を有効にします。
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - 電源オプションでLPM設定を変更します。
- コントロールパネルで[電源オプション]を開きます。
- 選択した電源プランの[プラン設定の変更]をクリックします。
- [詳細な電源設定の変更]をクリックします。
- [電源オプション]ダイアログの[詳細設定]タブで、[USB 設定]を選択します。
- [USB のセレクティブ サスペンドの設定](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: 1つのネットワークインターフェイス上の複数のIP設定は、IP Configuratorツールでは完全にサポートされていません。
- 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' オプションで指定されたディレクトリです。このエラーが発生した場合は、80 文字を超えない短いパスのビルド ディレクトリを使用してください。たとえば、ユーザー プロファイル C:\Users\ に直接配置します。
\Samples。Windows 10、バージョン1607以降では、長いパスを有効にすることができます。詳細については、Microsoftのドキュメントを参照してください。 - GenTL/GigE: GigE Vision 用の GenTL プロデューサーは、アクション コマンドをサポートしていません。
- pylon C SDK: pylon C API には便利な関数がありませんGenDC そして、Basler Blaze 3Dカメラはまだです。
- pylon C SDK: GenTL Consumer (CoaXPress など) を使用する場合、ストリーミングの開始と停止を明示的に行えるように、pylon C に機能が追加されました。この機能は、pylon C プログラマーズ ガイドにはまだ記載されていません。pylon C++ プログラマーズ ガイド (「以前のバージョンからの移行 - IStreamGrabber API の変更点」の章を参照) または pylonC OverlappedGrab プログラミング サンプルを参照してください。
- pylon .NET SDK:このバージョンの .NET API に更新するには、.NET プロジェクト ファイルを更新して新しいアセンブリを参照する必要があります。これは、VB2015 との互換性修正 (インターフェース クラス Basler.Pylon.IParameterListEnum が参照クラス Basler.Pylon.ParameterListEnum に変更された) のためです。
- pylon .NET SDK: .NET プロジェクトでネイティブ デバッグが有効になっており、かつプロジェクトが pylon アセンブリを参照している場合、Visual Studio 2012 または Visual Studio 2013 デバッガーで実行するとアプリケーションがクラッシュする可能性があります。この問題を回避するには、Visual Studio デバッガーのオプションでマネージド互換モードを有効にしてください。
- CXP12-IC-1C:ラインスキャンアプレットの場合、ライン周期とライン露光の範囲が正しく処理されません。最大値が予想よりも小さくなる可能性があります。
- GenTL/CXP:コンパイルはVisual Studio 2022で行われるようになったため、ライブラリをロードするにはVisual Studio 2022の再頒布可能パッケージのインストールが必要になります。
- GenTL/CXP:実際のバッファサイズの制限は2 Gbitであるため、プロデューサーで許容される幅と高さの値に制限が課され、結果として画像の最大サイズは2GBになります。
- GenTL/CXP:フレームレートの制限は、バッファ数と画像サイズによって 50,000 fps から 90,000 fps までです。より詳細な概算値としては、バッファ 10 個と最小画像サイズ 48x1 の場合、制限は約 50,000 FPS、バッファ 50 個と最小画像サイズ 48x1 の場合、制限は約 90,000 FPS、バッファ 50 個と画像サイズ 8192x1 の場合、制限は約 50,000 FPS となります。
- GenTL/CXP:画像取得中にカメラパラメータが変更されても、フレームグラバーにその変更が反映されません。これは、 GenTL Producer 取得を開始する前に、関連するパラメータ(幅、高さ、画像フォーマットなど)を取得し、これらをフレームグラバーと同期します。
- GenTL/CXP: GenTL規格では、デバイスIDはセッション間で一定であるべきです。しかし、アプレットが変更されるとGenTLデバイスIDも変更されます。そのため、デバイスIDを再利用できるのは、デバイスIDが生成されたアプレットと同じ名前のアプレットを使用する場合に限られます。
- GenTL/CXP:パイロンとFramegrabber SDK 両方ともコンピュータにインストールされている場合、Basler は pylon インストールで CXP オプションの選択を解除することを推奨します。競合する CXP プロデューサーに起因する問題を回避するために、pylon またはFramegrabber SDK Basler製フレームグラバーおよび/またはインターフェースカードの操作を担当するべきである。
- GenTL/CXP:セキュアブート (UEFI モード) を使用するLinux 信頼できる証明書で署名されたドライバが必要です。ドライバはソースコードとして提供されているため、信頼できるBasler証明書で署名する方法はありません。ドライバを使用するには、セキュアブートを無効にする必要があります。または、Ubuntuブログのこちらの記事( https://ubuntu.com/blog/how-to-sign-things-for-secure-boot )で説明されているように、ドライバを自己署名することもできます。
- GenTL/CXP:グラブに使用するバッファを割り当てる場合、バッファのアドレスは8バイト単位でアラインメントされている必要があります。ヒープメモリを使用する場合は、これは自動的に行われます。
- GenTL/CXP: Baslerを使用して50000fpsを超える非常に高いフレームレートでグラブCXP-12 Interface Card 1C サポートされていません。
- GenTL/CXP:まれに、コンピュータの起動後にカメラが認識されない場合があります。この場合は、カメラの電源を入れ直してください。
- GenTL/CXP:カメラの DeviceUserID が変更されると、 GenTL Producer GenTL API を介して変更を反映させるには、これが必要です。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:バスラーCXP-12 Interface Card 1C /2C/4CとimaWorx CXP-12 Quad 取得カードにはホストインターフェースが必要で、 PCIe 第3世代x8(ダイレクトメモリアクセス)以上のホストインターフェースが必要です。これより低速なホストインターフェースを使用すると、カメラの取得フレームレートが低下し、画像が失われる可能性があります。
- CXP12-IC-1C: CXPリンク速度を1つのポートで頻繁に変更すると、速度変更が機能しなくなる場合があります。その場合、「アップリンクトランシーバーのビットレート設定に失敗しました」および「ダウンリンクトランシーバーのビットレート設定に失敗しました」というエラーメッセージがログに記録されます。カメラ検出は未接続ポートをプローブしてリンク速度を変更するため、アプリケーションが未接続ポートで新しいカメラを頻繁に検出しようとすると、この問題が発生する可能性があります。
- vTools:レシピに以下が含まれている場合Color Classifier vTool と 1 つ以上のリージョン vTool ( Region Morphology 、 Region Selection 、 Region Feature Extraction )、 Blob Analysis Basic ライセンスはカラーと同様に購入可能ですBlob Analysis Basic ライセンス。
- vTools:レシピに以下が含まれている場合Measurements Basic vTool および Measurements Pro vTool の 1 つ以上、 Measurements Basic Measurements Proのライセンスと同様に、ライセンスも購入可能です。
ダウンロード#
このバージョンのpylon Software Suite ここ。