Referencia de patrones

Consulta esta página cuando elijas a mano moduleShape, finderOuterShape o finderInnerShape. Las vistas previas están en /examples.

Forma del módulo: el aspecto de las celdas de datos

Valor	Cobertura	¿Apto para imprimir?	Notas
`square`	100%	sí	El valor por defecto. Seguro en cualquier caso.
`roundedsquare`	~95%	sí	Mejora estética sin ninguna penalización de escaneo.
`circle`	~78%	sí	Usa `moduleScale ≥ 0.85`.
`dot`	~50%	sí, con ECC H	Menos cobertura; el motor sube la ECC automáticamente.
`diamond`	~85%	sí	Queda muy bien con marcadores `roundedsquare`.
`hexagon`	~90%	sí	Geométrico; combina bien con `gradientDirection: diagonal`.
`octagon`	~88%	sí	Parecido al hexágono, pero más plano.
`cross`	~60%	sí, con ECC H	Aspecto de «bordado».
`star`	~55%	sí, con ECC H	Usa `moduleScale 0.9`.
`heart`	~50%	sí, con ECC H	Decorativo. Valídalo antes de imprimir.
`leaf`	~65%	sí, con ECC H	Orgánico.
`pointed`, `pointedinward`, `pointedsmooth`	~70%	sí	Puntas afiladas, aire moderno.
`pill`, `roundedinward`, `roundedpointed`	~80%	sí	Variantes suaves.
`mosaic`	~85%	sí	Recuerda a la terracota.
`japanese`	~75%	sí	Textura sutil.
`arrow`, `drop`, `shield`, `clipped`, `clippedsmooth`, `circlestripe`	variable	depende de la escala	Experimentales: comprueba siempre el escaneo tras exportar.

Forma exterior del marcador: los 3 marcos de las esquinas

ISO 18004 solo contempla patrones de localización rectangulares, pero la mayoría de los lectores son tolerantes. El motor te limita a formas que se decodifican de forma fiable.

Valor	Notas
`square`	ISO estricto. Úsalo si se va a escanear en condiciones difíciles.
`roundedsquare`	Para los lectores, igual que `square`; más suave a la vista.
`circle`	Fiable. Combina bien con módulos `circle`.
`diamond`	Tasa de decodificación ~99.5%. Evítalo con lectores industriales.
`octagon`	La mejor opción no cuadrada.
`target`	Anillos concéntricos. Parece intencionado.
`double`	Dos rectángulos anidados. Un toque decorativo.

Forma interior del marcador: la «pupila»

Valor	Notas
`square`	Por defecto.
`roundedsquare`	Sutil.
`circle`	El aspecto más «de marca».
`dot`	Como `circle`, pero más pequeño; encaja con módulos `dot`.
`diamond`	Geométrico.
`star`	Solo decorativo; usa `eccLevel: "H"`.

Cómo elige la IA

La IA nunca elige heart, arrow ni drop para QR de producción salvo que los menciones expresamente en el prompt. Por defecto se queda en la zona segura: módulos roundedsquare, marcadores roundedsquare o circle, ECC H. Cualquier cosa fuera de eso sale del prompt o de style: "artistic".

Véase también

Referencia de QrConfig: la tabla completa de parámetros
/examples: galería visual con todas las formas renderizadas
Garantía de escaneo: lo que comprueba el motor antes de dejar pasar una exportación