Barcode.Ruby (gem版)

C++ バーコードエンジンを Ruby から手軽に利用。

ユーザーズマニュアル

バージョン 1.0 — 2026年2月

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

https://www.pao.ac/

はじめに

C++ WASM版 / FFI版とは

Barcode.Ruby gem版 は、C++ で書かれた高性能バーコードエンジンを Ruby から利用するためのラッパーgemです。

2つのバリエーションがあります：

どちらも Pure Ruby版と同じ API（setter メソッドパターン）で使用でき、全18種 のバーコードを PNG / JPEG / SVG で出力できます。

require 'barcode_pao_wasm'

qr = BarcodePaoWasm::QRCode.new(BarcodePaoWasm::FORMAT_PNG)
qr.draw("https://www.pao.ac/", 300)
base64 = qr.get_image_base64

特長

対応バーコード一覧

Pure Ruby版と同じ 全18種 に対応しています。

導入方法

動作要件

WASM版（barcode_pao_wasm）:

Native版（barcode_pao_ffi）:

ダウンロード

https://www.pao.ac/barcode.ruby/#download

ファイル構成（WASM版）

barcode_ruby_gem/
├── easy2steps/
│   ├── Gemfile
│   ├── app.rb
│   └── views/index.erb
├── allinone/
│   ├── Gemfile
│   ├── app.rb
│   ├── views/index.erb
│   └── public/
└── barcode_pao_wasm/
    ├── lib/barcode_pao_wasm.rb
    ├── lib/barcode_pao_wasm/...
    └── wasm/
        ├── barcode.wasm
        ├── barcode.mjs
        └── _barcode_runner.mjs

起動方法

cd barcode_ruby_gem/easy2steps
bundle install
ruby app.rb
# → http://localhost:5742

クイックスタート

QRコードをPNGで生成（WASM版）

require 'barcode_pao_wasm'

qr = BarcodePaoWasm::QRCode.new(BarcodePaoWasm::FORMAT_PNG)
qr.set_error_correction_level("M")
qr.draw("https://www.pao.ac/", 300)

base64 = qr.get_image_base64
image_bytes = qr.get_image_memory
File.binwrite("qr.png", image_bytes)

QRコードをPNGで生成（FFI版）

require 'barcode_pao_ffi'

qr = BarcodePaoFfi::QRCode.new(BarcodePaoFfi::FORMAT_PNG)
qr.set_error_correction_level("M")
qr.draw("https://www.pao.ac/", 300)

base64 = qr.get_image_base64

SVGベクター出力

bc = BarcodePaoWasm::Code128.new(BarcodePaoWasm::FORMAT_SVG)
bc.set_show_text(true)
bc.set_text_even_spacing(true)
bc.draw("Hello-2026", 400, 100)
svg = bc.get_svg

REST APIサーバー

require 'sinatra'
require 'json'
require 'barcode_pao_wasm'

get '/api/qr' do
  content_type :json
  code = params[:code] || "https://www.pao.ac/"

  qr = BarcodePaoWasm::QRCode.new(BarcodePaoWasm::FORMAT_PNG)
  qr.draw(code, 300)
  base64 = qr.get_image_base64

  { base64: base64 }.to_json
end

APIリファレンス

Pure Ruby版との違い

gem版（FFI/WASM）は setter メソッドパターン を使用します：

出力メソッドは共通です：get_image_base64, get_svg, get_image_memory

共通メソッド（全バーコード）

1次元バーコード共通メソッド

draw メソッド: draw(code, width, height)

各バーコード型

Code39 / NW-7: set_show_start_stop(bool)

Code128: set_code_mode(mode) — CODE128_AUTO / CODE128_CODE_A / CODE128_CODE_B / CODE128_CODE_C

JAN-8 / JAN-13 / UPC-A / UPC-E: set_extended_guard(bool)

GS1 DataBar 14: コンストラクタに symbol_type 引数（OMNIDIRECTIONAL / STACKED / STACKED_OMNIDIRECTIONAL）

GS1 DataBar 拡張型: set_no_of_columns(cols)

郵便カスタマバーコード: draw(code, height) — 幅は自動計算

QRコード

draw メソッド: draw(code, size) — 正方形

DataMatrix

draw メソッド: draw(code, size) — 正方形

PDF417

draw メソッド: draw(code, width, height)

Pure Ruby版との違い

どちらを選ぶべきか？

• Pure Ruby版: Ruby のみの環境で動かしたい、ソースコードを確認したい
• FFI版: 最高速を求める、Linux/Windows サーバーで運用
• WASM版: Node.js がある環境でポータブルに使いたい

動作環境

WASM版

Native版（FFI）

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

使用許諾

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

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

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

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

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

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

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

7. 保証の範囲 — 弊社は Barcode.Ruby の仕様を予告なしに変更することがあります。

8. 適用期間 — 本使用許諾条件は利用者様が Barcode.Ruby を使用した日より有効です。

ライセンス

試用版: 生成されるバーコードに「SAMPLE」の透かしが表示されます。機能制限はありません。

製品版: 透かしなしでバーコードを生成できます。

お問い合わせ

Barcode.Ruby (gem版) ユーザーズマニュアル バージョン 1.0 — 2026年2月

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