メインコンテンツへスキップ
検索領域 は、一連の検索制約とリレーションによって定義されます。これは、要素によって記述されたオブジェクトをプログラムがどこで検索するかを指定するものです。 検索領域は、共通の境界を持つ必要のない 1 つ以上の矩形で構成されます。つまり、検索領域は連続していなくてもかまいません。 検索領域は、絶対検索制約、つまり座標によって定義することも、相対検索制約、つまり他の要素とのリレーションによって定義することもできます。 相対検索制約を指定する場合は、FlexiLayout ツリー内で、対象の要素より上位にある任意の要素を使用できます (この要素に対応する画像オブジェクトは、ツリー内で上位にある要素で記述された、すでに見つかっているオブジェクトの情報を使用してのみ見つけることができます) 。

​
検索領域の絶対座標を指定する

絶対検索領域は、要素のPropertiesダイアログの Search Constraints タブで定義します。 複数ページ文書の場合は、要素を検索するページ範囲を選択できます。検索領域の絶対ローカル座標は、Region プロパティで指定できます。

​
検索領域から要素を除外する

Exclude regions of elements プロパティを使用すると、要素について見つかった 仮説 の Region を検索領域から除外できます。除外対象の要素の 仮説 が見つからない場合、この制約はその要素の検索領域には影響しません。
ただし、これには例外があります。Advanced pre-search relations ペインで、除外対象の要素の 仮説 の一部の境界に追加の制約が指定されている場合です。この場合、プログラムが除外対象の要素を見つけられないと、その要素の矩形の検索領域が周囲の検索領域から切り取られます。内部矩形の詳細については、Fuzzy rectangle を参照してください。

​
縦書きテキストの認識

通貨、日付、電話、文字列、固定テキスト、段落要素では、横書きと縦書きの両方のテキストを認識できる Search through vertical text オプションを使用できます。Clockwise oriented オプションと Counterclockwise oriented オプションでは、それぞれ上から下、および下から上の縦書きテキストの認識を有効または無効にできます。これらは既定で有効になっており、無効にできるのは Search through vertical text が選択されている場合のみです。

​
別の要素を基準にした検索領域を指定する

相対検索領域は、要素の Properties ダイアログの Relations タブで定義します。相対検索領域を定義するには、境界をその要素に対して定義するための参照要素を指定し、“right of”、“left of”、“above”、“below” タイプのリレーション (Relations プロパティ) を指定します。検索領域は、どの要素に対してもいくつでも指定できます。検索領域の 境界 は、それぞれ異なる参照要素を基準に指定できます。相対検索領域が指定されていない場合、プログラムは画像全体を対象に object を検索します。各 検索制約 は半平面を指定します。半平面と画像の intersection によって、検索領域の長方形部分が生成されます。すべての 検索制約 と画像との intersection によって、要素の検索領域が生成されます。 検索領域の 境界 は、Element 境界 プロパティと Offset プロパティを使用すると、より正確に指定できます。

​
Element 境界 プロパティ

Element 境界 プロパティでは、要素の上端、下端、左端、または右端の 境界 を基準に、検索領域の 境界 を指定します。既定では、このプロパティは <whole> に設定されています。 相対検索領域を計算する際、プログラムが 参照要素 プロパティで指定された参照要素を見つけられないことがあります。以下の段落では、参照要素が見つかった場合と見つからなかった場合の両方で、プログラムが相対検索領域をどのように計算するかを説明します。 参照要素がオプションで、その要素で指定された条件を満たす object が画像上に存在しない場合、プログラムはヌル仮説を生成します。参照要素のヌル仮説の Region は、その要素の検索領域を囲む Rectangle と一致します。 参照要素が見つかった場合、仮説の Region は、その仮説に含まれる検出された object の Region から構成され、要素の検索領域内に配置されます。 参照要素が見つかっていて、Element 境界 が <whole> に設定されている場合、Right of 制約は「参照要素の右 境界 より右」、Left of 制約は「参照要素の左 境界 より左」などを意味します (つまり、仮説の右、左、下、または上です) 。 参照要素の仮説が生成されていない場合、その要素は参照要素の検索領域内のどこにでも存在し得ることを意味します (ただし、検索領域の外側には存在しません) 。 したがって、見つかっていない仮説に Right of 制約を適用すると、「参照要素の仮説が存在し得る任意の領域より右」を意味します。数学的には、これは「参照要素の検索領域の左 境界 より右」を意味します。 同様に、見つかっていない仮説に Left of 制約を適用すると「参照要素の検索領域の右 境界 より左」、Below 制約は「参照要素の検索領域の上 境界 より下」、Above 制約は「参照要素の検索領域の下 境界 より上」を意味します。 Element 境界 プロパティが特定の値 “Left”、“Top”、“Right”、“Bottom” のいずれかに設定されている場合、検索領域は、仮説が見つかっているかどうかにかかわらず、参照要素の仮説の指定された 境界 を基準に計算されます。 たとえば、見つかっていない仮説の場合に、Element 境界 を “Right” に設定した Right of 制約は、「参照要素の検索領域の右 境界 より右」を意味します。

​
Offset プロパティ

Offset プロパティは、検索領域の境界を一定の距離だけずらします。Offset の値が正の場合、境界は Relation プロパティで指定した方向と同じ方向に移動します。Offset の値が負の場合、境界は Relation プロパティで指定した方向とは反対方向に移動します。 例: FlexiLayout には 固定テキスト 型の YourPlanetName 要素が含まれており、これによりプログラムは画像上の YOUR PLANET NAME: という field 名を見つけることができます。目的は、この field に入力されたテキスト (この例では “MARS (satellite Phobos)”) を見つけることです。 Planet という 文字列 型の要素を作成し、YourPlanetName 要素の右側にある検索領域を指定します。つまり、Element boundary プロパティを Right of に設定します。検索領域の位置は次の図のとおりです。
YourPlanetName 要素の右側にある検索領域の図
検索領域の境界を右に、つまり Right of リレーションで指定した方向と同じ方向に移動します。これを行うには、たとえば 200 のような正の Offset 値を指定します。境界の新しい位置は次の図のとおりです。
正の Offset 値によって右に移動した検索領域の境界の図
次に、検索領域の境界を左に、つまり Right of リレーションで指定した方向とは反対の方向に移動します。これを行うには、たとえば -200 のような負の Offset 値を指定します。境界の新しい位置は次の図のとおりです。
負の Offset 値によって左に移動した検索領域の境界の図

​
特定のオブジェクトに最も近い要素を選択する

Nearestプロパティは、ほかの条件が同じであれば、画像上の特定の要素または点に最も近い位置にある仮説を探すようプログラムに指示します。最も近い要素、点、または座標軸は、その要素のNearestプロパティで指定します。

​
検索領域を表示する

リレーションのプロパティを編集しているとき、または Relations テーブルでリレーションを選択すると、そのリレーションが Image ウィンドウに表示されます。複数のリレーションを選択すると、選択したリレーションの交差領域が表示されます。Reference layout モードでは、Image ウィンドウでオフセット境界をマウスで直接ドラッグして、オフセット値を変更することもできます。 FlexiLayout をマッチングすると、プログラムはまず、指定されたすべての制約に基づいて要素の検索領域を計算します。次に、検索領域内にある画像オブジェクトが、その要素と同じプロパティを持っているかどうかを確認します。 FlexiLayout のマッチング結果として誤ったオブジェクトが見つかった場合は、要素の検索領域を確認することで、その原因を調べることができます。 FlexiLayout のマッチング後に要素の検索領域を表示するには、その要素に対応する仮説を右クリックし、ショートカットメニューから Show Search Area コマンドを選択します。検索領域は Image ウィンドウに表示されます。