# IDMax Vision Data Access functions

このトピックでは、IDMax Vision Data Access functions 構造体から値を返すVision Data Access functionsのリストを記載します。

注 : 返される値はすべて、参照される IDMax 構造体から取得されます。この構造体は、ReadIDMax 関数の作成時にスプレッドシートに挿入されます。必要に応じてインデックスを使用して、ReadIDMax 関数の結果テーブルからインデックス付き文字列を参照することができます。

関数 | 説明
--- | ---
GetAngle(IDMax, [インデックス]) | シンボルの角度を返します。 注 : ReadIDMax 関数の [照合] チェックボックスをオンにする必要があります。
GetCodeName(IDMax, [インデックス]) | コード種類の名前を返します。これは、ReadIDMax プロパティシートに表示されるコード名と同じです。
GetCodeType(IDMax, [インデックス]) | コード種類を返します。
コード種類 | 対応するコード名
--- | ---
1 | Code 128
0 | Code 39
3/4 | UPC/EAN
11 | Code 93
12 | Codabar
128 | データマトリックス
129 | QR コード
132 | PDF 417
GetColor(IDMax, [インデックス]) | データマトリックス、QR コード、または PDF 417 シンボルの前景色の値 (0 = 黒、1 = 白) を返します。
GetDecoded(構造体,インデックス) | インデックスで指定された ID シンボルが検出されたかどうかを返します。検出されなかった場合は 0.0 を返し、検出された場合は 1.0 を返します。
GetErrorCode(IDMax, [インデックス]) | 関数が失敗した場合に各情報文字列のエラーコードを返します。 注 : エラー文字列は、GetErrorString 関数によってスプレッドシートに挿入されます。
診断コード | 対応する情報文字列
--- | ---
00010000 | ビジョンツールエラーです。
00010001 | 無効な画像メモリです。
00010001 | 入力した領域が小さすぎます。
00010002 | 入力した領域が画像境界を超えています。
00019000 | IDMax ビジョンツールエラーです。
04010000 | ReadCompositeCode エラーです。
04010001 | 2D コンポーネントアドレスパターンを検出できません。
04010002 | 無効な 2D コンポーネント画像データが多すぎます。
04010003 | 2D コンポーネントシンボルバージョンを検出できません。
04010004 | 欠落している 2D コンポーネントアドレスパターンを埋めることができません。
04010005 | スキャンラインが無効な画像データを検出しました。
04010006 | スキャンラインが画像境界を超えています。
04010007 | 1D コンポーネントファインダパターンを検出できません。
04010008 | 無効な 1D コンポーネント画像データが多すぎます。
04010009 | 有効なコンポジットシンボルが見つかりません。 注 : その他のシンボルすべてに対して、04020001 が返されます。
04010010 | 訂正の必要なシンボルエラーが多すぎます。
04010011 | 誤り訂正に失敗しました。
04010012 | 1D と 2D がデコード可能ですが、関連付けられていません。
04010013 | 自動コントラストしきい値計算に失敗しました。
04010014 | コントラスト感度が許容範囲を超えています。
04010015 | スキャンパラメータが許容範囲を超えています。
04020000 | ReadIDMax エラー。
04020001 | 有効なシンボルが見つかりません。
04020002 | シンボルをデコードできませんでした。
GetErrorString(IDMax, [インデックス]) | シンボルのデコードに失敗した場合に診断情報を返します。 注 : GetErrorString ビジョンデータアクセス関数は、ReadIDMax 関数によって返されるデータ構造体から、次のエラーリストを抽出するのに使用できます。 システムエラーです。 ヒープメモリが不足しています。 ビジョンツールエラーです。 画像バッファが無効です。 領域サイズが無効です。 領域が画像境界を超えています。 ReadIDMax エラー。 ReadIDCode エラーです。 行アドレスパターンを検出できません。 行アドレスパターン (RAP) のメモリの制限を超えました。 CC-A シンボルバージョンを検出できません。 欠落している RAP ポイントを埋めることができません。 無効なスキャンラインが検出されました。 スキャンラインが画像境界を超えています。 半値パターンを検出できません。 半値メモリの制限を超えました。 有効なシンボルが見つかりません。 訂正の必要なシンボルエラーが多すぎます。 リードソロモン誤り訂正に失敗しました。 自動コントラストしきい値計算に失敗しました。 コントラスト感度が許容範囲を超えています。
GetFormat(IDMax, [インデックス]) | ReadIDMax 関数の 2D シンボルのフォーマットを表す値を返します。「GetFormat の値」を参照してください。
GetFound(IDMax, インデックス) | インデックスで指定された ID シンボルが検出されたかどうかを返します。検出されなかった場合は 0.0 を返し、検出された場合は 1.0 を返します。
GetGridCols(IDMax, [インデックス]) | 2D シンボルに含まれている列数を返します。
GetGridRows(IDMax, [インデックス]) | 2D シンボルに含まれている行数を返します。
GetGrowth(IDMax, [インデックス]) | 2D シンボルの印刷拡張テストを返します。水平および垂直の印刷拡張が個別に計算され、低い方の得点が返されます。 このテストは、シンボルのセルのサイズが異なるかどうかを調べます。例えば、マーキング法によっては、シンボルの左側から右側に向かってセルのサイズが大きくなることは珍しくありません。高品質のシンボルでは、印刷拡張がほぼないか、まったくありません。印刷拡張テストの結果は、シンボルの比率が不正確になる可能性があるため、多くの場合、不均一性テストの結果にリンクされています。 グレード A (4.0) ≥ -0.50 および ≤ 0.50 グレード B (3.0) ≥ -0.70 および ≤ 0.70 グレード C (2.0) ≥ -0.85 および ≤ 0.85 グレード D (1.0) ≥ -1.00 および ≤ 1.00 グレード F (0.0) < -1.00 または > 1.00 注 : ReadIDMax 関数の [照合] チェックボックスをオンにする必要があります。
GetHeight(IDMax,[インデックス]) | シンボルの高さを返します。 注 : ReadIDMax 関数の [照合] チェックボックスをオンにする必要があります。
GetLearned(IDMax, [インデックス]) | シンボルのモデルが正常に学習された場合は '1'、学習できなかった場合は '0' を返します。 [インデックス] は、DataMatrix の場合は 0、QR の場合は 1、ID の場合は 1 です。[インデックス] は、ReadIDMax とともに使用した場合のみ有効です。
GetLearnedGridCol(IDMax, [インデックス]) | 学習済みの QR コードまたはデータマトリックスシンボル内の列数を返します。
GetLearnedGridRow(IDMax, [インデックス]) | 学習済みの QR コードまたはデータマトリックスシンボル内の行数を返します。
GetLearnedSymbology(IDMax) | ReadIDMax が現在学習済みの 1D シンボルを含む文字列を返します。
GetMirror(IDMax, [インデックス]) | データマトリックスまたは QR コードシンボルの鏡像化の状態 (0 = 鏡像にしない、1 = 鏡像にする) を返します。
GetModuleSize(IDMax, [インデックス]) | 2D モジュールのサイズを返します。
GetNumResults(IDMax) | 検出されたデコード済み結果の数を返します。
GetRawStream(IDMax, [インデックス]) | Code 128 シンボルの読み取りシンボルから、デコードされていないデータストリームを返します。
GetResolution(IDMax, [インデックス]) | 2D シンボルの場合、セルの平均サイズ (ピクセル単位) を返します。厳密には品質検証テストではありませんが、解像度によって、シンボル内のエレメント (またはセル) の平均サイズをピクセル単位で測定します。シンボルのタイプごとに最小解像度が指定されています。 データマトリックス:4 ピクセル/エレメント QR コード:4 ピクセル/エレメント PDF 417:3 ピクセル/エレメント
GetString(IDMax, [インデックス]) | インデックス付き結果から文字列を返します。[インデックス] が提供されない場合は、結果 0 を返します。 注 : 文字列に NULL (0x00) が含まれている場合、自動的に文字を "<NUL>" に変換します。
GetStringIDMax(IDMax,変換モード,[インデックス]) | 選択した変換モード (0、1 または 2、デフォルト = 0) を基準にしてインデックス付き結果から文字列を返します。この変換モードは印刷できない ASCII 文字の処理方法を指定します。 変換モードを 0 に設定すると、ASCII 文字 0x00 を <NUL> に変換します。 変換モードを 1 に設定すると、次の表を使用してすべての印刷不可の ASCII 文字 (0 ～ 31､127 ～ 255) を変換します。
0x00 | "<NUL>"
0x01 | "<SOH>"
0x02 | "<STX>"
0x03 | "<ETX>"
0x04 | "<EOT>"
0x05 | "<ENQ>"
0x06 | "<ACK>"
0x07 | "<BEL>"
0x08 | "<BS>"
0x09 | "<HT>"
0x0a | "<LF>"
0x0b | "<VT>"
0x0c | "<FF>"
0x0d | "<CR>"
0x0e | "<SO>"
0x0f | "<SI>"
0x10 | "<DLE>"
0x11 | "<DC1>"
0x12 | "<DC2>"
0x13 | "<DC3>"
0x14 | "<DC4>"
0x15 | "<NAK>"
0x16 | "<SYN>"
0x17 | "<ETB>"
0x18 | "<CAN>"
0x19 | "<EM>"
0x1a | "<SUB>"
0x1b | "<ESC>"
0x1c | "<FS>"
0x1d | "<GS>"
0x1e | "<RS>"
0x1f | "<US>"
0x7f | "<DEL>"
注 : 表に記載されていない印刷不可の ASCII 文字は "<X>" として変換されます。ここで、X は 10 進値です。
変換モードを 2 に設定すると、CR (0x0d) と LF (0x0a) を除いたすべての印刷できない ASCII 文字を変換します。
GetSymbologyIdentifier(IDMax, [インデックス]) | ISO 15424 仕様に基づき、シンボルのタイプを 3 文字コードとして返します。
GetWidth(IDMax,[インデックス]) | シンボルの幅を返します。 注 : ReadIDMax 関数の [照合] チェックボックスをオンにする必要があります。
GetX(IDMax, [インデックス 1], [インデックス 2]) | X 座標を返します。ReadIDMax の場合、インデックス 2 はシンボルのコーナーを指定します。
GetY(構造体, [インデックス 1], [インデックス 2]) | Y 座標を返します。ReadIDMax の場合、インデックス 2 はシンボルのコーナーを指定します。
SetSymbolMinStringLength(IDMax,シンボル,MinLength) | 参照されている IDMax 構造体の指定したシンボルの最小文字列長を設定します。
IDMax | ReadIDMax(画像, フィクスチャ, 領域, ...) 1D および 2D バーコードやシンボル体系に含まれている英数文字列を読み取り、オプションで検証します。デコードした文字列とともに IDCode 構造体を返します。
シンボル | 指定したシンボル [Interleaved 2 of 5(73) のみをサポート]
MinLength | 最小文字列長の整数、最大 = 80。