このページの一部は機械翻訳であり、まだ人による確認が行われていません。

バーコード検出

注釈

この API には有効な ソフトウェアライセンス が必要です。

バーコード検出 API を使用すると、2D 画像内のバーコードを検出およびデコードできます。

バーコードは、製品番号などの情報をエンコードする平行線、スペース、または形状のパターンによる、視覚的で機械読み取り可能なデータ表現です。 Zivid SDK は、以下の線形(1D)およびマトリックス(2D)バーコード形式をサポートしています。

  • リニア:EAN-13、EAN-8、Code 128、Code 93、Code 39、UPC-A [1]、UPC-E、ITF

  • マトリックス:QR コード、データマトリックス

EAN-13 EAN-13
EAN-8 EAN-8
Code 128 Code 128
Code 93 Code 93
Code 39 Code 39
UPC-A UPC-A
UPC-E UPC-E
QR コード QR コード
データマトリックス データマトリックス

サポートされているバーコード形式の例。

バーコードのサイズはさまざまであり、最小のバーまたはスペースの幅が主なサイズパラメータとなります。この最小の特徴は モジュールサイズ (または X 寸法)と呼ばれ、一般にミル単位で表され、1 ミルは 1/1000 インチ(0.0254 mm)です。例えば、標準的な小売用リニアバーコードは通常 7 ミル(0.178 mm)から 13 ミル(0.330 mm)の範囲で変動します。バーコードが小さいほど、確実に検出・デコードするためにより高い解像度が必要です。

8 ミル 8 ミル
10 ミル 10 ミル
12 ミル 12 ミル

同じ距離から撮影した、異なるサイズの Code 128 バーコードの例。

バーコード検出 API

まず、バーコード検出器を初期化します。これは一度だけ実行すればよく、キャプチャするたびに実行する必要はありません。

ソースへ移動

ソース

const auto barcodeDetector = Zivid::Experimental::Toolbox::BarcodeDetector();
ソースへ移動

ソース

barcode_detector = BarcodeDetector()

次に、すべての形式を検索するのではなく、サポートされているバーコード形式の中から検出対象を指定します。これにより、検出速度が向上し、デコードもより安定します。この例では、簡略化のためにサポートされているすべての形式を選択します。

ソースへ移動

ソース

// Select your specific barcode formats for optimal performance
const auto linearFormatFilter = LinearBarcodeFormat::code128 | LinearBarcodeFormat::code93
                                | LinearBarcodeFormat::code39 | LinearBarcodeFormat::ean13
                                | LinearBarcodeFormat::ean8 | LinearBarcodeFormat::upcA
                                | LinearBarcodeFormat::upcE | LinearBarcodeFormat::itf;
const auto matrixFormatFilter = MatrixBarcodeFormat::qrcode | MatrixBarcodeFormat::dataMatrix;
ソースへ移動

ソース

# Select your specific barcode formats for optimal performance
linear_format_filter = {
    LinearBarcodeFormat.code128,
    LinearBarcodeFormat.code93,
    LinearBarcodeFormat.code39,
    LinearBarcodeFormat.ean13,
    LinearBarcodeFormat.ean8,
    LinearBarcodeFormat.upcA,
    LinearBarcodeFormat.upcE,
    LinearBarcodeFormat.itf,
}
matrix_format_filter = {MatrixBarcodeFormat.qrcode, MatrixBarcodeFormat.dataMatrix}

バーコードの検出とデコードを正しく行うには、鮮明で露出の適切な 2D 画像が不可欠です。バーコード検出器が推奨する 2D 設定を使用して、2D フレームをキャプチャしてください。

ソースへ移動

ソース

const auto settings2d = barcodeDetector.suggestSettings(camera);
const auto frame2d = camera.capture2D(settings2d);
ソースへ移動

ソース

settings_2d = barcode_detector.suggest_settings(camera)
frame_2d = camera.capture_2d(settings_2d)

リニアバーコードは、検出とデコードの 2 つのステップで処理されます。検出では、画像内でバーコードを含む可能性が高い候補領域を特定します。この時点ではデコードはまだ試みられていないため、候補リストには誤検出が含まれることがあります。これは、バーコードに似ているものの実際にはバーコードではない領域です。デコードでは、各候補から実際のコードを読み取ります。候補をデコードできなかった場合、対応する結果は空になります。

注釈

よりシンプルな 1 回の呼び出しで済む方法として、検出とデコードを 1 つの関数呼び出しにまとめた readLinearCodes を使用できます。2 段階のアプローチでは、デコードの前に候補領域とそのバウンディングボックスに明示的にアクセスできます。

リニアバーコードの候補領域を検出します。

ソースへ移動

ソース

const auto detectionResults = barcodeDetector.detectLinearCodes(frame2d);
ソースへ移動

ソース

detection_results = barcode_detector.detect_linear_codes(frame_2d)

次に、検出された候補をデコードします。

ソースへ移動

ソース

const auto decodingResults = barcodeDetector.decodeLinearCodes(detectionResults, linearFormatFilter);
ソースへ移動

ソース

decoding_results = barcode_detector.decode_linear_codes(detection_results, linear_format_filter)

候補とそのデコード結果を併せて表示します。各検出候補はバウンディングボックスを公開し、各デコード結果はコード、フォーマット、およびそれぞれのバウンディングボックスを公開します。

ソースへ移動

ソース

if(!detectionResults.empty())
{
    std::cout << "Detected " << detectionResults.size() << " linear barcode candidates:" << std::endl;
    for(size_t i = 0; i < detectionResults.size(); ++i)
    {
        std::cout << "-- Candidate " << (i + 1) << ":" << std::endl;
        std::cout << "   Bounding box: " << detectionResults[i].boundingBox() << std::endl;
        const auto &decodingResult = decodingResults[i];
        if(decodingResult.has_value())
        {
            const auto &decoded = decodingResult.value();
            std::cout << "   Code:         " << decoded.code() << std::endl;
            std::cout << "   Format:       " << toString(decoded.codeFormat()) << std::endl;
            std::cout << "   Bounding box: " << decoded.boundingBox() << std::endl;
        }
        else
        {
            std::cout << "   Failed to decode" << std::endl;
        }
    }
}
else
{
    std::cout << "No linear barcode candidates detected" << std::endl;
}
ソースへ移動

ソース

if detection_results:
    print(f"Detected {len(detection_results)} linear barcode candidates:")
    for i, (candidate, decoded) in enumerate(zip(detection_results, decoding_results, strict=False)):
        print(f"-- Candidate {i + 1}:")
        print(f"   Bounding box: {candidate.bounding_box()}")
        if decoded is not None:
            print(f"   Code:         {decoded.code()}")
            print(f"   Format:       {decoded.code_format()}")
            print(f"   Bounding box: {decoded.bounding_box()}")
        else:
            print("   Failed to decode")
else:
    print("No linear barcode candidates detected")

マトリックスバーコードには 2 段階の API はありません。検出とデコードを 1 回の呼び出しで行うには readMatrixCodes を使用します。

ソースへ移動

ソース

const auto matrixBarcodeResults = barcodeDetector.readMatrixCodes(frame2d, matrixFormatFilter);
ソースへ移動

ソース

matrix_barcode_results = barcode_detector.read_matrix_codes(frame_2d, matrix_format_filter)

デコードされたマトリックスバーコードを、そのバウンディングボックスとともに表示します。

ソースへ移動

ソース

if(!matrixBarcodeResults.empty())
{
    std::cout << "Detected " << matrixBarcodeResults.size() << " matrix barcodes:" << std::endl;
    for(const auto &result : matrixBarcodeResults)
    {
        std::cout << "-- Code:         " << result.code() << std::endl;
        std::cout << "   Format:       " << toString(result.codeFormat()) << std::endl;
        std::cout << "   Bounding box: " << result.boundingBox() << std::endl;
    }
}
else
{
    std::cout << "No matrix barcodes detected" << std::endl;
}
ソースへ移動

ソース

if matrix_barcode_results:
    print(f"Detected {len(matrix_barcode_results)} matrix barcodes:")
    for result in matrix_barcode_results:
        print(f"-- Code:         {result.code()}")
        print(f"   Format:       {result.code_format()}")
        print(f"   Bounding box: {result.bounding_box()}")
else:
    print("No matrix barcodes detected")

Zivid Studio でのバーコード検出

Tip

Zivid Studio におけるバーコード検出には、ソフトウェアライセンスは必要ありません。

Zivid Studio を使えば、バーコード検出を簡単にテストできます。カメラを接続し、バーコードプリセットを選択して、バーコードを含むシーンの 2D キャプチャを実行します。次に View → Show barcodes をクリックすると、画像内のデコードされたバーコードを視覚的に確認できます。

Zivid Studio でのバーコード検出

Zivid Studio で視覚化された検出済みバーコード。

View → Configure barcodes to detect で特定のバーコード形式を選択することで、検出を高速化できます。

バーコード検出性能

検出とデコードの性能は、以下の複数の要因に依存します。

  • バーコードサイズ

  • バーコードまでの距離

  • 画像解像度

  • 画像のフォーカス

  • 水平および垂直 FOV

これらの要因はバーコード表面の空間解像度を構成するものであり、信頼性の高い検出とデコードのためにはこの解像度を最大化することが重要です。

画像解像度とフォーカスはカメラ設定で制御できます。最適なキャプチャ設定には BarcodeDetector::suggestSettings(camera) の使用を推奨します。カメラの水平および垂直 FOV はカメラモデルごとに固定されており、FOV が広いほど空間解像度は低下します。バーコードまでの距離はいくつかの制約内でアプリケーションによって制御できますが、カメラの動作範囲によっても制限されます。

したがって、バーコード検出に推奨されるカメラは、動作範囲内で十分な空間解像度を提供する Zivid 2+ MR130 および MR60 です。以下に、FOV 内のさまざまな距離、向き、配置で検証された各種静的バーコードのベンチマークを示します。

Tip

信頼性の高いデコード結果を得るには、緑色の領域内に留まってください。

バージョン履歴

SDK

変更点

2.18.0

リニアバーコードの検出とデコードが 2 つのステップに分離されました。detectLinearCodes は候補領域を LinearBarcodeDetectionResult として返します。decodeLinearCodes は検出結果を受け取り、デコードされたコードを LinearBarcodeDecodingResult として返します。MatrixBarcodeDetectionResult は MatrixBarcodeDecodingResult に名称変更されました。すべての結果タイプがバウンディングボックスを公開するようになりました。ITF(Interleaved 2 of 5)がサポートされるリニアバーコード形式に追加されました。UPC-A コードは、UPC-A が EAN-13 の有効なサブセットであるため、EAN-13 として返されるようになりました(ただし、フォーマットフィルタに UPC-A のみが含まれる場合を除きます)。

2.17.0

バーコード検出 API が追加されました。