Referência de padrões

Use esta página quando estiver escolhendo moduleShape, finderOuterShape ou finderInnerShape à mão. As prévias visuais estão em /examples.

Forma dos módulos — a aparência das células de dados

Valor	Cobertura	Seguro para impressão?	Observações
`square`	100%	sim	O padrão. Seguro em qualquer lugar.
`roundedsquare`	~95%	sim	Melhoria estética sem nenhuma perda de leitura.
`circle`	~78%	sim	Defina `moduleScale ≥ 0.85`.
`dot`	~50%	sim — com ECC H	Cobertura menor; o motor sobe o ECC automaticamente.
`diamond`	~85%	sim	Fica ótimo com marcadores `roundedsquare`.
`hexagon`	~90%	sim	Geométrico, combina bem com `gradientDirection: diagonal`.
`octagon`	~88%	sim	Parecido com o hexágono, porém mais achatado.
`cross`	~60%	sim — com ECC H	Visual de "bordado".
`star`	~55%	sim — com ECC H	Use `moduleScale 0.9`.
`heart`	~50%	sim — com ECC H	Decorativo. Valide antes de imprimir.
`leaf`	~65%	sim — com ECC H	Orgânico.
`pointed`, `pointedinward`, `pointedsmooth`	~70%	sim	Pontas afiadas, visual moderno.
`pill`, `roundedinward`, `roundedpointed`	~80%	sim	Variações suaves.
`mosaic`	~85%	sim	Lembra terracota.
`japanese`	~75%	sim	Textura sutil.
`arrow`, `drop`, `shield`, `clipped`, `clippedsmooth`, `circlestripe`	varia	depende da escala	Experimental — teste sempre a leitura depois de exportar.

Forma externa do marcador — as 3 molduras dos cantos

A ISO 18004 só valida marcadores retangulares, mas a maioria dos leitores é tolerante. O motor limita você a formas que decodificam de forma confiável.

Valor	Observações
`square`	ISO estrita. Use esta se a leitura for em condições difíceis.
`roundedsquare`	Igual a `square` para os leitores; mais suave para o olho humano.
`circle`	Confiável. Combina bem com módulos `circle`.
`diamond`	Taxa de decodificação ~99,5%. Evite com leitores industriais.
`octagon`	A melhor opção não quadrada.
`target`	Anéis concêntricos. Parece intencional.
`double`	Dois retângulos aninhados. Toque visual.

Forma interna do marcador — a "pupila"

Valor	Observações
`square`	Padrão.
`roundedsquare`	Sutil.
`circle`	O visual mais "de marca".
`dot`	Como `circle`, mas menor — combina com módulos `dot`.
`diamond`	Geométrico.
`star`	Só decorativo — use `eccLevel: "H"`.

Como a IA escolhe

A IA nunca escolhe heart, arrow ou drop para QRs de produção, a menos que você os mencione explicitamente no prompt. Por padrão, ela fica no quadrante seguro: módulos roundedsquare, marcadores roundedsquare ou circle, ECC H. Tudo o que sai disso vem do prompt ou de style: "artistic".

Veja também

Referência de QrConfig — tabela completa de parâmetros
/examples — galeria visual com todas as formas renderizadas
Garantia de leitura — o que o motor verifica antes de liberar uma exportação