Framegrabber SDK 5.10.0における変更点と修正された問題

このセクションでは、Basler Framegrabber SDKバージョン5.10.0の変更点および修正された問題に関する情報を提供します。

概要

• 製品名が Basler Runtime から Basler Framegrabber SDKに変更されました。
• Framegrabber SDKは、Windows 11（64ビット）およびLinux Ubuntu 22.04（64ビット）をサポートするようになりました。（チケットID: 231590および244875）
• The Framegrabber SDK installer for Windows has been updated. Among others, installation paths (e.g. <Basler>), environment variables (e.g. BASLER_FG_SDK_DIR)、および名前が変更されました。詳細については、以下を参照してください。 環境変数とヘッダーファイルの名称変更. (チケットID: 218027および227082)
• Windows 32ビットライブラリが、Windows 64ビットインストーラーに統合されるようになりました。（チケットID: 253234）
• Framegrabber SDKのGenICamリファレンス実装ライブラリが、メインのインストールフォルダーに移動されました。（チケットID: 236467）
• Linuxでは、microDisplay X、FirmwareUpdaterなどのすべてのGUIおよびコマンドラインツールは、/bin配下にある関連スクリプトから起動する必要があります。(チケットID: 250971および253097)

環境変数とヘッダーファイルの名称変更

インストール時に設定される環境変数が名前変更されました：

SISODIR5 が次のように変更されました： BASLER_FG_SDK_DIR.

以下のヘッダーファイルの名称が変更されました：

旧名称	新名称	含まれるコンポーネント
fgrab_define.h	fg_define.h および fg_error_codes.h	basler_fg.h
fgrab_struct.h	fg_struct.h	basler_fg.h
fgrab_prototyp.h	basler_fg.h

以下のヘッダーファイルが再構築されました：

ファイル名	変更
fgrab_define.h	fgrab_define.h の大部分は、名前が変更されたファイル fg_define.h として存在します。
fgrab_define.h	以前は fgrab_define.h にあったエラー定義は、新しいヘッダーファイル fg_error_define.h に含まれるようになりました。

以下のヘッダーファイルが削除されました：

• fgrab_triangultion.h
• fgrab_blob.h

ファイル fgrab_define.h、fgrab_struct.h、および fgrab_prototyp.h は、最小限のヘッダーとして引き続き存在します。廃止されたヘッダーファイルのいずれかをインクルードすると、次の現象が発生します。

• "deprecated"（非推奨）の警告が表示されます。
• 廃止された fgrab_ ファイルの代わりに、対応する新しい fg_ ファイルが自動的に含まれるようになりました。

Framegrabber SDK バージョン 5.10 以降では、basler_fg.h のみを使用する必要があります。

販売終了

Windows 32ビット

Framegrabber SDKでは、Windows 32ビットおよびLinux 32ビットのオペレーティングシステムがサポートされなくなりました。（チケットID: 231590）

フレームグラバー

以下のフレームグラバーのサポートが終了しました：

• microEnable IV
• microEnable 5 marathon CLHS
• microEnable 5 ironman

販売終了製品の詳細については、Basler の販売終了製品ページを参照してください。

サードパーティ製インターフェース

以下のサードパーティ製インターフェースのサポートが終了しました：

• LabView（API サンプルも参照）
• 独自のCognex VisionPro Adapter
• 独自のMVTec HALCONアダプター
• CVB

Cognex VisionPro AdapterおよびMVTec HALCONアダプターは、GenTLインターフェースに置き換えることができます。（チケットID: 231588、212114、212120、255221）

Framegrabber API

• アプレットが見つからない場合のログメッセージの文言が改善されました。（チケットID: 225003）

ツール microDiagnostics および microDisplay X

• microDisplay X の Help メニューの位置が変更されました。Help メニューは現在、以下の場所にあります：

  

  （チケットID: 230984）

• 以前は、ファームウェアがフラッシュされていない状態で microDiagnostics を終了すると、終了ダイアログで「firmware」の代わりに「applets」をフラッシュするかどうか尋ねられていました。終了ダイアログの文言が修正されました。（チケット ID：212124）

APIの例

• C/C++ SDKのサンプルは、Visual Studio 2019以降などの最新のMicrosoft Visual Studioバージョンでビルドできるようになりました。（チケットID: 226757、249321、227119）
• National Instruments LabView のサンプルプログラムが Framegrabber SDK の配布物から削除されました。NI LabView 用のサンプルプログラムが必要な場合は、Basler テクニカルサポートにお問い合わせください。（チケット ID：231588 および 227110）

Drivers

• imaWorx CXP-12 Quad frame grabber のドライバーにおいて、自動停止動作が改善されました。これにより、カメラが要求されたフレーム数を送信したときに取り込みが停止するようになります。また、ダミーバッファに格納されるフレームも考慮されるようになりました。以前は、ユーザーがユーザーバッファで要求されたフレーム数を受け取った時点で取り込みが停止していました。（チケット ID：235859）
• microEnable 5 frame grabbers のドライバーに、フレーム番号を取得するための API が追加されました。（チケット ID：227072）
• microEnable 5 ドライバーのバッファ処理が改善されました。（チケット ID：235850 および 236981）
• ClSerComWrapper2 を介したカメラとフレームグラバー間の通信速度が向上しました。（チケット ID：236732）
• microEnable 5フレームグラバーとの通信が拡張され、さまざまなハードウェアバリアントがサポートされるようになりました。（チケットID: 231003、232694）
• デバイス検出機能が改善されました。（チケットID: 238309）
• CXPおよびCamera Linkカメラの検出が改善されました（チケットID：229754、226742、230948、240393）。

修正された問題

• 以前は、GenTL BUFFER_INFO_FRAME_ID（次を介してクエリ可能： DSGetBufferInfo）にCXPイメージヘッダーからのソースタグが含まれていませんでした。代わりに、コンピュータに配信されたすべてのフレームのCounterが含まれていました。これが修正されました。（チケットID：197430）
• 以前は、CXPカメラのXMLのURLを読み取る際、Framegrabber SDKは256バイトのレジスタサイズを想定していました。しかし、カメラXMLのURLを読み取る際に特定のレジスタサイズを想定することは、CXP規格に違反します。これが修正されました。現在ではレジスタサイズは想定されず、Framegrabber SDKはCXP規格に準拠しています。（チケットID：228438）
• 以前は、CXPカメラのXMLのURLを読み取る際、Framegrabber SDKはXMLのルート要素が「Local」（大文字の「L」）であると想定していました。しかし、CXP規格ではURLの大文字と小文字は区別されないと規定されています。これが修正されました。現在では、URLの解析があらゆる大文字・小文字に対応するように変更されています。（チケットID：228439）
• 以前は、GenICam GenTL Producerがすべてのノードに対して「Selecting」の値を提供していませんでした。これが修正されました。（チケットID：212118）
• 以前は、GenICam GenTL Producerがプロパティ内で正しいベンダー名とインターフェイスIDを提供していませんでした。これが修正されました。（チケットID：225073）
• GenICam GenTLのデッドロックが発生する可能性のある問題が修正されました。（チケットID：238352）
• 以前は、microEnable 5フレームグラバーのアプレット変更がmicroDisplay Xで正常に機能しないことがありました。これが修正されました。（チケットID：229736）
• ROI機能の動作が最適化されました。（チケットID：229952）
• 以前は、コマンドラインツール gpioTool の Help 機能を -h で開いた際、表示されるサンプルが正しくなく、動作しませんでした。これが修正されました。（チケット ID：221628）
• 以前は、FirmwareUpdate ツールの特定のエラーメッセージが誤解を招くものであるか、スペルミスがありました。そのため、エラーメッセージの文言が改善されました。（チケット ID：223690、223689）
• 以前は、Linux 20.04でmicroDisplay XおよびmicroDiagnosticsを起動した際、ツールがエラーで終了していました。これが修正されました。（チケットID：233534）
• 以前は、microDisplay Xでアプレットの読み込みとアンロードを行うとエラーが返されていました。これが修正されました。（チケットID：212132）
• 以前は、microDisplay Xがアプレットの変更時に画像取得を停止していませんでした。これが修正されました。（チケットID：220077）
• 以前は、microDisplay X の Save Parameters ボタンと Load Parameters ボタンが正常に機能していませんでした。これが修正されました。（チケット ID：238752）
• 以前は、PCの再起動後にmicroDisplay Xでアプレットを読み込むとエラーが発生していました。これが修正されました。（チケットID：236228）
• 以前は、画像のシーケンスを読み込む際にmicroDisplay Xがクラッシュしていました。これが修正されました。（チケットID：212616）
• 以前は、microDisplay Xで変換ループパラメータが正しく表示されませんでした。これが修正されました。（チケットID：234064）
• 以前は、microDisplay XがバスラーのデュアルチャネルCXP-12カメラを認識していませんでした。これが修正されました。（チケットID：235720）
• 以前は、画像取得中にウィンドウをスクロールすると、microDisplay Xがクラッシュしていました。これが修正されました。（チケットID：238904）
• 以前は、imaWorx CXP-12 QuadでHAPファイルを読み込む際にmicroDisplay Xがクラッシュしていました。これが修正されました。（チケットID：235946）
• 以前は、microDisplay Xにパラメータプロパティの説明が表示されませんでした。これが修正されました。（チケットID：242207）
• 以前は、microDisplayが大きな画像（例：10500 x 43500ピクセル）を正しく表示していませんでした。これが修正されました。（チケットID：246410）
• 以前は、microEnable 5 フレームグラバー上の microDiagnostics X で HDR0 のロードが常に正しく機能するわけではありませんでした。これが修正されました。(チケット ID: 234254)
• 以前は、Linux Ubuntu システム上の imaWorx CXP-12 Quad でのアプレットの初期化が、 Fg_init により失敗していました。これが修正されました。(チケット ID: 234499)
• 以前は、LookupTable 内の imaWorx CXP-12 Quad 用アプレットの値の設定または選択が機能しませんでした。これが修正されました。(チケット ID: 221621)
• 以前は、一部の imaWorx CXP-12 Quad アプレットの ROI 幅をインクリメントするとエラーが発生していました。これが修正されました。(チケット ID: 249177)
• 以前は、 Fg_AllocMemHead を imaWorx CXP-12 Quad に対して複数回呼び出した場合、この関数の呼び出しごとに実行時間が長くなっていました。これが修正されました。(チケット ID: 247416)
• 以前は、imaWorx CXP-12 Quad で Sgc_(re)storeLowLevelLinkProfile() を呼び出すとエラーが発生していました。これが修正されました。(チケット ID: 246768)
• フレームグラバーライブラリのイベントがスレッドセーフになりました。(チケット ID: 236809)
• 以前は、カメラあたり複数の DMA を持つアプレットをロードすると、microDisplay X でエラーが発生していました。これが修正されました。(チケット ID: 237342)
• 以前は、HAP ファイルのロードに失敗したため、フレームグラバーの初期化に失敗していました。これが修正されました。(チケット ID: 237013)
• AutomaticROIControl パラメータのオン/切り替え時の関連パラメータの表示が正しく機能するようになりました。(チケット ID: 217774)
• Fg_getSWVersion() は、インストールされている Framegrabber SDK の正しいバージョン番号を返すようになりました。(チケット ID: 202240)
• MVTec HALCON 用の旧独自アダプターの最新バージョン 13.0.11 が改善され、最大 4 GBytes の転送がサポートされるようになりました。このアダプターは Framegrabber SDK 5.10.0 で廃止され、Basler は代わりに GenICam GenTL インターフェースを使用することを推奨しています。(チケット ID: 231049、231326、218503)
• 以前は、MVTec HALCON 用の旧独自アダプターを使用しているときに、画像取得が予期せず停止していました。これが修正されました。このアダプターは Framegrabber SDK 5.10.0 で廃止され、Basler は代わりに GenICam GenTL インターフェースを使用することを推奨しています。(チケット ID: 229938)