pao_barcode

Pure Dart バーコード生成ライブラリ ユーザーズマニュアル

たった数行で、19種のバーコードを Flutter アプリに。PDF帳票も Canvas 描画も、Pure Dart で。

バージョン 1.1

2026年2月

有限会社 パオ・アット・オフィス

https://www.pao.ac/

目次

1. はじめに — pao_barcode の世界へようこそ
2. 1.1 pao_barcodeとは
3. 1.2 できること
4. 1.3 対応バーコード一覧（19種）
5. 1.4 3つの出力方式
6. 1.5 他のBarcode製品との違い

7. 1.6 デモサイト

8. インストール — pubspec.yaml に1行追加するだけ

9. 2.1 pubspec.yamlへの追加
10. 2.2 依存パッケージ

11. 2.3 動作確認

12. クイックスタート — 最初の1本を表示しよう

13. 3.1 エンコーダーとレンダラー
14. 3.2 BarcodeWidgetで画面表示（最も簡単）
15. 3.3 PdfRendererでPDF出力

16. 3.4 SVGベクター出力（レンダラー不要）

17. CanvasRenderer ガイド — 画面表示もPNG出力も

18. 4.1 CanvasRendererの基本
19. 4.2 BarcodeWidget による画面表示
20. 4.3 CustomPainter での描画
21. 4.4 PNG画像への出力
22. 4.5 透明背景のバーコード

23. 4.6 色のカスタマイズ

24. PdfRenderer ガイド — PDF帳票にバーコードを直接描こう

25. 5.1 PdfRendererの基本
26. 5.2 実例1: 納品書
27. 5.3 実例2: 商品ラベル一括印刷
28. 5.4 実例3: コンビニ払込票
29. 5.5 実例4: 配送伝票（QR + 1D複合）
30. 5.6 座標系とサイズ

31. 5.7 日本語フォント

32. サンプルコード集 — 全19種を動かそう

33. 6.1 1次元バーコード
34. 6.2 2次元バーコード
35. 6.3 GS1系バーコード
36. 6.4 郵便カスタマバーコード

37. 6.5 Flutter Web連携

38. APIリファレンス

39. 7.1 共通メソッド（全バーコード）
40. 7.2 1次元バーコード共通メソッド
41. 7.3 〜 7.18 各バーコードタイプ
42. 7.19 〜 7.21 2次元バーコード
43. 7.22 CanvasRenderer
44. 7.23 PdfRenderer

45. 7.24 BarcodeWidget

46. 動作環境

47. ライセンス・お問い合わせ

48. 9.1 使用許諾
49. 9.2 ライセンス

1. はじめに — pao_barcode の世界へようこそ

1.1 pao_barcodeとは

pao_barcode は、Pure Dart で書かれた Flutter 向けバーコード生成ライブラリです。

C++で開発された高性能バーコードエンジンを Dart に忠実に移植。全19種類のバーコードに対応し、PDF帳票への直接描画、Canvas描画（画面表示・PNG出力）、SVGベクター出力の3つの出力方式をサポートしています。

Pure Dart だから、ネイティブプラグインもFFIも不要。iOS / Android / Web / Windows / macOS / Linux — Flutter が動くすべてのプラットフォームで、そのまま使えます。

// たったこれだけで、バーコードが画面に表示されます
BarcodeWidget(
  barcode: Code128(),
  data: 'Hello-2024',
  width: 300,
  height: 100,
)

1.2 できること

pao_barcode を使うと、こんなことができます:

ヒント: BarcodeWidget、CanvasRenderer、SVG出力は追加パッケージ不要。pao_barcode 単体で動きます。pdf パッケージが必要なのは PDF帳票出力のときだけ。

1.3 対応バーコード一覧（19種）

1次元バーコード（11種類）

UPCバーコード（1種類）

GS1 DataBar（3種類）

2次元バーコード（3種類）

特殊バーコード（1種類）

ヒント: 「どのバーコードを使えばいいかわからない」という方へ。迷ったらまず Code128（1D）か QRコード（2D）から始めてみてください。この2つでほとんどのユースケースをカバーできます。

1.4 3つの出力方式

pao_barcode は「エンコーダー」と「レンダラー」が分離された設計です。エンコーダーがバーコードデータを計算し、レンダラーがそれを可視化します。

ヒント: Flutter アプリに表示するだけなら BarcodeWidget が最も簡単。PDF帳票を生成するなら PdfRenderer。どちらも Pure Dart なので、プラットフォームを問わず動きます。

1.5 他のBarcode製品との違い

パオ・アット・オフィスのバーコードライブラリには複数の製品があります:

Pure Dart版を選ぶ理由:

• Flutter アプリにバーコードを表示したい → BarcodeWidget で数行
• iOS/Android/Web/Desktop すべてで動かしたい → ネイティブプラグイン不要
• PDF帳票にバーコードを直接描画したい → PdfRenderer で pdf パッケージに統合
• ネイティブ依存なしで全プラットフォーム対応 → プラグイン不要で安定動作

ヒント: Flutter アプリでバーコードを使いたいなら、Pure Dart版 (pao_barcode) 一択です。ネイティブプラグインに依存しないので、ビルドの問題も少なく、全プラットフォームで安定動作します。

1.6 デモサイト

実際の動作をブラウザで確認できるデモサイトを公開しています:

• Flutter Pure Dart版デモ（All-in-One）: https://www.pao.ac/demo/barcode-flutter/

全19種のバーコード生成、PDF帳票出力、Canvas描画をお試しいただけます。

2. インストール — pubspec.yaml に1行追加するだけ

2.1 pubspec.yamlへの追加

dependencies:
  pao_barcode:
    path: /path/to/pao_barcode  # ローカルパス
    # または git URL / pub.dev からの取得

その後:

flutter pub get

Pure Dart なので、ネイティブビルドの設定は一切不要です。

2.2 依存パッケージ

用途に応じて追加してください:

pdf（PDF帳票出力に必要）

dependencies:
  pdf: ^3.10.0

PDF帳票のキャンバスにバーコードを直接描画する PdfRenderer を使うために必要です。

printing（PDF印刷・プレビューに必要）

dependencies:
  printing: ^5.11.0

全部入り構成

dependencies:
  flutter:
    sdk: flutter
  pao_barcode:
    path: ./pao_barcode
  pdf: ^3.10.0
  printing: ^5.11.0

ヒント: BarcodeWidget や CanvasRenderer だけなら pao_barcode 単体で動きます。pdf パッケージは PDF帳票を生成するときだけ追加すれば大丈夫。

2.3 動作確認

import 'package:pao_barcode/pao_barcode.dart';

void main() {
  // エンコーダーの動作確認
  final bc = Code128();
  final pattern = bc.encode('TEST1234');
  print('Code128 パターン: ${pattern.length} 要素');
  // → Code128 パターン: 33 要素

  // QRコードの動作確認
  final qr = QR();
  final matrix = qr.getPattern('Hello World');
  print('QRコード: ${matrix.length}x${matrix[0].length} モジュール');
  // → QRコード: 25x25 モジュール
}

3. クイックスタート — 最初の1本を表示しよう

3.1 エンコーダーとレンダラー

pao_barcode は エンコーダー（バーコードデータの計算）と レンダラー（描画）を分離した設計です。エンコーダーが「バーの並び」を計算し、レンダラーがそれを「画面やPDFに見える形」にします。

import 'package:pao_barcode/pao_barcode.dart';

// --- 1Dバーコード ---
// encode() → バーとスペースの幅が交互に並んだリスト
final bc = Code128();
final pattern = bc.encode('Hello-2024');
// pattern = [2, 1, 1, 2, 3, 2, ...]  ← bar幅, space幅, bar幅, ... の交互

// --- 2Dバーコード ---
// getPattern() → 2Dブーリアン行列
final qr = QR();
final matrix = qr.getPattern('https://www.pao.ac/');
// matrix[row][col] = true(黒) or false(白)

// --- JAN/UPCバーコード ---
final jan = JAN13();
final janPattern = jan.encode('4901234567894');

エンコーダーの出力は数値データだけ。描画には CanvasRenderer（画面・PNG用）か PdfRenderer（PDF用）を使います。

ヒント: エンコーダーの出力を独自のレンダラーで描画することも可能です。たとえば encode() の結果を使って、自前のCanvasロジックに組み込めます。

3.2 BarcodeWidgetで画面表示（最も簡単）

Flutter アプリにバーコードを表示する最も簡単な方法です:

import 'package:flutter/material.dart';
import 'package:pao_barcode/pao_barcode.dart';

class MyBarcodeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: BarcodeWidget(
          barcode: Code128(),
          data: 'Hello-2024',
          width: 300,
          height: 100,
        ),
      ),
    );
  }
}

ヒント: BarcodeWidget は CustomPainter を内部で使っており、効率的に描画されます。サイズを null にすると親 Widget のサイズに合わせて自動的にフィットします。

PNG画像として出力

import 'package:pao_barcode/pao_barcode.dart';

Future<Uint8List> generateBarcodePng() async {
  final renderer = CanvasRenderer();
  final bc = Code128();

  // PNG bytes を生成
  final pngBytes = await renderer.renderToPng(bc, 'Hello-2024', 400, 100);
  return pngBytes;
}

3.3 PdfRendererでPDF出力

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:pao_barcode/pao_barcode.dart';

pw.Document createPdfWithBarcode() {
  final doc = pw.Document();

  doc.addPage(
    pw.Page(
      build: (context) {
        return pw.Column(
          children: [
            pw.Text('注文番号'),
            pw.SizedBox(height: 10),
            pw.CustomPaint(
              size: const PdfPoint(200, 50),
              painter: (canvas, size) {
                final renderer = PdfRenderer(canvas);
                final bc = Code128();
                renderer.draw(bc, '1234567890', 0, 0, size.x, size.y);
              },
            ),
          ],
        );
      },
    ),
  );

  return doc;
}

ヒント: PdfRenderer は pdf パッケージのキャンバスにベクターデータとして直接描画します。画像を貼り付けるのとは違い、拡大してもくっきり、ファイルサイズも小さい。

3.4 SVGベクター出力（レンダラー不要）

SVG出力はエンコーダー単体で行えます。レンダラーは不要です。

import 'package:pao_barcode/pao_barcode.dart';

String generateSvg() {
  final bc = Code128();
  bc.setOutputFormat('svg');    // SVGモードに切り替え
  bc.setShowText(true);

  // 描画実行 → SVG文字列を取得
  bc.draw('Hello-2024', 0, 0, 400, 100);
  return bc.getSvg();
}

ヒント: SVG出力は追加パッケージ不要。flutter_svg と組み合わせてアプリ内に表示したり、ファイルとしてエクスポートしたりできます。

4. CanvasRenderer ガイド — 画面表示もPNG出力も

Flutter アプリにバーコードを組み込む道は2つ。お手軽な BarcodeWidget か、自由度の高い CanvasRenderer + CustomPainter か。どちらも Pure Dart、追加パッケージ不要です。

4.1 CanvasRendererの基本 — Canvas に何でも描ける

import 'package:pao_barcode/pao_barcode.dart';

// CanvasRenderer を作成（オプションはすべて省略可能）
final renderer = CanvasRenderer(
  foreColor: Colors.black,     // バーの色。デフォルト: 黒
  backColor: Colors.white,     // 背景色。デフォルト: 白
  showText: true,              // テキスト表示。デフォルト: true
  fontSize: 14,                // フォントサイズ。デフォルト: 14
  quietZone: 0,                // クワイエットゾーン比率。デフォルト: 0
);

// Canvas に描画
renderer.draw(canvas, barcode, data, x, y, width, height);

CanvasRenderer コンストラクタパラメータ:

Canvas 座標系について:

Flutter の Canvas は 原点が左上、Y軸が下向き の画像座標系です。(x, y) はバーコード描画領域の 左上隅 を指定します。

(0,0) ------> X
  |
  |   ┌──────────────┐
  |   │  バーコード    │
  |   └──────────────┘
  v
  Y

ヒント: CanvasRenderer は draw() 1回で背景塗りつぶし + バーコード描画 + テキスト描画をすべて行います。Canvas の save()/restore() は内部では使わないので、呼び出し側で自由にクリッピングや変換を適用できます。

4.2 BarcodeWidget による画面表示 — いちばん簡単な方法

BarcodeWidget は CanvasRenderer を内部に包んだ便利な Widget です。数行で Flutter アプリにバーコードを表示できます。

商品ラベルの例

import 'package:flutter/material.dart';
import 'package:pao_barcode/pao_barcode.dart';

class ProductLabel extends StatelessWidget {
  final String productName;
  final String janCode;

  const ProductLabel({
    super.key,
    required this.productName,
    required this.janCode,
  });

  @override
  Widget build(BuildContext context) {
    return Card(
      child: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text(productName, style: const TextStyle(fontSize: 18)),
            const SizedBox(height: 12),
            BarcodeWidget(
              barcode: JAN13(),
              data: janCode,
              width: 250,
              height: 80,
            ),
          ],
        ),
      ),
    );
  }
}

// 使用例:
// ProductLabel(productName: 'チョコレート', janCode: '4901234567894')

BarcodeWidget プロパティ一覧

ヒント: width と height を null にすると、BarcodeWidget は LayoutBuilder を使って親 Widget のサイズに自動フィットします。Expanded や Flexible の中で使うときに便利です。

4.3 CustomPainter での描画 — 複数バーコードを自由にレイアウト

1つのキャンバスに複数のバーコードを配置したい場合は、CustomPainter を使います。

import 'package:flutter/material.dart';
import 'package:pao_barcode/pao_barcode.dart';

class MultiBarcodePainter extends CustomPainter {
  @override
  void paint(Canvas canvas, Size size) {
    final renderer = CanvasRenderer(fontSize: 12);

    // 上部: Code128 で注文番号
    final code128 = Code128();
    renderer.draw(canvas, code128, 'ORDER-2024-0042',
        10, 10, size.width - 20, 60);

    // 中央: QRコード
    final qr = QR();
    renderer.draw(canvas, qr, 'https://www.pao.ac/',
        10, 80, 100, 100);

    // 右下: JAN-13 で商品コード
    final jan13 = JAN13();
    renderer.draw(canvas, jan13, '4901234567894',
        120, 100, 180, 60);
  }

  @override
  bool shouldRepaint(covariant CustomPainter oldDelegate) => false;
}

// Widget ツリーで使用
class MultiBarcodePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('複合バーコード')),
      body: Center(
        child: SizedBox(
          width: 320,
          height: 200,
          child: CustomPaint(painter: MultiBarcodePainter()),
        ),
      ),
    );
  }
}

ヒント: shouldRepaint() で false を返すと、再描画を抑制してパフォーマンスを最適化できます。データが変わる場合は、旧デリゲートと比較して変更がある場合だけ true を返しましょう。

4.4 PNG画像への出力 — ファイル保存もBase64もおまかせ

renderToPng で PNG バイト列を生成

import 'package:pao_barcode/pao_barcode.dart';

Future<Uint8List> generateBarcodePng() async {
  final renderer = CanvasRenderer(showText: true, fontSize: 14);
  final bc = Code128();

  // PNG bytes を生成（非同期）
  final pngBytes = await renderer.renderToPng(bc, 'Hello-2024', 400, 100);
  return pngBytes;
}

ファイルに保存

import 'dart:io';
import 'package:pao_barcode/pao_barcode.dart';

Future<void> saveBarcodeToFile() async {
  final renderer = CanvasRenderer();
  final bc = JAN13();

  final pngBytes = await renderer.renderToPng(
    bc, '4901234567894', 400, 120,
  );

  final file = File('barcode_jan13.png');
  await file.writeAsBytes(pngBytes);
  print('保存完了: ${file.path}');
}

Base64 データ URI（Flutter Web で便利）

import 'dart:convert';
import 'package:pao_barcode/pao_barcode.dart';

Future<String> generateBase64DataUri() async {
  final renderer = CanvasRenderer();
  final qr = QR();

  final pngBytes = await renderer.renderToPng(
    qr, 'https://www.pao.ac/', 300, 300,
  );

  // Base64 データ URI に変換
  final base64String = base64Encode(pngBytes);
  return 'data:image/png;base64,$base64String';
}

ヒント: renderToPng() は内部で PictureRecorder → Canvas → Picture → Image → PNG bytes という変換を行います。非同期処理なので await を忘れずに。Flutter Web でも動作します。

4.5 透明背景のバーコード — 既存デザインに溶け込ませる

背景を透明にすると、バーだけが描画されて既存のUIデザインに自然に溶け込みます。

import 'package:flutter/material.dart';
import 'package:pao_barcode/pao_barcode.dart';

// 透明背景の BarcodeWidget
BarcodeWidget(
  barcode: Code128(),
  data: 'TRANSPARENT',
  width: 300,
  height: 80,
  backColor: Colors.transparent,  // 背景を透明に
)

// CanvasRenderer で透明背景
final renderer = CanvasRenderer(
  backColor: Colors.transparent,
  foreColor: Colors.black87,
);

ヒント: 透明背景は Container の decoration で背景画像やグラデーションを設定した上にバーコードを重ねるときに活躍します。ただし、バーコードの読み取り精度を保つため、バーと背景のコントラストは十分に確保してください。

4.6 色のカスタマイズ — ブランドカラーで差をつける

import 'package:flutter/material.dart';
import 'package:pao_barcode/pao_barcode.dart';

// ブランドカラーのバーコード
BarcodeWidget(
  barcode: QR(),
  data: 'https://example.com/',
  width: 200,
  height: 200,
  foreColor: const Color(0xFF1A237E),  // インディゴ
  backColor: const Color(0xFFFFF8E1),  // クリーム色
)

実用的なカラーパターン

// パターン1: 紺 × 白（ビジネス文書向き）
BarcodeWidget(
  barcode: Code128(),
  data: 'INVOICE-001',
  width: 280, height: 70,
  foreColor: const Color(0xFF0D47A1),
  backColor: Colors.white,
)

// パターン2: ダークグリーン × ライトグリーン（エコ系ブランド）
BarcodeWidget(
  barcode: JAN13(),
  data: '4901234567894',
  width: 250, height: 80,
  foreColor: const Color(0xFF1B5E20),
  backColor: const Color(0xFFE8F5E9),
)

// パターン3: 白 × ダーク（ダークモード対応）
BarcodeWidget(
  barcode: QR(),
  data: 'https://www.pao.ac/',
  width: 150, height: 150,
  foreColor: Colors.white,
  backColor: const Color(0xFF212121),
)

ヒント: QRコードは色のコントラストに対して比較的寛容ですが、1Dバーコード（特にJAN/UPC）はスキャナーの読み取り精度に直結します。業務用途では黒×白を推奨します。カラーバーコードはWebやアプリ表示専用と考えてください。

5. PdfRenderer ガイド — PDF帳票にバーコードを直接描こう

pao_barcode の強力な機能、それは pdf パッケージで作成するPDF帳票にバーコードをベクターデータとして直接描画できること。画像を貼り付けるのとは違い、拡大しても鮮明、ファイルサイズも最小限です。

5.1 PdfRendererの基本 — pdf パッケージのキャンバスに描く

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:pao_barcode/pao_barcode.dart';

// PdfRenderer は pdf パッケージの PdfGraphics を受け取ります
// pw.CustomPaint のコールバック内で使用するのが基本形です

PdfRenderer コンストラクタ:

PdfRenderer(
  canvas,                                // PdfGraphics（必須）
  foreColor: PdfColors.black,            // 前景色。デフォルト: 黒
  backColor: PdfColors.white,            // 背景色。デフォルト: 白
  showText: true,                        // テキスト表示。デフォルト: true
  fontName: 'Helvetica',                 // フォント名。デフォルト: 'Helvetica'
  fontSize: 8,                           // フォントサイズ(pt)。デフォルト: 8
  quietZone: 0,                          // クワイエットゾーン比率。デフォルト: 0
);

PDF 座標系について（Canvas と逆です！）:

pdf パッケージは 原点が左下、Y軸が上向き のPDF標準座標系です。(x, y) はバーコード描画領域の 左下隅 を指定します。単位は ポイント（1ポイント = 1/72インチ）。

  Y
  ^
  |   ┌──────────────┐
  |   │  バーコード    │
  |   └──────────────┘
  |
(0,0) ------> X

ヒント: CanvasRenderer は「原点が左上、Y下向き」、PdfRenderer は「原点が左下、Y上向き」。逆なので、Canvas用のコードをそのままPDFに持ち込むと上下反転します。PdfRenderer はこの違いを内部で吸収しているので、描画結果は正しく出ます。

5.2 実例1: 納品書 — 注文番号バーコード付き帳票

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:pao_barcode/pao_barcode.dart';

pw.Document createDeliveryNote() {
  final doc = pw.Document();

  doc.addPage(
    pw.Page(
      pageFormat: PdfPageFormat.a4,
      build: (context) {
        return pw.Column(
          crossAxisAlignment: pw.CrossAxisAlignment.start,
          children: [
            // ヘッダー
            pw.Text('納品書',
                style: pw.TextStyle(fontSize: 24, fontWeight: pw.FontWeight.bold)),
            pw.SizedBox(height: 10),
            pw.Text('2024年12月1日'),
            pw.SizedBox(height: 20),

            // 注文番号バーコード
            pw.Text('注文番号: ORD-2024-0042', style: const pw.TextStyle(fontSize: 12)),
            pw.SizedBox(height: 5),
            pw.CustomPaint(
              size: const PdfPoint(250, 50),
              painter: (PdfGraphics canvas, PdfPoint size) {
                final renderer = PdfRenderer(canvas);
                final bc = Code128();
                renderer.draw(bc, 'ORD-2024-0042', 0, 0, size.x, size.y);
              },
            ),
            pw.SizedBox(height: 20),

            // 商品テーブル
            pw.Table.fromTextArray(
              headers: ['品名', '数量', '単価', '小計'],
              data: [
                ['Flutter入門書', '2', '3,200', '6,400'],
                ['Dartリファレンス', '1', '4,500', '4,500'],
                ['USBケーブル', '5', '800', '4,000'],
              ],
            ),
            pw.SizedBox(height: 10),
            pw.Align(
              alignment: pw.Alignment.centerRight,
              child: pw.Text('合計: 14,900円',
                  style: pw.TextStyle(fontSize: 16, fontWeight: pw.FontWeight.bold)),
            ),
          ],
        );
      },
    ),
  );

  return doc;
}

ヒント: pw.CustomPaint の painter コールバックは (PdfGraphics, PdfPoint) を受け取ります。この PdfGraphics をそのまま PdfRenderer のコンストラクタに渡すだけ。Widget ツリーの中にバーコードを自然に埋め込めます。

5.3 実例2: 商品ラベル一括印刷 — GridView で並べる

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:pao_barcode/pao_barcode.dart';

pw.Document createProductLabels(List<Map<String, String>> products) {
  final doc = pw.Document();

  // ラベルWidgetを生成
  final labels = products.map((p) {
    return pw.Container(
      padding: const pw.EdgeInsets.all(8),
      decoration: pw.BoxDecoration(
        border: pw.Border.all(color: PdfColors.grey300),
      ),
      child: pw.Column(
        mainAxisSize: pw.MainAxisSize.min,
        children: [
          pw.Text(p['name']!, style: pw.TextStyle(fontSize: 10,
              fontWeight: pw.FontWeight.bold)),
          pw.SizedBox(height: 4),
          pw.Text('${p['price']}円', style: const pw.TextStyle(fontSize: 8)),
          pw.SizedBox(height: 6),
          pw.CustomPaint(
            size: const PdfPoint(120, 40),
            painter: (PdfGraphics canvas, PdfPoint size) {
              final renderer = PdfRenderer(canvas, fontSize: 6);
              final bc = JAN13();
              renderer.draw(bc, p['jan']!, 0, 0, size.x, size.y);
            },
          ),
        ],
      ),
    );
  }).toList();

  doc.addPage(
    pw.Page(
      pageFormat: PdfPageFormat.a4,
      build: (context) {
        return pw.GridView(
          crossAxisCount: 3,
          childAspectRatio: 1.5,
          children: labels,
        );
      },
    ),
  );

  return doc;
}

// 使用例:
// final products = [
//   {'name': 'チョコレート', 'price': '150', 'jan': '4901234567894'},
//   {'name': 'クッキー',     'price': '200', 'jan': '4902345678901'},
//   {'name': 'キャンディ',   'price': '100', 'jan': '4903456789012'},
//   // ... さらに追加
// ];
// final doc = createProductLabels(products);

ヒント: 1ページに収まりきらない場合は pw.MultiPage を使えば自動で改ページされます。pw.GridView と組み合わせれば、何十枚ものラベルを一度に生成できます。

5.4 実例3: コンビニ払込票 — GS1-128 コンビニバーコード

コンビニ収納代行バーコード（払込票）は GS1-128 の特殊形式です。drawGs1128Convenience メソッドで2行テキスト付きのバーコードを描画できます。

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:pao_barcode/pao_barcode.dart';

pw.Document createPaymentSlip() {
  final doc = pw.Document();

  // コンビニバーコード用データ（{FNC1} + 44桁数字）
  final convenienceData =
      '{FNC1}91234567890123456789012345678901234567890123';

  doc.addPage(
    pw.Page(
      pageFormat: PdfPageFormat.a4,
      build: (context) {
        return pw.Column(
          crossAxisAlignment: pw.CrossAxisAlignment.start,
          children: [
            pw.Text('コンビニ払込票',
                style: pw.TextStyle(fontSize: 20, fontWeight: pw.FontWeight.bold)),
            pw.SizedBox(height: 20),
            pw.Row(
              mainAxisAlignment: pw.MainAxisAlignment.spaceBetween,
              children: [
                pw.Text('お支払い金額: 12,800円'),
                pw.Text('お支払い期限: 2025年3月31日'),
              ],
            ),
            pw.SizedBox(height: 30),

            // GS1-128 コンビニバーコード（2行テキスト付き）
            pw.CustomPaint(
              size: const PdfPoint(350, 80),
              painter: (PdfGraphics canvas, PdfPoint size) {
                final renderer = PdfRenderer(canvas, fontSize: 7);
                final gs1 = GS1_128();
                renderer.drawGs1128Convenience(
                    gs1, convenienceData, 0, 0, size.x, size.y);
              },
            ),
          ],
        );
      },
    ),
  );

  return doc;
}

ヒント: コンビニバーコードの44桁は先頭に {FNC1} を付けて渡します。drawGs1128Convenience() は自動的に2行テキスト（上段: AI+企業コード、下段: 金額+チェックディジット）を描画します。通常の draw() ではなく専用メソッドを使うのがポイントです。

5.5 実例4: 配送伝票（QR + 1D複合） — 追跡番号 + 住所 + QR

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:pao_barcode/pao_barcode.dart';

pw.Document createShippingLabel() {
  final doc = pw.Document();

  doc.addPage(
    pw.Page(
      pageFormat: PdfPageFormat(
        10 * PdfPageFormat.cm, 15 * PdfPageFormat.cm,
      ),
      build: (context) {
        return pw.Column(
          crossAxisAlignment: pw.CrossAxisAlignment.start,
          children: [
            // 追跡番号 (Code128)
            pw.Text('追跡番号', style: const pw.TextStyle(fontSize: 8)),
            pw.CustomPaint(
              size: const PdfPoint(250, 40),
              painter: (PdfGraphics canvas, PdfPoint size) {
                final renderer = PdfRenderer(canvas, fontSize: 7);
                final bc = Code128();
                renderer.draw(bc, '4912345678901', 0, 0, size.x, size.y);
              },
            ),
            pw.SizedBox(height: 10),

            // 郵便カスタマバーコード
            pw.Text('郵便バーコード', style: const pw.TextStyle(fontSize: 8)),
            pw.CustomPaint(
              size: const PdfPoint(200, 20),
              painter: (PdfGraphics canvas, PdfPoint size) {
                final renderer = PdfRenderer(canvas);
                final yb = YubinCustomer();
                renderer.draw(yb, '1050011', 0, 0, size.x, size.y);
              },
            ),
            pw.SizedBox(height: 15),

            // お届け先情報
            pw.Text('お届け先:',
                style: pw.TextStyle(fontSize: 10, fontWeight: pw.FontWeight.bold)),
            pw.Text('105-0011 東京都港区芝公園4-2-8'),
            pw.Text('パオ太郎 様', style: const pw.TextStyle(fontSize: 14)),
            pw.SizedBox(height: 15),

            // QRコード（追跡URLを埋め込み）
            pw.Row(
              children: [
                pw.CustomPaint(
                  size: const PdfPoint(80, 80),
                  painter: (PdfGraphics canvas, PdfPoint size) {
                    final renderer = PdfRenderer(canvas);
                    final qr = QR();
                    renderer.draw(qr,
                        'https://track.example.com/4912345678901',
                        0, 0, size.x, size.y);
                  },
                ),
                pw.SizedBox(width: 10),
                pw.Text('配送状況はQRコードから\nご確認いただけます',
                    style: const pw.TextStyle(fontSize: 8)),
              ],
            ),
          ],
        );
      },
    ),
  );

  return doc;
}

ヒント: 1つのPDFページに異なる種類のバーコードを何個でも描画できます。Code128（追跡番号）+ 郵便カスタマバーコード（住所）+ QR（追跡URL）の組み合わせは、配送伝票の定番パターンです。

5.6 座標系とサイズ — ミリでもセンチでも思いのまま

pdf パッケージはポイント（pt）が基本単位ですが、PdfPageFormat のユーティリティでミリやセンチに変換できます。

// 単位変換定数
final mm = PdfPageFormat.mm;   // 1mm = 2.8346pt
final cm = PdfPageFormat.cm;   // 1cm = 28.346pt
final inch = PdfPageFormat.inch; // 1inch = 72pt

// 例: 50mm x 15mm のバーコード
renderer.draw(bc, data, 10 * mm, 200 * mm, 50 * mm, 15 * mm);

標準用紙サイズ:

// カスタムサイズ（ラベル用紙など）
final labelFormat = PdfPageFormat(
  62 * PdfPageFormat.mm,   // 幅 62mm
  29 * PdfPageFormat.mm,   // 高さ 29mm
);

ヒント: 実際の印刷では余白（マージン）も考慮が必要です。PdfPageFormat.a4.copyWith(marginAll: 1.5 * cm) のように余白を指定すると、context.page.pageFormat.availableWidth で印刷可能領域が取得できます。

5.7 日本語フォント — Noto Sans JP で日本語テキストもきれいに

pdf パッケージのデフォルトフォント（Helvetica）は日本語を含みません。帳票に日本語テキストを表示するには、日本語フォントを読み込みます。

import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;
import 'package:printing/printing.dart';

Future<pw.Document> createJapaneseInvoice() async {
  final doc = pw.Document();

  // Google Fonts から Noto Sans JP を取得
  final jaFont = await PdfGoogleFonts.notoSansJPRegular();
  final jaBoldFont = await PdfGoogleFonts.notoSansJPBold();

  doc.addPage(
    pw.Page(
      pageFormat: PdfPageFormat.a4,
      theme: pw.ThemeData.withFont(
        base: jaFont,
        bold: jaBoldFont,
      ),
      build: (context) {
        return pw.Column(
          crossAxisAlignment: pw.CrossAxisAlignment.start,
          children: [
            pw.Text('請求書',
                style: pw.TextStyle(fontSize: 24,
                    fontWeight: pw.FontWeight.bold)),
            pw.Text('株式会社サンプル 御中'),
            pw.SizedBox(height: 20),
            pw.CustomPaint(
              size: const PdfPoint(200, 50),
              painter: (PdfGraphics canvas, PdfPoint size) {
                final renderer = PdfRenderer(canvas);
                final bc = Code128();
                renderer.draw(bc, 'INV-2024-0001', 0, 0, size.x, size.y);
              },
            ),
          ],
        );
      },
    ),
  );

  return doc;
}

ヒント: PdfGoogleFonts を使うには printing パッケージが必要です。pubspec.yaml に printing: ^5.11.0 を追加してください。フォントファイルは初回にダウンロードされ、以降はキャッシュされます。

6. サンプルコード集 — 全19種を動かそう

ここでは全19種類のバーコードの生成コードを一挙に紹介します。すべて Dart/Flutter のコードです。CanvasRenderer での画面表示・PNG出力を基本としつつ、エンコーダー単体での使い方も示します。

6.1 1次元バーコード — 物流からPOSまで

Code128 — あらゆる業種で活躍する万能選手

import 'package:pao_barcode/pao_barcode.dart';

// 基本: AUTO モード（デフォルト）
// 動的計画法で最短幅になるよう CODE-A/B/C を自動切替
final bc = Code128();
final pattern = bc.encode('Hello-2024');
print('Code128 AUTO: ${pattern.length} 要素');

// CODE-B 固定（ASCII印字可能文字）
final bcB = Code128();
bcB.codeMode = CodeSet128.codeB;
final patternB = bcB.encode('Hello-2024');

// CODE-C 固定（数字ペア専用、高密度）
final bcC = Code128();
bcC.codeMode = CodeSet128.codeC;
final patternC = bcC.encode('12345678');  // 偶数桁の数字のみ

CodeSet128 列挙型:

BarcodeWidget で表示:

BarcodeWidget(
  barcode: Code128(),
  data: 'Hello-2024',
  width: 300,
  height: 80,
)

ヒント: 数字だけのデータなら CODE-C が最もコンパクト（2桁を1シンボルにエンコード）。AUTO モードなら自動的に最短幅を選んでくれるので、通常は AUTO のままで OK です。

Code39 — 工場現場の定番

final bc = Code39();
bc.showStartStop = true;  // スタート/ストップ文字（*）をテキストに表示

BarcodeWidget(
  barcode: bc,
  data: 'HELLO-123',
  width: 350, height: 80,
)

入力可能文字: 数字（0-9）、英大文字（A-Z）、記号（- . $ / + % スペース）

Code93 — Code39 の高密度版

BarcodeWidget(
  barcode: Code93(),
  data: 'Hello123',
  width: 300, height: 80,
)

入力可能文字: ASCII 全文字（内部でシフト文字を使って拡張）

NW-7 (Codabar) — 宅配便の送り状でおなじみ

final bc = NW7();
bc.showStartStop = true;  // スタート/ストップ文字を表示

BarcodeWidget(
  barcode: bc,
  data: 'A1234567890B',  // A-D で始まり A-D で終わる
  width: 350, height: 80,
)

入力可能文字: 数字（0-9）、記号（- . $ / + :）、スタート/ストップ（A, B, C, D）

ヒント: NW-7 のデータは必ず A〜D のいずれかで開始・終了します。スタート/ストップ文字がない場合は自動的に A が付与されます。

ITF — 段ボール箱の物流管理

BarcodeWidget(
  barcode: ITF(),
  data: '1234567890',  // 偶数桁の数字のみ
  width: 300, height: 80,
)

入力可能文字: 数字のみ（偶数桁）

Matrix 2of5 — 航空貨物・工業用途

BarcodeWidget(
  barcode: Matrix2of5(),
  data: '1234567890',
  width: 300, height: 80,
)

NEC 2of5 — 日本国内の工業用途

BarcodeWidget(
  barcode: NEC2of5(),
  data: '1234567890',
  width: 300, height: 80,
)

JAN-13 (EAN-13) — 日本の商品コード

// 12桁を渡すとチェックディジットを自動計算
BarcodeWidget(
  barcode: JAN13(),
  data: '490123456789',  // 12桁 → 13桁目は自動計算
  width: 250, height: 80,
)

// 13桁（チェックディジット込み）でもOK
BarcodeWidget(
  barcode: JAN13(),
  data: '4901234567894',  // 13桁
  width: 250, height: 80,
)

JAN-8 (EAN-8) — 小さな商品に

BarcodeWidget(
  barcode: JAN8(),
  data: '4912345',  // 7桁 → 8桁目は自動計算
  width: 200, height: 80,
)

UPC-A — 北米の商品コード

BarcodeWidget(
  barcode: UPCA(),
  data: '01234567890',  // 11桁 → 12桁目は自動計算
  width: 250, height: 80,
)

UPC-E — 小型商品（UPC-A のゼロ圧縮版）

BarcodeWidget(
  barcode: UPCE(),
  data: '0123456',  // 7桁 → 8桁目は自動計算
  width: 180, height: 80,
)

ヒント: JAN/UPC バーコードはチェックディジットなしで渡すのが一般的です。ライブラリが自動計算してくれます。もちろん、チェックディジット込みの完全な桁数で渡しても正しく動作します。

6.2 2次元バーコード — 情報をぎっしり詰め込む

QRコード — スマホ時代の主役

import 'package:pao_barcode/pao_barcode.dart';

// 基本
final qr = QR();
final matrix = qr.getPattern('https://www.pao.ac/');
print('QRコード: ${matrix.length}x${matrix[0].length}');

// 誤り訂正レベルを変更
final qrH = QR();
qrH.setErrorCorrectionLevel(QRErrorLevel.h);  // 最高レベル（30%復元）

QRErrorLevel 列挙型:

バージョン指定:

final qr = QR();
qr.setVersion(5);  // Version 5（37x37モジュール）を強制
// 0 = 自動（デフォルト）、1-40

QRコード バージョン・サイズ・容量:

BarcodeWidget で表示:

BarcodeWidget(
  barcode: QR()..setErrorCorrectionLevel(QRErrorLevel.h),
  data: 'https://www.pao.ac/',
  width: 200,
  height: 200,
)

ヒント: QRコードは正方形で描画するのが基本。BarcodeWidget の width と height を同じ値にしてください。誤り訂正レベル H にすると、QRコードの中央にロゴを重ねても（30%まで隠れても）読み取り可能です。

DataMatrix — 極小部品のマーキングに

final dm = DataMatrix();
final matrix = dm.getPattern('Hello DataMatrix');
print('DataMatrix: ${matrix.length}x${matrix[0].length}');

// サイズ指定
final dmFixed = DataMatrix();
dmFixed.setCodeSize(DxCodeSize.dxSz20x20);

DxCodeSize 列挙型（主要なもの）:

BarcodeWidget(
  barcode: DataMatrix(),
  data: 'PAO-BARCODE-2024',
  width: 150,
  height: 150,
)

ヒント: DataMatrix は小さなスペースに多くのデータを詰め込めるため、電子部品やICチップのマーキングで世界的に使われています。GS1 モードを使う場合はデータの先頭に {FNC1} を付けます。

PDF417 — 運転免許証や航空券に

final pdf417 = PDF417();
pdf417.setErrorLevel(PDF417ErrorLevel.level5);
pdf417.setSizeMode(PDF417SizeMode.columns);
pdf417.setColumns(4);

final matrix = pdf417.getPattern('Hello PDF417');
print('PDF417: ${matrix.length}行 x ${matrix[0].length}列');

PDF417ErrorLevel 列挙型:

PDF417SizeMode 列挙型:

BarcodeWidget(
  barcode: PDF417()..setErrorLevel(PDF417ErrorLevel.level3),
  data: 'Flight: NH123 Seat: 15A Gate: 42',
  width: 300,
  height: 100,
)

ヒント: PDF417 はバーコードの名前に "PDF" がつきますが、ファイル形式のPDFとは無関係。"Portable Data File" の略です。横に長いバーコードなので、width:height の比率は 3:1 程度がきれいに見えます。

6.3 GS1系バーコード — 流通のグローバルスタンダード

GS1-128 — 医薬品トレーサビリティからコンビニ払込票まで

import 'package:pao_barcode/pao_barcode.dart';

// 基本: AI (アプリケーション識別子) 形式
final gs1 = GS1_128();
final pattern = gs1.encode('{FNC1}0104912345678904');
// {FNC1} は GS1-128 の必須プレフィックス
// 01 = AI (GTIN)、04912345678904 = GTIN-14

BarcodeWidget(
  barcode: GS1_128(),
  data: '{FNC1}0104912345678904',
  width: 350, height: 80,
)

コンビニ払込票（Convenience store payment）:

// encodeConvenience: 44桁数字 → CODE-C固定でエンコード
final gs1 = GS1_128();
final convData = '{FNC1}91234567890123456789012345678901234567890123';

// encodeConvenience は (List<int>, String) を返す
final result = gs1.encodeConvenience(convData);
final pattern = result.$1;  // バーパターン
final data44 = result.$2;   // 44桁数字

// 2行テキスト行を取得
final lines = gs1.buildConvenienceTextLines(data44);
print('1行目: ${lines.$1}');
print('2行目: ${lines.$2}');

ヒント: GS1-128 の {FNC1} はデータ先頭に必須です。encode() は通常の GS1-128、encodeConvenience() はコンビニ払込票専用。用途に応じて使い分けてください。

GS1 DataBar 標準型 (GS1 DataBar 14) — 青果の量り売りに

import 'package:pao_barcode/pao_barcode.dart';

// OMNIDIRECTIONAL（標準1行）
final db14 = GS1DataBar14(symbolType: SymbolType.omnidirectional);
final pattern = db14.encode('01234567890128');

// STACKED（2行積み、高さ 13X）
final dbStacked = GS1DataBar14(symbolType: SymbolType.stacked);
dbStacked.encode('01234567890128');

// STACKED_OMNIDIRECTIONAL（2行積み、高さ 33X）
final dbStackedOmni = GS1DataBar14(
    symbolType: SymbolType.stackedOmnidirectional);
dbStackedOmni.encode('01234567890128');

SymbolType 列挙型:

BarcodeWidget(
  barcode: GS1DataBar14(symbolType: SymbolType.omnidirectional),
  data: '01234567890128',
  width: 200, height: 60,
)

GS1 DataBar 限定型 (GS1 DataBar Limited) — 小型パッケージに

// 先頭が 0 または 1 の GTIN のみ対応
BarcodeWidget(
  barcode: GS1DataBarLimited(),
  data: '01234567890128',
  width: 200, height: 50,
)

ヒント: GS1 DataBar Limited は先頭桁が 0 か 1 のデータのみ対応します。先頭が 2 以上の場合はエンコードエラーになるので、GS1 DataBar 14 を使ってください。

GS1 DataBar 拡張型 (GS1 DataBar Expanded) — AI付きデータを柔軟に

// UNSTACKED（1行）
final dbExp = GS1DataBarExpanded(
  symbolType: ExpandedSymbolType.unstacked,
);
dbExp.encode('{FNC1}0104912345678904');

// STACKED（複数行）
final dbExpStacked = GS1DataBarExpanded(
  symbolType: ExpandedSymbolType.stacked,
  numColumns: 4,  // 列数
);
dbExpStacked.encode('{FNC1}0104912345678904');

ExpandedSymbolType 列挙型:

BarcodeWidget(
  barcode: GS1DataBarExpanded(
    symbolType: ExpandedSymbolType.stacked,
    numColumns: 4,
  ),
  data: '{FNC1}0104912345678904',
  width: 250, height: 80,
)

ヒント: GS1 DataBar Expanded は有効期限やロット番号などの追加情報を GTIN と一緒にエンコードできる唯一の DataBar です。クーポンや精肉の消費期限ラベルに最適。

6.4 郵便カスタマバーコード — DMハガキの自動仕分け

import 'package:pao_barcode/pao_barcode.dart';

// 郵便番号（ハイフンなし7桁）
final yb = YubinCustomer();
final bars = yb.encode('1050011');  // 港区芝公園
print('バー本数: ${bars.length}');  // → 67

// 郵便番号 + 住所表示番号
final bars2 = yb.encode('10500114-2-8');
// 出力は List<int>: 1=Long, 2=Semi-upper, 3=Semi-lower, 4=Timing

4-state バータイプ:

BarcodeWidget(
  barcode: YubinCustomer(),
  data: '10500114-2-8',
  width: 250,
  height: 30,
  showText: false,  // 郵便バーコードはテキスト非表示が一般的
)

ヒント: 郵便カスタマバーコードは常に67本固定です。DMハガキにこのバーコードを印刷すると、郵便局の自動仕分け機が住所を高速に読み取り、配達が早くなります（大量発送時の割引対象にもなります）。

6.5 Flutter Web連携 — ブラウザでバーコードを表示・ダウンロード

DynamicBarcodeDemo — リアルタイムプレビュー

テキスト入力に連動してバーコードが即時更新される、Flutter Web 向けのデモです。

import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:pao_barcode/pao_barcode.dart';

class DynamicBarcodeDemo extends StatefulWidget {
  const DynamicBarcodeDemo({super.key});

  @override
  State<DynamicBarcodeDemo> createState() => _DynamicBarcodeDemoState();
}

class _DynamicBarcodeDemoState extends State<DynamicBarcodeDemo> {
  final _controller = TextEditingController(text: 'Hello-2024');
  String _barcodeType = 'Code128';
  String? _errorMessage;

  dynamic _createBarcode() {
    switch (_barcodeType) {
      case 'Code128':
        return Code128();
      case 'QR':
        return QR();
      case 'JAN13':
        return JAN13();
      case 'Code39':
        return Code39();
      case 'DataMatrix':
        return DataMatrix();
      default:
        return Code128();
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Barcode Demo')),
      body: Padding(
        padding: const EdgeInsets.all(24),
        child: Column(
          children: [
            // バーコードタイプ選択
            DropdownButton<String>(
              value: _barcodeType,
              items: ['Code128', 'QR', 'JAN13', 'Code39', 'DataMatrix']
                  .map((t) => DropdownMenuItem(value: t, child: Text(t)))
                  .toList(),
              onChanged: (v) => setState(() => _barcodeType = v!),
            ),
            const SizedBox(height: 16),

            // データ入力
            TextField(
              controller: _controller,
              decoration: const InputDecoration(
                labelText: 'バーコードデータ',
                border: OutlineInputBorder(),
              ),
              onChanged: (_) => setState(() {}),
            ),
            const SizedBox(height: 24),

            // バーコード表示
            Container(
              decoration: BoxDecoration(
                border: Border.all(color: Colors.grey.shade300),
                borderRadius: BorderRadius.circular(8),
              ),
              padding: const EdgeInsets.all(16),
              child: _buildBarcode(),
            ),
            const SizedBox(height: 16),

            // PNG ダウンロードボタン
            ElevatedButton.icon(
              icon: const Icon(Icons.download),
              label: const Text('PNG ダウンロード'),
              onPressed: _downloadPng,
            ),
          ],
        ),
      ),
    );
  }

  Widget _buildBarcode() {
    try {
      _errorMessage = null;
      final bc = _createBarcode();
      final isQrOrDm = _barcodeType == 'QR' || _barcodeType == 'DataMatrix';
      return BarcodeWidget(
        barcode: bc,
        data: _controller.text,
        width: isQrOrDm ? 200 : 350,
        height: isQrOrDm ? 200 : 100,
      );
    } catch (e) {
      _errorMessage = e.toString();
      return Text('エラー: $_errorMessage',
          style: const TextStyle(color: Colors.red));
    }
  }

  Future<void> _downloadPng() async {
    try {
      final renderer = CanvasRenderer();
      final bc = _createBarcode();
      final isQrOrDm = _barcodeType == 'QR' || _barcodeType == 'DataMatrix';
      final w = isQrOrDm ? 400 : 600;
      final h = isQrOrDm ? 400 : 150;
      final pngBytes = await renderer.renderToPng(
        bc, _controller.text, w, h,
      );

      // Base64 データ URI
      final dataUri = 'data:image/png;base64,${base64Encode(pngBytes)}';
      // Flutter Web: AnchorElement を使ってダウンロード
      // (dart:html は Web 専用)
      print('Data URI 長: ${dataUri.length} 文字');
    } catch (e) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('エラー: $e')),
      );
    }
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }
}

Base64 データ URI — Web表示やメール埋め込みに

import 'dart:convert';
import 'package:pao_barcode/pao_barcode.dart';

Future<String> barcodeToDataUri(dynamic barcode, String data,
    {int width = 400, int height = 100}) async {
  final renderer = CanvasRenderer();
  final pngBytes = await renderer.renderToPng(barcode, data, width, height);
  return 'data:image/png;base64,${base64Encode(pngBytes)}';
}

// 使用例:
// final uri = await barcodeToDataUri(Code128(), 'Hello-2024');
// → "data:image/png;base64,iVBORw0KGgo..."
//
// HTML の <img> タグで直接表示可能:
// <img src="data:image/png;base64,iVBORw0KGgo..." />

ヒント: Base64 データ URI は画像ファイルをサーバーに保存せずにブラウザ上で直接表示できます。メール本文への埋め込みや、JavaScript との連携にも便利。ただし Base64 はデータ量が約1.33倍になるので、大量のバーコードを同時に表示する場合はファイル保存方式を検討してください。

7. APIリファレンス

7.1 共通メソッド（全バーコード） — BarcodeBase クラス

全てのバーコードクラス（BarcodeBase を継承）で使用できるメソッドです。

setOutputFormat(format)

出力形式を設定します。SVGモードに切り替える際に使用します。

bc.setOutputFormat('svg');

デフォルト: 'png'

setForegroundColor(r, g, b, [a])

前景色（バーの色）を設定します。

bc.setForegroundColor(0, 0, 128, 255);  // 紺色

デフォルト: (0, 0, 0, 255) （黒）

setBackgroundColor(r, g, b, [a])

背景色を設定します。

bc.setBackgroundColor(255, 255, 240, 255);  // アイボリー

デフォルト: (255, 255, 255, 255) （白）

setFitWidth(fit)

バーコードを指定幅いっぱいに描画するかどうかを設定します。

bc.setFitWidth(true);

デフォルト: false （GS1-128 は true）

draw(code, x, y, width, height)

バーコードを描画します（SVGモード時はSVG文字列を内部生成）。

bc.setOutputFormat('svg');
bc.draw('Hello-2024', 0, 0, 400, 100);

戻り値: bool — 成功時 true

getSvg()

SVGモードで draw() 実行後、SVG文字列を取得します。

bc.setOutputFormat('svg');
bc.draw('Hello-2024', 0, 0, 400, 100);
final svgString = bc.getSvg();
// → "<?xml version="1.0" ...><svg ...>...</svg>"

戻り値: String — SVG文字列

ヒント: getSvg() は setOutputFormat('svg') を呼んでから draw() を実行した後にのみ使用可能です。PNG モードで呼ぶと StateError がスローされます。

7.2 1次元バーコード共通メソッド — BarcodeBase1D クラス

1次元バーコード（Code39, Code93, Code128, NW7, ITF, Matrix2of5, NEC2of5, JAN8, JAN13, UPCA, UPCE, GS1-128, GS1 DataBar 系）が共通で持つメソッドです。

encode(code)

バーコードデータをエンコードし、バー/スペース幅パターンを返します。

final pattern = bc.encode('Hello-2024');
// pattern = [2, 1, 1, 2, 3, 2, ...]
// バー幅, スペース幅, バー幅, ... が交互に並ぶ

戻り値: List<int> — バーとスペースの幅が交互に並んだリスト（バーから開始）

textEvenSpacing プロパティ

バーコード下テキストの配置モードを制御します。

final bc = Code128();
bc.textEvenSpacing = true;   // 均等分散（デフォルト）
bc.textEvenSpacing = false;  // 中央集約

// メソッド形式でも設定可能
bc.setTextEvenSpacing(false);

setShowText(show)

バーコード下のテキスト表示/非表示を切り替えます。

bc.setShowText(false);  // テキスト非表示

デフォルト: true

JAN/UPC 表示パターンマトリクス — extendedGuard x textEvenSpacing

JAN/UPC バーコード（JAN8, JAN13, UPCA, UPCE）は extendedGuard と textEvenSpacing の組み合わせで4パターンの描画モードを持ちます。

デフォルト: extendedGuard = true, textEvenSpacing = true

final jan = JAN13();
jan.extendedGuard = true;     // ガードバー延長あり（デフォルト）
jan.textEvenSpacing = true;   // 均等配置（デフォルト）

ヒント: スーパーやコンビニの商品に印刷されている JAN バーコードは extendedGuard=true, textEvenSpacing=true の標準パターンです。特別な理由がなければデフォルトのまま使ってください。

7.3 Code39

クラス: Code39

final bc = Code39();
bc.showStartStop = false;  // テキストから * を除く
final pattern = bc.encode('HELLO-123');

入力可能文字: 数字（0-9）、英大文字（A-Z）、記号（- . $ / + % スペース）

7.4 Code93

クラス: Code93

final bc = Code93();
final pattern = bc.encode('Hello123');

入力可能文字: ASCII 全文字（内部でシフト文字による拡張エンコーディング）

7.5 Code128

クラス: Code128

CodeSet128 列挙型:

final bc = Code128();
bc.codeMode = CodeSet128.codeC;
final pattern = bc.encode('12345678');

7.6 GS1-128

クラス: GS1_128

encode(code)

GS1-128 形式でエンコードします。データ先頭に {FNC1} が必要です。

final gs1 = GS1_128();
final pattern = gs1.encode('{FNC1}0104912345678904');

encodeConvenience(code)

コンビニ収納代行バーコード（払込票）用のエンコードです。CODE-C 固定。

final gs1 = GS1_128();
final result = gs1.encodeConvenience('{FNC1}91234567890123456789012345678901234567890123');
final pattern = result.$1;   // List<int> バーパターン
final data44 = result.$2;    // String 44桁数字

戻り値: (List<int>, String) — レコード型（バーパターン, 44桁数字）

buildConvenienceTextLines(code)

コンビニバーコードの2行テキストを生成します。

final lines = gs1.buildConvenienceTextLines(data44);
final line1 = lines.$1;  // "(91)234567 89012345678901"
final line2 = lines.$2;  // "23456789 01234 5"

戻り値: (String, String) — レコード型（1行目, 2行目）

ヒント: GS1_128 はコンストラクタで setFitWidth(true) を自動設定しています。バーコードは指定幅いっぱいに描画されます。

7.7 NW-7 (Codabar)

クラス: NW7

final bc = NW7();
bc.showStartStop = false;
final pattern = bc.encode('A1234567890B');

入力可能文字: 数字（0-9）、記号（- . $ / + :）、スタート/ストップ（A, B, C, D）

7.8 ITF

クラス: ITF

final bc = ITF();
final pattern = bc.encode('1234567890');

入力可能文字: 数字のみ（偶数桁、奇数桁の場合は先頭に0を自動付加）

7.9 Matrix 2of5

クラス: Matrix2of5

final bc = Matrix2of5();
final pattern = bc.encode('1234567890');

入力可能文字: 数字のみ

7.10 NEC 2of5

クラス: NEC2of5

final bc = NEC2of5();
final pattern = bc.encode('1234567890');

入力可能文字: 数字のみ

7.11 JAN-8 (EAN-8)

クラス: JAN8

final bc = JAN8();
bc.extendedGuard = true;
bc.textEvenSpacing = true;
final pattern = bc.encode('4912345');  // 7桁 → CD自動計算

入力: 7桁（CD自動計算）または 8桁（CD込み）

7.12 JAN-13 (EAN-13)

クラス: JAN13

final bc = JAN13();
final pattern = bc.encode('490123456789');  // 12桁 → CD自動計算

入力: 12桁（CD自動計算）または 13桁（CD込み）

7.13 UPC-A

クラス: UPCA

final bc = UPCA();
final pattern = bc.encode('01234567890');  // 11桁 → CD自動計算

入力: 11桁（CD自動計算）または 12桁（CD込み）

7.14 UPC-E

クラス: UPCE

final bc = UPCE();
final pattern = bc.encode('0123456');  // 7桁 → CD自動計算

入力: 7桁（CD自動計算）または 8桁（CD込み）

ヒント: UPC-E は UPC-A のゼロ圧縮バージョンです。内部で UPC-A に展開してからチェックディジットを計算するため、元の UPC-A データとチェックディジットが一致します。

7.15 GS1 DataBar 標準型 (GS1 DataBar 14)

クラス: GS1DataBar14

SymbolType 列挙型:

final db = GS1DataBar14(symbolType: SymbolType.stacked);
final pattern = db.encode('01234567890128');

// STACKED時のプロパティ
print('行数: ${db.rowCount}');
print('パターン: ${db.patterns}');
print('行高さ: ${db.rowHeights}');
print('表示文字: ${db.getHumanReadable()}');

入力: 13桁または14桁の数字（GTIN）

7.16 GS1 DataBar 限定型 (GS1 DataBar Limited)

クラス: GS1DataBarLimited

final db = GS1DataBarLimited();
final pattern = db.encode('01234567890128');
print('GTIN-14: ${db.gtin14}');

入力: 13桁または14桁の数字（先頭桁が 0 または 1）

7.17 GS1 DataBar 拡張型 (GS1 DataBar Expanded)

クラス: GS1DataBarExpanded

ExpandedSymbolType 列挙型:

final db = GS1DataBarExpanded(
  symbolType: ExpandedSymbolType.stacked,
  numColumns: 4,
);
final pattern = db.encode('{FNC1}0104912345678904');
print('行数: ${db.rowCount}');

入力: {FNC1} + AI形式データ

7.18 郵便カスタマバーコード

クラス: YubinCustomer

final yb = YubinCustomer();
final bars = yb.encode('10500114-2-8');
// bars = [1, 3, 2, 4, ...] (67本固定)

出力: List<int> — バータイプ（1=Long, 2=Semi-upper, 3=Semi-lower, 4=Timing）、67本固定

入力: 郵便番号（7桁）、またはハイフン区切り住所表示番号

7.19 QRコード

クラス: QR

setErrorCorrectionLevel(level)

誤り訂正レベルを設定します。

QRErrorLevel 列挙型:

final qr = QR();
qr.setErrorCorrectionLevel(QRErrorLevel.h);

setVersion(version)

QRコードのバージョンを指定します。

qr.setVersion(10);  // Version 10 を強制

getPattern(code)

QRコードの2Dパターンを生成します。

final matrix = qr.getPattern('Hello World');
// matrix[row][col] = true(黒) / false(白)
print('${matrix.length} x ${matrix[0].length}');

戻り値: List<List<bool>> — 2Dブーリアン行列

QRコード バージョン/サイズ/容量テーブル:

ヒント: バージョンを 0（自動）にしておくと、データ量と誤り訂正レベルに応じて最適なバージョンが自動選択されます。バージョンを固定する必要があるのは、ラベル印刷でQRコードのサイズを一定にしたい場合などです。

7.20 DataMatrix

クラス: DataMatrix

setCodeSize(size)

シンボルサイズを指定します。

DxCodeSize 列挙型（主要）:

final dm = DataMatrix();
dm.setCodeSize(DxCodeSize.dxSz20x20);

getPattern(code)

DataMatrix の2Dパターンを生成します。

final matrix = dm.getPattern('Hello DataMatrix');
// matrix[row][col] = true(黒) / false(白)

戻り値: List<List<bool>> — 2Dブーリアン行列

入力: String、Uint8List、または List<int>（バイナリデータも対応）

ヒント: DataMatrix の encode() と getPattern() は同じ結果を返します。GS1 DataMatrix を使う場合はデータ先頭に {FNC1} を付けてください。

7.21 PDF417

クラス: PDF417

setErrorLevel(level)

誤り訂正レベルを設定します。

PDF417ErrorLevel 列挙型:

final pdf417 = PDF417();
pdf417.setErrorLevel(PDF417ErrorLevel.level5);

setAspectRatio(ratio)

アスペクト比を設定します。

pdf417.setAspectRatio(0.5);  // デフォルト

setSizeMode(mode)

サイズ指定モードを設定します。

PDF417SizeMode 列挙型:

setColumns(columns)

列数を指定します（setSizeMode(PDF417SizeMode.columns) と併用）。

setRows(rows)

行数を指定します（setSizeMode(PDF417SizeMode.rows) と併用）。

final pdf417 = PDF417();
pdf417.setErrorLevel(PDF417ErrorLevel.level3);
pdf417.setSizeMode(PDF417SizeMode.columnsAndRows);
pdf417.setColumns(6);
pdf417.setRows(10);

final matrix = pdf417.getPattern('Hello PDF417');

getPattern(code) 戻り値: List<List<bool>> — 2Dブーリアン行列

ヒント: PDF417 の列数は少ないほど横幅がコンパクトになりますが、行数が増えます。ラベル印刷では columns=4 程度が使いやすいバランスです。

7.22 CanvasRenderer

クラス: CanvasRenderer

Flutter の Canvas にバーコードを描画するレンダラーです。

インポート:

import 'package:pao_barcode/pao_barcode.dart';

コンストラクタ

CanvasRenderer({
  Color foreColor = Colors.black,
  Color backColor = Colors.white,
  bool showText = true,
  double fontSize = 14,
  double quietZone = 0,
})

draw(canvas, barcode, data, x, y, width, height, {...})

バーコードを Canvas に描画します。全19タイプに対応。

名前付きオプション:

final renderer = CanvasRenderer();
renderer.draw(canvas, Code128(), 'Hello', 10, 10, 300, 80);

drawGs1128Convenience(canvas, barcode, data, x, y, width, height, {...})

GS1-128 コンビニ払込票バーコードを2行テキスト付きで描画します。

final renderer = CanvasRenderer();
final gs1 = GS1_128();
renderer.drawGs1128Convenience(
    canvas, gs1, '{FNC1}91234567890123456789012345678901234567890123',
    10, 10, 350, 80);

renderToPng(barcode, data, width, height, {...})

バーコードを PNG バイト列としてレンダリングします。

戻り値: Future<Uint8List> — PNG バイト列

final renderer = CanvasRenderer();
final pngBytes = await renderer.renderToPng(Code128(), 'Hello', 400, 100);

ヒント: renderToPng() は非同期メソッドです。await を使うか、.then() チェーンで処理してください。内部で PictureRecorder を使うため、Flutter のレンダリングエンジンが必要です（コンソールアプリでは使用不可）。

7.23 PdfRenderer

クラス: PdfRenderer

pdf パッケージの PdfGraphics にバーコードを描画するレンダラーです。

インポート:

import 'package:pao_barcode/pao_barcode.dart';
// + pdf パッケージ
import 'package:pdf/pdf.dart';

コンストラクタ

PdfRenderer(
  PdfGraphics canvas, {
  PdfColor foreColor = PdfColors.black,
  PdfColor backColor = PdfColors.white,
  bool showText = true,
  String fontName = 'Helvetica',
  double fontSize = 8,
  double quietZone = 0,
})

draw(barcode, data, x, y, width, height, {...})

バーコードを PDF キャンバスに描画します。全19タイプに対応。

名前付きオプション:

final renderer = PdfRenderer(canvas);
renderer.draw(Code128(), 'Hello', 50, 700, 200, 50);

drawGs1128Convenience(barcode, data, x, y, width, height, {...})

GS1-128 コンビニ払込票バーコードを2行テキスト付きで描画します。

final renderer = PdfRenderer(canvas, fontSize: 7);
final gs1 = GS1_128();
renderer.drawGs1128Convenience(
    gs1, '{FNC1}91234567890123456789012345678901234567890123',
    50, 600, 350, 80);

ヒント: PdfRenderer の座標系は PDF 標準（原点が左下、Y上向き）です。y=700 は用紙の上の方、y=50 は用紙の下の方を意味します。A4 用紙は高さ 842pt なので、上端付近に描画したい場合は y=750 あたりを指定します。

7.24 BarcodeWidget

クラス: BarcodeWidget

Flutter の Widget ツリーに直接組み込めるバーコード表示 Widget です。

インポート:

import 'package:pao_barcode/pao_barcode.dart';

プロパティ一覧

BarcodeWidget(
  barcode: Code128(),
  data: 'Hello-2024',
  width: 300,
  height: 100,
  foreColor: Colors.black,
  backColor: Colors.white,
  showText: true,
  fontSize: 14,
  quietZone: 0.02,
)

ヒント: BarcodeWidget は内部で CustomPaint + _BarcodePainter を使っています。shouldRepaint() が data、foreColor、backColor、showText、fontSize、quietZone の変更を検出して、必要なときだけ再描画します。

8. 動作環境

Flutter / Dart バージョン

対応プラットフォーム

Pure Dart で書かれているため、ネイティブプラグインやFFIは一切不要です。Flutter が動くすべてのプラットフォームでそのまま動作します。

依存パッケージ

ヒント: BarcodeWidget、CanvasRenderer、SVG出力は pao_barcode 単体で動きます。pdf / printing パッケージは PDF帳票を作るときだけ追加してください。

9. ライセンス・お問い合わせ

使用許諾

pao_barcode の使用について、利用者様と有限会社パオ・アット・オフィス（以下「弊社」）は、以下の各項目に同意するものとします。

1. 使用許諾書

この使用許諾書は、利用者様がお使いのパソコンにおいて pao_barcode を使用する場合に同意しなければならない契約書です。

2. 同意

利用者様が pao_barcode を使用する時点で、本使用許諾書に同意されたものとします。

3. ライセンスの購入

製品版を使用して開発を行う場合、1 台の開発用コンピュータにつき 1 ライセンスの購入が必要です。お客様環境等、開発コンピュータでないマシンでの使用にはライセンスは不要です（ランタイムライセンスフリー）。

4. 著作権

pao_barcode の著作権は、いかなる場合においても弊社に帰属いたします。

5. 免責

pao_barcode の使用によって、直接的または間接的に生じたいかなる損害に対しても、弊社は補償賠償の責任を負わないものとします。

6. 禁止事項

pao_barcode およびその複製物を第三者に譲渡・貸与することはできません。開発ツールとしての再販・再配布を禁止します。ただし、モジュールとして組み込みを行い再販・再配布する場合は問題ございません。

7. 保証の範囲

弊社は pao_barcode の仕様を予告なしに変更することがあります。利用者様への情報提供は弊社 Web サイトにて行います。

8. 適用期間

本使用許諾条件は利用者様が pao_barcode を使用した日より有効です。

ライセンス

ライセンスの考え方:

• 開発者1人（PC 1台）につき1ライセンスが必要です
• 開発したアプリの配布先（エンドユーザー）にはライセンス不要です
• iOS / Android / Web / Desktop — 1ライセンスで全プラットフォーム対応
• 社内利用・商用利用いずれも同一価格です

試用版について

ライセンス購入前に全機能をお試しいただけます。

試用版では生成されるバーコード画像の左上に赤字の "SAMPLE" 透かしが表示されます。ライセンス購入後、ライセンスキーを設定すると透かしが消えます。

お問い合わせ

関連製品

バージョン 1.1

(C) 2026 有限会社 パオ・アット・オフィス