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

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

リリース日：2026-05-20

バイナリ互換性#

  • Data Processing = 5.0.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 で構築されたアプリケーションは互換性がありません。

新機能 / 変更点#

  • vTools：[360573] vToolライセンスなどのCodeMeterライセンスコンテナを作成できるようにするライセンスファイルを追加しました。
  • vTools：[355504] Free-Form OCR vToolを追加しました。
  • pylon C++ SDK：[360807] すべてのConfiguration EventハンドラーからGenDCモードの自動無効化を削除しました。
  • pylon C++ SDK：[358101] グラブ結果をコンポーネントのコンテナとして一貫して扱うようにpylon C++ SDKを拡張しました。影響を受けるAPI：サンプルコード、CGrabResultData::GetFirstImageDataComponent、CGrabResultPtr::operator IImage&、CPylonImage::AttachGrabResultBuffer、CPylonDataContainer::GetFirstImageDataComponent、CPylonDataComponent::GetComponentIndex。CGrabResultPtrオブジェクトから取得したデータコンポーネントは、基となるグラブ結果への参照を保持するようになり、グラブ用のバッファが再利用されるのを防ぎます。
  • pylon C++ SDK：[265373] 非推奨のinclude/pylon/gigeヘッダーファイルを削除しました。アプリケーションコードがこれらのファイルに依存している場合は、コードを更新してBaslerUniversalInstantCameraを使用する必要があります。
  • pylon C++ SDK：[265377] 古いUSB専用ヘッダーファイルを削除しました。今後はBaslerUniversalCameraを使用してください。
  • pylon C SDK：[359063] エラーメッセージ内のファイルパスを短縮し、pylonのルートパスのみを含むようにしました。
  • GenTL/CXP：[357830] zlibをバージョン1.3.1からバージョン1.3.2にアップデートしました。
  • pylon .NET 5+ SDK：[361223] Stereo miniカメラのサポートを追加しました。
  • Workbench：[356499] 入力ターミナル上のデータ生成ピンの視覚化とデフォルトのキュー動作を改善しました。
  • vTools：[360288] Array Element Iterator vToolを追加しました。
  • vTools：[355564] Array Creator vToolを追加しました。

修正点#

  • pylon C++ SDK：[360569] インデックス付きカラー（パレット）または8ビット未満のビット深度を持つPNG画像の読み込みに関する問題を修正しました。
  • pylon C++ SDK：[358812] PNG画像永続化の実装における複数の問題を修正しました。Gray+Alpha画像が正しくMono8またはMono16として読み込まれ、アルファチャネルが破棄されるようになりました。BGR8packedおよびBGRA8packed画像が、PNG仕様で求められる標準のR、G、B（A）チャネル順序で保存されるようになりました。16ビット画像が、読み込み時と保存時の両方で、リトルエンディアンのメモリレイアウトとビッグエンディアンのPNGストレージフォーマットの間で正しく変換されるようになりました。
  • GenTL/CXP：[334172] カメラの「サポート終了（EOL）」メッセージは、切断が検知されるとすぐにログに記録されるため、新しく接続されたカメラでそのカメラのロギングIDを再利用できます。切断後もハンドルが使用されている場合は、新しいロギングコンテキストが確立されるため、それがアクティブなカメラではないことを明確にしながら、ログメッセージを引き続きカメラに関連付けることができます。
  • GenTL/CXP：[357284] この問題が修正される前は、起動時にHAPファイルのライセンスが無効であると誤って報告されることがありました。これが修正されました。現在では、フレームグラバーが設定された後にのみライセンス検証が行われ、誤ったライセンスエラーを防ぎます。
  • GenTL/CXP：[358938] アプレットの整数機能の最大値とステップ値を2^31-1（INT32_MAX）に制限していたGenTLプロデューサーの不要な制限を削除しました。
  • GenTL/CXP：[355660] バージョン1.3.1では、符号なし整数機能のアプレット最大値に対する自動制限が意図せず削除されていました。その結果、2^63-1（INT64_MAX）より大きい値がGenApiによって負の値として解釈され、最大値が最小値より小さく表示されて範囲チェックの失敗を引き起こしていました。この自動制限が復元されました。適用されると、動作が分かるように警告がログに記録されます。
  • GenTL/CXP：[353866] WindowsのWNDPROCメッセージ処理関数内からFg_FreeGrabber（…）を呼び出したときに発生する可能性のあるデッドロックを修正しました。
  • GenTL/CXP：[357288] HAPファイルのカメラ総数がアプレットイテレータによって誤って報告される問題を修正しました。
  • pylon .NET 5+ SDK：[347205] Statistic_Total_Buffer_Countなど、アンダースコアを含むpylonパラメータにアクセスできない問題を修正しました。
  • pylon Viewer：[335478] [ファイルアクセス]ダイアログのエラーメッセージを改善しました。
  • pylon IP Configurator: [344809] IP Configuratorでのカメラのサブネット不一致に関する警告の視認性を改善しました。
  • pylon Viewer: [356459] Feature PropertiesタブとvTool Documentationタブを切り替えたときに、選択した機能が失われることがある問題を修正しました。
  • pylon Viewer: [358556] シングルショットおよび連続撮影モードで拡大・縮小が使用できなくなっていた問題を修正しました。
  • pylon Viewer: [350977] ヘルプの取得（Get Help）リンクをクリックしたときに、正しいトピックではなくドキュメントのホームページが開いてしまう問題を修正しました。
  • pylon Viewer: [359221] 別のFFCセットを生成する際にプレビューが原因で誤ったFFC係数が生成される可能性がある問題を修正しました。
  • pylon Viewer: [349528] 新しいアイコンデザインに合わせて、複数のアイコンを更新しました。
  • pylon Viewer: [306300] モノクロカメラでColor Calibratorを開いた後に画像取得が停止し、再開できなくなる問題を修正しました。
  • pylon Viewer: [361441] カメラがまだ検出されていないデバイス列挙中に、Devicesペインにビジーインジケーターを追加しました。
  • Workbench: [354845] UI/UXガイドラインに準拠するように、期限切れデモライセンスのメッセージデザインを改善しました。
  • vTools: [362054] Array Creator vToolで必須ピンが接続されていない場合のエラーハンドリングを修正しました。
  • vTools: [362049] 異なるアップデートからの入力の同期に関して、Array Element Iterator vToolのドキュメントを更新しました。
  • vTools: [361349] Image Stitcher vToolにおいて、PaddingValueが0に設定されオフセットが適用されたときに、2つの画像間の隙間が埋められない問題を修正しました。

制限事項#

  • 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パッケージを無効にしてください。
    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: 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 はここからダウンロードできます。