オープン処理名

XDW文書オープン処理を選択します。最後にオープンされたオープン処理名を返すマクロ「{%DW_GET(OpenName)}」がデフォルト表示されます。

ページ

QRコードの読み取りを行うページを1以上の整数で指定します。

ページの繰り返し処理内に処理を追加した場合は、処理中ページのカウンタを取得するマクロ「{%DW_GET(PageLoopCount)}」を使用できます。

ページの繰り返し処理内でない場合は、「1」などのページを直接指定します。

モード

QRコードの解析方法を「速度優先」「標準」「認識優先」から選択します。通常は「標準」を選択してください。

各モードでは、詳細設定の項目に以下の値が使われます。

文字コード

文字コードを「ShiftJIS」「UTF-8」「自動判定」から選択します。

「ShiftJIS」「UTF-8」を選択すると、QRコードに格納されている文字を、選択した文字コードとしてデコードします。「自動判定」を選択すると、QRコードに格納されている文字の文字コードを判定してデコードします。

自動判定は文字の並びから文字コードを推定するため、短い文字列や記号だけの文字列では、正しく判定できない場合があります。QRコードの文字コードが決まっている場合は、「ShiftJIS」か「UTF-8」を選択してください。
また、UTF-8で取得した文字はUNICODEとして内部で記憶されますが、ログやテキストファイル等に出力する際にUTF-8を指定しないと文字化けしてしまいます。

範囲指定する

「基本設定」タブにあります。チェックすると、QRコードの読み取りする範囲をパーセント指定で指定できます。

X座標・Y座標

X座標とY座標の範囲を0～100の整数(パーセント)で指定します。開始には終了より小さい値を指定します。起点は左上になります。下記の例では、赤い部分が読み取りの対象となります。

X座標 0%～50%
Y座標 0%～50%

X座標 50%～100％
Y座標 50%～100％

QRコードの位置が決まっている場合は、範囲を指定すると処理速度が向上します。

範囲を指定しても、読み取り結果の座標(LeftTopXなど)は、ページ全体の左上を起点とした値になります。

検索文字を指定する

「基本設定」タブにあります。チェックすると、検索文字(正規表現)を指定できます。

分割マークをつける

「基本設定」タブにあります。チェックするとQRコードを検出したページをメモリに記憶します。ページ分割はファイル移動・コピー処理で行うことができます。検索文字を指定した場合は、検索文字に一致したQRコードがあるページが対象になります。

詳細設定

「詳細設定」タブにあります。チェックすると、以下の5項目を指定できます。通常はチェックする必要はありません。特定の文書で読み取りがうまくいかない場合や、処理時間を調整したい場合に使用します。

詳細設定をチェックすると、5項目すべての値が、モードで決まる値の代わりに使われます。例えば「認識優先」を選択して詳細設定をチェックした場合、処理時間の上限は認識優先の20000msではなく、入力した値になります。入力欄の初期値は「標準」モードと同じ値です。選択したモードに合わせて、5項目とも値を見直してください。

ページのイメージ変換について

QRコードの読み取りは、ページを内部でイメージに変換して解析します。イメージのページはそのページの解像度で、それ以外のページ(アプリケーション文書のページなど)は300dpiで変換します。「QRコード読み取り」にあった出力解像度の設定はありません。変換した解像度は、読み取り結果の「Dpi」に保存されます。

詳細設定の「px」は、この変換後のイメージのピクセル単位です。

処理を実行すると、ログに「Page:1 QR:2 Time:208ms TimedOut:False」のように、ページ、読み取ったQRコードの数、解析にかかった時間、打ち切りの有無が出力されます。

QRコードごとの情報

「{%GET_U(処理名,番号,キー)}」のように、2番目の引数に番号、3番目の引数に以下のキーを指定すると、対応した情報が取得できます。「Dpi」から「CheckDigit」までは、「QRコード読み取り」と同じキー、同じ並び順です。

座標は、ページの左上を起点としたmm単位の値です。小数点以下2桁までの値になります。四隅の座標は、QRコードの向きを基準にした角の位置です。QRコードが回転して印刷されている場合は、LeftTopXとLeftTopYの位置がページの左上側になるとは限りません。

処理名_Info (QRコード読み取り(v2)だけの情報)

解析全体の情報と読み漏らし候補は、処理名の後ろに「_Info」を付けたデータ名のユーザーデータに保存されます。例えば、処理名が「QRコード読み取り(v2)1」の場合は「QRコード読み取り(v2)1_Info」になります。「{%GET_U(処理名_Info,キー)}」のように指定して取得します。

読み漏らし候補の情報

読み漏らし候補は、位置検出パターン(QRコードの3つの角にある四角い模様)は見つかったものの、QRコードとして読み取れなかった領域です。「QRコードがありそうだが読めなかった」ことを示します。モードが「標準」「認識優先」の場合に検知します。候補の領域は自動で再解析され、読み取れたものは候補から除かれます。

「処理名_Info > SuspectedRegions > 候補の番号 > 項目名」のキーで保存されます。「{%GET_U(処理名_Info,SuspectedRegions,番号,キー)}」のように指定して取得します。

ページの繰り返しの中では、読み取り結果はページごとに上書きされます。文書全体で「QRコードが1つも無い」ことを判定する場合は、ページごとの結果をADD_USER_DATAなどで累積し、繰り返しの後で累積した結果を判定してください。

「QRコード読み取り」との違い

読み取り結果の取得方法は「QRコード読み取り」と同じです。以下の点が異なります。