パターンリファレンス
moduleShape、finderOuterShape、finderInnerShape を手動で選ぶときに参照してください。見た目のプレビューは /examples にあります。
モジュールの形状 — データセルの見た目
| 値 | カバー率 | 印刷に安全? | 備考 |
|---|---|---|---|
square | 100% | はい | デフォルト。どこでも安全です。 |
roundedsquare | ~95% | はい | 読み取りへの影響なしで見た目を向上。 |
circle | ~78% | はい | moduleScale ≥ 0.85 に設定してください。 |
dot | ~50% | はい — ECC Hで | カバー率が低いため、エンジンがECCを自動で引き上げます。 |
diamond | ~85% | はい | roundedsquare のファインダーとよく合います。 |
hexagon | ~90% | はい | 幾何学的で、gradientDirection: diagonal と好相性。 |
octagon | ~88% | はい | hexagonに似ていますが、より平たい形です。 |
cross | ~60% | はい — ECC Hで | 「刺繍」風の見た目。 |
star | ~55% | はい — ECC Hで | moduleScale 0.9 を使ってください。 |
heart | ~50% | はい — ECC Hで | 装飾用。印刷前に検証してください。 |
leaf | ~65% | はい — ECC Hで | 有機的。 |
pointed, pointedinward, pointedsmooth | ~70% | はい | 鋭い先端で、モダンな印象。 |
pill, roundedinward, roundedpointed | ~80% | はい | なめらかなバリエーション。 |
mosaic | ~85% | はい | テラコッタのような見た目。 |
japanese | ~75% | はい | 控えめな質感。 |
arrow, drop, shield, clipped, clippedsmooth, circlestripe | さまざま | スケールによる | 実験的 — エクスポート後は必ず読み取りをテストしてください。 |
ファインダーの外側の形状 — 3つの角の枠
ISO 18004が検証の対象とするのは四角形のファインダーだけですが、ほとんどのスキャナーは寛容です。エンジンは、確実にデコードできる形状だけに制限しています。
| 値 | 備考 |
|---|---|
square | 厳密なISO準拠。厳しい条件で読み取る場合はこれを使ってください。 |
roundedsquare | スキャナーにとっては square と同じで、人の目にはやわらかい印象。 |
circle | 信頼性が高い。circle のモジュールと好相性。 |
diamond | デコード率は約99.5%。産業用スキャナーでは避けてください。 |
octagon | 四角形以外では最良の選択肢。 |
target | 同心円。意図的なデザインに見えます。 |
double | 入れ子になった2つの四角形。視覚的なアクセント。 |
ファインダーの内側の形状 — 「瞳」
| 値 | 備考 |
|---|---|
square | デフォルト。 |
roundedsquare | 控えめ。 |
circle | 最も「ブランドらしい」見た目。 |
dot | circle に似ていますが小さめ — dot のモジュールと合います。 |
diamond | 幾何学的。 |
star | 装飾専用 — eccLevel: "H" を使ってください。 |
AIの選び方
本番用のQRでは、プロンプトで明示的に指定しない限り、AIが heart、arrow、drop を選ぶことはありません。デフォルトでは安全な組み合わせ(roundedsquare のモジュール、roundedsquare または circle のファインダー、ECC H)を選びます。それ以外の選択は、プロンプトまたは style: "artistic" によるものです。
関連項目
- QrConfigリファレンス — パラメータの全一覧
- /examples — すべての形状をレンダリングしたビジュアルギャラリー
- スキャン保証 — エクスポートを通す前にエンジンがチェックする内容