Guia para gerar QR Code: links estáticos, limites em bytes e exportação
Admin ·
O gerador transforma o texto ou link atual em uma imagem QR estática no navegador. A prévia muda ao editar a entrada ou a correção. Baixe PNG preto sobre branco com pixels inteiros por módulo ou SVG escalável; ambos incluem uma borda livre de quatro módulos.
A imagem contém dados fixos, enquanto o destino de um link pode mudar ou falhar externamente. Unidades de entrada e capacidade UTF-8 diferem, e os tamanhos PNG são alvos. Correção e prévia bem-sucedida não garantem distância de leitura, segurança do destino ou interpretação idêntica em todo leitor.
Crie o código com a prévia automática
O gerador começa com “Texto ou link” vazio, correção Média e alvo PNG de 1024 pixels. Digite ou cole os dados para ver a prévia automática. Alterar texto ou nível recalcula o símbolo; não há botão separado de geração.
Confira o texto antes de baixar. Para links, verifique separadamente o endereço completo, incluindo esquema, caminho e consulta. A prévia confirma que cabe neste codificador com aquele nível; não prova que o site existe, é seguro ou abre corretamente em um telefone.
- Digite o texto ou link que o código deve guardar.
- Escolha correção e alvo PNG; verifique prévia e erros.
- Baixe o formato e teste o arquivo ou impresso com o leitor previsto.
Os dados são texto, não um destino verificado
O codificador usa o valor atual sem aparar espaços, encurtar URL ou acessar o destino. Espaços, quebras de linha, maiúsculas e pontuação podem importar. Um esquema ausente ou caractere final acidental continua no texto. Nem toda sequência vira endereço web válido.
O leitor decide como apresentar ou usar o texto decodificado. O codificador genérico aceita texto comum ou dados já formatados, mas não oferece assistentes de Wi-Fi, contatos, pagamentos ou email. Uma prévia válida não verifica esses formatos externos.
Dados estáticos e conteúdo de link variável são diferentes
A imagem baixada contém dados codificados fixos. Mudá-los exige outra imagem. O ToolMellow não insere redirecionamento intermediário de leitura, temporizador de expiração ou painel de destinos editáveis. Expressões históricas de códigos permanentes descrevem o formato estático, sem prometer a vida útil de serviços externos.
Um endereço inalterado como https://example.com/menu pode servir outro conteúdo depois, ou seu proprietário pode modificar um redirecionamento. Também pode parar, exigir autenticação ou ficar inacessível ao leitor. Escolha um endereço que possa manter e reteste após mudanças; a imagem não mantém um destino online.
Caracteres visíveis, unidades de entrada e bytes diferem
O campo limita a entrada a 3000 unidades de código UTF-16. Separadamente, o codificador transforma uma string JavaScript bem formada em bytes UTF-8. O custo de um caractere visível varia: a usa um byte, é dois, 世 três e 😀 quatro em UTF-8. O emoji também usa duas unidades UTF-16.
O texto pode respeitar a entrada e exceder a capacidade QR do nível. Substitutos Unicode sem par são rejeitados em vez de substituídos silenciosamente. Reduza os dados sem confundir caracteres visíveis com bytes. Os limites valem para texto no campo, não arquivo enviado; não há entrada de arquivos.
MDN: TextEncoder e bytes UTF-8MDN: maxlength e unidades UTF-16 de entradaMDN: detectar substitutos Unicode sem par
A capacidade é limitada e depende do nível
A implementação sempre usa um único segmento UTF-8 em modo byte. Não compacta dígitos em modo numérico, não usa segmento alfanumérico ou Kanji nem emite ECI. Capacidades gerais de outros modos não descrevem esta ferramenta. A tabela mostra máximos de bytes na versão 40; versões menores comportam menos.
O padrão é M; 2953 bytes não é o limite inicial. Por exemplo, 世 repetido 984 vezes usa 2952 bytes e cabe em L, mas 985 repetições usam 2955 bytes e excedem seu teto. Outro nível pode mudar capacidade e versão; o limite de entrada separado continua válido.
| Nível | Máximo de bytes UTF-8 na versão 40 | Significado da opção |
|---|---|---|
L | 2953 | Correção baixa |
M | 2331 | Média; padrão do espaço |
Q | 1663 | Correção quartil |
H | 1273 | Correção alta |
DENSO WAVE: versões QR e capacidadeMDN: TextEncoder e bytes UTF-8
Versão e quantidade de módulos explicam a densidade
O codificador escolhe a menor versão QR comum de 1 a 40 que comporte dados e nível. O lado tem 17 + 4 * version módulos: versão 1 tem 21 por lado e versão 40, 177. Os números exibidos descrevem o símbolo antes da borda livre.
Adicionar bytes ou mudar a correção pode aumentar a versão, sem sempre cruzar um limite. Mantendo a versão, a quantidade de módulos por lado permanece mesmo que o padrão mude. Em tamanho físico fixo, mais módulos geralmente significam quadrados menores. A prévia não mede uma distância confiável de leitura.
DENSO WAVE: versões QR e capacidadeDENSO WAVE: margens livres e dimensões dos módulos
Recuperação não autoriza cobrir a área da imagem
Os controles rotulam L, M, Q e H com cerca de 7%, 15%, 25% e 30% de recuperação. A DENSO WAVE explica restauração pelo total de palavras de código, cada uma com oito bits. Não são áreas da imagem que você pode cobrir, apagar ou substituir por logotipo com segurança.
A recuperação depende da informação danificada e da capacidade do leitor de localizar e interpretar o símbolo. Um nível maior pode exigir versão maior para os mesmos dados; um menor não garante maior distância. Mantenha padrões de localização e borda intactos e teste a saída. O gerador não testa símbolos danificados nem certifica logos sobrepostos.
DENSO WAVE: correção e restauração de palavras de códigoDENSO WAVE: margens livres e dimensões dos módulos
Tamanhos PNG são alvos; o lado exportado pode ser menor
“Tamanho do PNG” oferece alvos de 256, 512, 1024 e 2048 pixels. O renderizador adiciona quatro módulos de borda de cada lado e pixels inteiros por módulo. O lado quadrado é (size + 8) * floor(target / (size + 8)) nessas opções. Quadrados pretos são pintados sobre branco opaco, sem esticar bordas fracionárias para atingir o alvo exato.
Na versão 1, a extensão completa tem 29 módulos: 21 do símbolo mais oito de ambas as margens. Os exemplos valem para dados curtos como a em M. A versão 40 tem extensão de 185 módulos; alvo 1024 produz 925 pixels. O tamanho PNG não amplia capacidade nem muda bytes codificados.
| Alvo PNG, versão 1 | Pixels inteiros por módulo | Lado quadrado exportado |
|---|---|---|
256 | 8 | 232 pixels |
512 | 17 | 493 pixels |
1024 | 35 | 1015 pixels |
2048 | 70 | 2030 pixels |
DENSO WAVE: margens livres e dimensões dos módulosMDN: Canvas.toBlob, exportação PNG e resultados nulos
SVG mantém geometria vetorial e zona de silêncio
“Baixar SVG” gera um símbolo vetorial preto sobre branco com viewBox que inclui código e borda de quatro módulos. O arquivo não tem largura ou altura fixa em pixels. Escalar no layout muda dimensões de exibição ou impressão preservando a geometria. O seletor PNG não define tamanho de exportação SVG.
Preserve a margem branca no documento. Cortá-la, sobrepor arte ou colocar marcas escuras semelhantes junto ao símbolo pode dificultar a leitura. Formato vetorial não garante decodificar impressão arbitrariamente pequena, captura desfocada ou em todo leitor. Escolha a dimensão completa colocada e teste exportação ou impressão reais.
Erros substituem a prévia; Limpar mantém as opções
Texto além da capacidade ou Unicode mal formado substitui prévia e downloads por erro. O campo mantém o texto atual; a ferramenta não o trunca para gerar outros dados válidos nem oferece a imagem antiga. Encurtar texto ou mudar correção recalcula. Só mudar o PNG não resolve um erro de capacidade em bytes.
“Limpar” aparece com prévia válida. Esvazia o texto, retira o código e mostra confirmação, mantendo correção e alvo PNG. Editar texto limpa avisos; mudar nível ou tamanho não os limpa explicitamente. Para esvaziar entrada inválida, edite ou apague diretamente. Recarregar restaura entrada vazia, M e alvo 1024.
MDN: detectar substitutos Unicode sem parMDN: maxlength e unidades UTF-16 de entrada
Geração local não criptografa os dados QR
O componente calcula símbolo e exportações no navegador sem pedido de geração contendo o texto. Não acrescenta redirecionamento de leitura ToolMellow nem painel de estatísticas. Hospedagem e análises gerais do site e requisições ao acessar o destino são separados dessa geração local.
Uma imagem QR representa dados que o leitor pode revelar. Baixar, imprimir ou compartilhar cria cópias externas; o link pode levar a um serviço com rastreamento ou regras de acesso próprias. A correção resiste a algumas corrupções, mas não criptografa, autentica ou impede a leitura dos dados.
Downloads são cópias externas, com alternativas PNG e SVG
Os nomes são toolmellow-qr-code.png e toolmellow-qr-code.svg. PNG é desenhado em canvas local; SVG é construído com a geometria atual. Sem contexto de desenho, um aviso recomenda SVG. Se a conversão PNG não retornar Blob, não há arquivo baixado nem novo aviso de falha.
Sem arquivo, tente SVG e confira os downloads do navegador. A função compartilhada revoga a URL de objeto temporária depois de 60 segundos; libera essa URL, sem apagar a imagem salva. Limpar e recarregar não removem downloads ou cópias colocadas em outros documentos.
MDN: Canvas.toBlob, exportação PNG e resultados nulosMDN: File API, objetos Blob e URLs de objetoW3C File API: revogar URL de objeto
Teste a saída real nas condições planejadas
Confira dados decodificados, não apenas a detecção de um quadrado. Em links, verifique endereço e destino no dispositivo e rede previstos. Teste também textos com vários sistemas de escrita ou emojis: o codificador escreve UTF-8 em modo byte sem ECI, então a interpretação do leitor precisa ser verificada.
Use o arquivo real em seu tamanho final. Preserve contraste e zona de silêncio, evite desfoque e reamostragem involuntária e teste uma prova impressa se distribuir papel. Densidade, módulos pequenos, luz, reflexos, danos e leitor afetam resultados. Nenhum alvo PNG, nível ou vetor define tamanho físico ou distância universais.
DENSO WAVE: margens livres e dimensões dos módulosDENSO WAVE: correção e restauração de palavras de códigoMDN: TextEncoder e bytes UTF-8
Conheça o fluxo que este espaço oferece
Este espaço codifica um único texto estático com correção e alvo PNG e baixa PNG ou SVG. Não tem lotes, scanner de imagens, cores próprias, editor de logo, encurtador URL, redirecionamento dinâmico editável, estatísticas, histórico de conta ou serviço de upload hospedado.
Parâmetros adicionais da biblioteca não são funções visíveis na página. Um texto formatado pode caber, mas não há construtor nem validador dedicado a credenciais Wi-Fi, contatos ou pagamentos. Valide o formato com um fluxo adequado e teste o resultado decodificado; uma prévia não confirma sua semântica.
Investigue a camada que falhou
Falta de prévia, PNG menor, erro de decodificação e página de destino indisponível são falhas de camadas diferentes. Comece com texto, nível e erro; depois confira arquivo e colocação, leitor e destino. Mudar um controle sem relação não corrige todas as camadas.
A tabela liga sintomas comuns a verificações possíveis. É um apoio à decisão, não garante todo dispositivo, navegador ou impresso. Guarde os dados pretendidos para compará-los com a decodificação real.
| Sintoma | Camada a conferir | Próxima ação |
|---|---|---|
| Erro de texto longo demais | Capacidade UTF-8 no nível escolhido | Reduza dados ou escolha nível adequado; alvo PNG não interfere. |
| PNG menor que o alvo | Geometria raster de módulos inteiros | Use dimensões reais; aumente alvo ou use SVG se útil. |
| Não decodifica ou mostra texto incorreto | Colocação e interpretação do símbolo/leitor | Preserve borda, amplie adequadamente e teste arquivo original e dados pretendidos. |
| Detecta código, mas página falha | Destino externo ou acesso | Confira URL decodificada, disponibilidade, redirecionamentos, autenticação e rede. |
DENSO WAVE: margens livres e dimensões dos módulosDENSO WAVE: correção e restauração de palavras de código
Use ferramentas relacionadas sem alterar os dados por acidente
O codificador e decodificador URL ajuda a examinar componentes, mas codificar todo o endereço sem critério ou duas vezes pode mudar seu significado. O limpador de texto remove caracteres indesejados antes de colar. Confira as mudanças porque este espaço QR não apara nem normaliza por você.
O redimensionador prepara PNG para o layout, mas reamostrar muda pixels e pode suavizar bordas. Mantenha a zona de silêncio e reteste. Em layout vetorial, preserve geometria SVG original e escolha dimensões apropriadas. São fluxos separados; a página QR não envia nem entrega automaticamente seus dados a essas ferramentas.
Perguntas frequentes
Estes códigos expiram?
O ToolMellow não põe temporizador na imagem estática. Os dados permanecem fixos, mas URL externa pode falhar, exigir acesso ou mudar conteúdo. Permanente ou estático não garante duração do destino.
Posso mudar o destino sem reimprimir?
Mudar a URL codificada exige outra imagem. Se controlar a URL inalterada, pode mudar externamente conteúdo ou redirecionamentos. Não há serviço hospedado de gestão dinâmica.
A prévia verifica se a URL funciona?
Não. Codifica texto que cabe no nível, sem acessar endereço ou validar segurança, disponibilidade ou formato externo. Confira endereço decodificado e destino separadamente.
Quanto texto cabe?
Na versão 40, os tetos UTF-8 são 2953 bytes em L, 2331 em M, 1663 em Q e 1273 em H. O padrão é M. O campo também limita a 3000 unidades UTF-16; nenhum limite conta universalmente caracteres visíveis.
Como espaços, quebras de linha e Unicode são tratados?
O valor atual é usado sem aparar. Texto bem formado vira UTF-8; substitutos sem par são rejeitados e não há segmento ECI. Teste a decodificação não ASCII no leitor previsto.
Correção maior sempre cria código mais denso?
Não. Pode exigir versão maior para os mesmos bytes, mas módulos só mudam em quantidade se a versão mudar. Rótulos aproximados não garantem distância de leitura.
Posso cobrir 30% com um logo?
30% é o rótulo de recuperação aproximada do controle H, não área segura para cobrir. A DENSO WAVE trata de palavras de código; posição do dano e detecção importam. Não há ferramenta de logo ou verificação de sobreposição.
Por que escolher 1024 não exporta exatamente 1024 pixels?
O renderizador preserva pixels inteiros por módulo e borda. Versão 1 ocupa 29 módulos ao todo; alvo 1024 gera 1015 pixels. Outras versões produzem dimensões arredondadas diferentes.
O seletor PNG muda o SVG?
Não. Afeta futuros PNG rasterizados. SVG mantém viewBox escalável e borda de quatro módulos, sem largura fixa em pixels escolhida.
O que Limpar remove?
Com prévia válida, esvazia texto e retira prévia, mantendo correção e alvo PNG. Não apaga exports. Com entrada inválida e ações ausentes, edite ou apague o texto diretamente.
Por que o PNG não baixou?
Sem contexto canvas surge aviso para usar SVG. Blob nulo não gera arquivo nem novo aviso. Tente SVG e confira downloads; o guia não prova compatibilidade com todo navegador.
Meus textos e leituras vão para o ToolMellow?
A geração local não envia requisição com os dados nem acrescenta redirecionamento de leitura ToolMellow. Hospedagem, análises gerais e acessos ao destino são separados. A imagem compartilhada pode revelar seus dados.
Posso criar códigos dinâmicos, logos ou lotes?
Essas funções não existem neste espaço. Há um texto estático, correção, alvo PNG e PNG/SVG. Texto formatado genérico não implica validação de Wi-Fi, contatos ou pagamentos.
O que testar antes de distribuir?
Teste exportação ou impressão no tamanho previsto com leitores representativos. Verifique texto, URL completa e acesso; preserve borda e contraste, e reteste após reamostragem ou mudanças externas.
Fontes e leitura adicional
- DENSO WAVE: versões QR e capacidade
- DENSO WAVE: correção e restauração de palavras de código
- DENSO WAVE: margens livres e dimensões dos módulos
- MDN: TextEncoder e bytes UTF-8
- MDN: maxlength e unidades UTF-16 de entrada
- MDN: detectar substitutos Unicode sem par
- MDN: Canvas.toBlob, exportação PNG e resultados nulos
- MDN: File API, objetos Blob e URLs de objeto
- W3C File API: revogar URL de objeto
Coloque em prática.
- Gerar QR Code
- Codificador e decodificador de URL
- Redimensionar imagem
- Limpador de texto e ordenador de linhas