コンテンツにスキップ
ステージングサーバー
開発サーバー

pylon Software Suite 25.07 リリースノート#

リリース日：2025-07-14

バイナリ互換性#

  • pylon C++ SDK = 10.3.2
    pylon C++ SDKのバージョン10.3.xまたはそれ以前の10.x.xでビルドされたアプリケーションとの互換性があります。
  • pylon .NET SDK = 9.0.0
    旧バージョンの pylon .NET SDK で構築されたアプリケーションは互換性がありません。
  • pylon C SDK = 10.0.0
    pylon C SDKのバージョン10.0.xまたはそれ以前の10.x.xでビルドされたアプリケーションとの互換性があります。
  • Data Processing = 3.3.0
    Data Processingのバージョン3.3.xまたはそれ以前の3.x.xでビルドされたアプリケーションとの互換性があります。

新機能 / 変更点#

  • vTools: [340937] すべての Starter vTools がライセンスなしで使用できるようになりました。
  • PylonEventLogger: [337087] フィルターのインポート時に、すでに存在するフィルターが除外されるようになりました。
  • vTools: [338376] Histogram Statistics vTool が追加されました。このツールはヒストグラムを分析し、最小値、最大値、中央値、平均値、標準偏差、値の総数を取得します。
  • Data Processing: [336937] QtパッケージおよびmacOSランタイムを更新しました。
  • Data Processing: [新機能] 入力画像にランダムな数の矩形スタンプを適用する Stamp Demo vTool が追加されました。このツールは、サンプルコードを通じて pylon Data Processing API の機能を実証するように設計されています。
  • Data Processing: [316725] ヘッダーオンリークラスである CSmartInstantCamera が追加されました。処理ステージを追加したレシピを使用して、カメラデバイスと pylon data processing に簡単にアクセスできるようになります。
  • Data Processing: [335461] CRecipe クラスに HasError メソッドが導入され、ユーザーがレシピ内の vTool がエラー状態にあるかどうかを確認できるようになりました。
  • Data Processing: [336695] CVariant クラスに画像を読み取り専用として追加できるようになりました。
  • Data Processing: [335474] CRecipe クラスに IsVToolEnabled および SetVTool メソッドが追加され、ユーザーが vTools の有効化と無効化を切り替えられるようになりました。
  • Data Processing: [341227] pylon Viewer で記録されたタイミングデータを分析するための、JavaScriptベースのタイミングアナライザーがサンプルに追加されました。詳細については、READMEファイルをご参照ください。
  • Data Processing: [341188] smart instant camera クラスを利用する GUI_QtMultiCam サンプルの更新版が追加されました。このサンプルはレシピを実行し、その結果のデータ処理出力画面を表示します。
  • Data Processing: [337669] Smart Instant Camera の使用方法を示すサンプルが追加されました。
  • vTools: [323845] OCR Basic vTool が pylon API を介してパラメータ化できるようになりました。

修正点#

  • vTools: [335671] Histogram Extractor vTool の Luminance 出力ピンの名称を Mono に変更しました。
  • pylon C++ SDK: [340635] サンプル QtMultiCam Windows プロジェクトの環境変数を PYLON_ROOT から PYLON_DEV_DIRに変更しました。
  • vTools: [321008] ドキュメントとの整合性を保つため、Camera vTool の 'ChunkPinValue' パラメータの名称を 'ChunkPinConfiguration' に変更しました。
  • Data Processing: [335446] 例外の送出が宣言されていないにもかかわらず例外を送出するメソッドのドキュメントを修正しました。
  • vTools: [322002] Calibration vTool の ExecuteCalib コマンドは、必要な入力がすべて揃っている場合にのみ使用できます。

制限事項#

  • 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カメラで取得した画像はまだ表示できません。
  • vTools: レシピの読み込み後は、Histogram Extractor vToolsのAreaピンの接続タイプを変更できません。
  • GenTL/GigE: GigE Vision用GenTL Producerはアクションコマンドをサポートしていません。
  • GenTL/GigE: GigE Vision用GenTL Producerはマルチキャスト構成をサポートしていません。
  • 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);を使用できます。
  • 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パッケージを無効にしてください。
    1. 次のコマンドを実行して、高度な設定を有効にします。
      powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE
    2. 電源オプションでLPM設定を変更します。
      1. コントロールパネルで電源オプションを開きます。
      2. 選択した電源プランの「プラン設定の変更」をクリックします。
      3. 「詳細な電源設定の変更」をクリックします。
      4. 「電源オプション」ダイアログの「詳細設定」タブで、「USB設定」を選択します。
      5. 「USB 3のセレクティブサスペンドの設定」または「USB 3 Link Power Management」を「オフ」に設定します。
  • 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デバッガーのオプションでマネージ互換モードを有効にしてください。
  • 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プログラミングサンプルを参照してください。
  • 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ウェブサイトからダウンロードできます。
  • 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 が低下し、画像の損失が発生する可能性があります。
  • vTools: 特定のデータ型の接続がレシピに保存されている場合、代替データ型は使用できなくなります。レシピを再読み込みして入力ピンへの元の接続を削除すると、入力ピンには元の接続のデータ型のみが提供されます。

ダウンロード#

このバージョンの pylon Software Suite はここからダウンロードできます。