ファイルから領域を読み取り

ツール 領域をファイルへ保存 で先に保存しておいたファイルから、このツールで領域を読み取ります。「ファイル名」が変更されると、ツールによって、ファイルから領域が直ちに読み込まれます。

パラメーター

基本パラメーター

ファイル名:

このパラメーターは領域を読み取るファイルの名前およびパスを定義します。デフォルトでは「Me_region.hobj」に設定され、それはディレクトリ「%USERPROFILE%\Documents」にあります。対応するコネクターで目的のファイル名とパスの変更や選択ができます。領域を読み取れるファイルはタイプ「.reg」または「.hobj hobj はバイナリファイル形式で、すべての種類のアイコン関連 HALCON オブジェクト (画像、領域、XLD) の読み込みおよび書き込み機能を提供します。データは圧縮も変換もなしで書き込まれるため、このファイル形式の書き込みは、ほとんどの場合、サポートされている他のファイル形式よりも高速です。したがって、アプリケーションですべてのアイコン関連 HALCON オブジェクトの読み込みおよび書き込みを可能な限り高速で行う必要があり、圧縮が不要な場合、この形式を使用する必要があります。画像の場合、すべての HALCON ピクセルタイプを書き込むことができます。マルチチャンネル画像がサポートされています。チャンネルには混合ピクセルタイプを含めることができますが、幅および高さは同じにする必要があります。画像のドメインおよび作成日もファイルに保存されます。オブジェクトタプルは 1 つのファイルに書き込まれます。」のファイルです。相対ファイルパスを定義すると、ファイルはデフォルトのディレクトリ 「%USERPROFILE%\Documents」を基準に検索されます。ただし、相対ファイルパスを定義したときに、すでに MVApp が保存されていた場合は、ファイルは MVApp があるディレクトリを基準に検索されます。

結果

基本結果

領域:

この結果では、選択したファイルから読み取った領域が返ります。領域は、ツールボード でハイライトされます。

カレントファイル名:

この結果には、最後の反復で読み取られたファイルの名前と絶対ファイルパス、たとえば「C:\Users\Public\Documents\MVTec\MERLIC\Me_region.hobj」が含まれます。

ツール状態:

「ツール状態」はツール状態の情報を返します。したがって、エラー処理に使うことができます。さまざまなツールの状態結果の詳細については、 ツール状態 結果 のトピックを参照してください。

追加結果

処理時間:

この結果は、ツールの直近の実行の持続時間をミリ秒単位で返します。結果は、追加結果として提供されます。したがって、デフォルトでは非表示になっていますが、ツール結果の横にある ボタンを使用して表示できます。詳細については、ツールリファレンス概要の処理時間の節を参照してください。