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

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

リリース日: 2026-03-20

バイナリ互換性#

  • Data Processing = 4.1.2
    Data Processingのバージョン4.1.xまたはそれ以前の4.x.xバージョンで構築されたアプリケーションとの互換性があります。
  • pylon C++ SDK = 11.4.0
    pylon C++ SDKのバージョン11.4.xまたはそれ以前の11.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 Viewer: [349641] サポートされているカメラ向けに、ブロックベースのFlat-Field Correction機能を追加しました。
  • pylon C++ SDK: [242242] 非推奨となったBasler Performance Driverを削除しました。
  • pylon C++ SDK: [344267] GUI_QtMultiCamサンプルで使用されているサンプルGUIのレイアウトを改善しました。
  • pylon C++ SDK: [333934] Image Format ConverterにRGBA8出力フォーマットを追加しました。
  • GigE: [356880] 複数のネットワークインターフェースを持つシステムでのGigEデバイスの検出を改善しました。複数のNICで使用可能なカメラが、pylonによって正しく列挙されるようになりました。
  • GigE: [353458] Intel(R) Network Connections Software, Release 30.5を追加しました
  • vTools: [338476] AI vToolsで複数の推論ジョブを並列実行してスループットを向上できるようになりました。この機能は上級ユーザー向けであり、動作とパフォーマンスはハードウェアおよびモデルのアーキテクチャによって異なります。
  • CXP12-IC-1C: [none] IC1CをStatic 1.2 P0にアップグレードするためのファームウェアファイル
  • vTools: [356573] Data Synchronizer vToolにComplete Input Set同期モードを追加しました。これにより、例えば同時にトリガーされるカメラの出力を同期させることができます。また、入力が欠落している場合に対応するためのタイムアウトを指定することもできます。さらに、TriggerおよびDiscard Input Dataコマンドが追加されました。前者はいつでも同期をトリガーできるようにし、後者は現在保持されているすべての入力データを破棄できるようにします。
  • vTools: [355384] レシピの保存時に、MiniScript vToolが「Filename」を保存するようになりました。相対パスが使用されている場合は、レシピファイルの場所を基準に解決されます。
  • vTools: [351356] Region Inverter vToolを追加しました。このvToolは入力領域を反転させるため、出力領域には入力領域に含まれていないすべてのピクセルが含まれます。

修正点#

  • pylon Viewer: [354832] 単一画像の撮影後もSave Image機能が無効なままになる問題を修正しました。
  • pylon Viewer: [352230] ラインスキャンカメラを使用しているときにRecording機能が動作しない問題を修正しました。
  • Workbench: [354844] レシピの読み込み後、接続が入力ピンおよび出力ピンから外れているように表示される問題を修正しました。
  • Workbench: [353962] Terminal Pin Informationエリアでのカメラ割り当てに関するメッセージを改善しました。
  • GenTL/CXP: [347266] プラットフォームライブラリ内でのLC_ALLロケール環境変数の復元を修正しました。
  • GenTL/CXP: [353004] 無効なGenApiノード名が原因で、生成されたGenTL Interface XMLがGenApiで読み込めなくなる問題を修正しました。生成されたXMLは、アプレットのファイル名にスペースや非英数字が含まれている場合でも、GenApiで読み込めるようになりました。
  • GenTL/CXP: [352489] microDisplayXのリンク設定ビューを修正し、CXPカメラプロパティ変更イベントがmicroDisplayXに正しく送信されるようになりました。
  • GenTL/CXP: [351348] CXPの検出の堅牢性を高めました（特にマルチリンクカメラ）。一部のシステム構成において、1つまたは複数のスレーブリンクがマスターリンクよりもわずかに遅れて検出されるタイミングの問題を修正しました。
  • GenTL/CXP: [350617] ポートインデックスのリソースにギャップがあるHAPファイルのCXP検出を修正し、割り当てられていない中間ポートインデックスを持つファイルが正しく処理されるようにしました。
  • pylon C++ SDK: [353965] フラットフィールド補正サンプルにおける平均ピクセル値の計算を修正しました。
  • GigE: [352234] 最大フレームレートが2 fpsのカメラをサポートするために、FrameRetentionのデフォルト値を500ミリ秒に変更しました。
  • GenTL/GigE: [267556] チャンクデータが存在しない場合に、DsGetBufferChunkData の戻り値が GEV_ERR_NO_DATA にならない問題を修正しました。
  • Data Processing: [355946] 大きな画像をティーチパラメータとして使用するとパフォーマンスが低下する不具合を修正しました。
  • vTools: [356573] Data Synchronizer 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のビデオ録画機能に影響する新しい制限が導入されます。イメージングパイプラインにおいてカメラあたり毎秒250枚の画像のみが許可されるため、この制限を超えた場合にすべてのフレームを録画する機能が制限されます。
  • Workbench: WorkbenchのStatistics機能は、vToolsの実行時間を測定します。Statistics機能で測定される時間は、システムの設定や全体的なCPU負荷によって異なる場合があります。これは、CPUが現在の負荷（動的周波数スケーリングなど）に応じて異なる周波数で動作する場合があるためです。
  • 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ウェブサイトからダウンロードできます。
  • 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パッケージを無効にしてください。
    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」を「オフ」に設定します。
  • 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: ラインスキャンアプレットの場合、ライン周期とライン露光の範囲が正しく処理されません。最大値が想定よりも小さくなる場合があります。
  • 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」というエラーメッセージがログに記録されます。カメラの検出では未接続のポートもプローブしてリンク速度を変更するため、アプリケーションが未接続ポートで新しいカメラの検出を頻繁に試行すると、この問題が発生する可能性があります。

ダウンロード#

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