模式参考
手动选择 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 | 两个嵌套的矩形。视觉点缀。 |
定位点内部形状:“瞳孔”
| 值 | 说明 |
|---|---|
square | 默认值。 |
roundedsquare | 含蓄。 |
circle | 最具“品牌感”的外观。 |
dot | 类似 circle,但更小,与 dot 模块相配。 |
diamond | 几何感。 |
star | 仅作装饰,请使用 eccLevel: "H"。 |
AI 如何选择
除非你在提示词中明确提到,否则 AI 不会为正式使用的二维码选择 heart、arrow 或 drop。它默认选择安全组合:roundedsquare 模块、roundedsquare 或 circle 定位点、ECC H。超出这个范围的选择都来自提示词或 style: "artistic"。
另请参阅
- QrConfig 参考:完整参数表
- /examples:所有形状渲染效果的可视化图库
- 扫描保证:引擎在放行导出前检查的内容