Verifique o alinhamento de ícones à grade

Este verificador compara as bordas esquerda, superior, direita e inferior da caixa delimitadora de um ícone com as linhas mais próximas de uma grade regular. Informe o tamanho da grade e uma tolerância opcional para receber um resultado geral e um diagnóstico claro de cada borda. A ferramenta é útil em revisões de sistemas de design, pipelines de ativos e controles automatizados de qualidade que precisam aplicar a mesma regra mensurável a todos os ícones.

Descreva o ícone e a grade no mesmo sistema de coordenadas

Informe a caixa delimitadora do ícone com quatro coordenadas: esquerda, topo, direita e base. Todos os valores precisam usar a mesma unidade e a mesma origem da grade. Por exemplo, se o viewBox de um SVG for medido em unidades de usuário, forneça as coordenadas da caixa e o tamanho da grade nessas unidades; se o fluxo de exportação usar pixels, mantenha pixels em todos os campos. A grade tem origem em zero, e suas linhas aparecem em cada múltiplo inteiro do tamanho escolhido, tanto no sentido positivo quanto no negativo. Assim, uma grade de tamanho oito possui linhas em zero, oito, dezesseis e vinte e quatro, além de menos oito e menos dezesseis. O verificador trata coordenadas horizontais e verticais da mesma maneira, pois o espaçamento é quadrado e uniforme. Coordenadas fracionárias são aceitas, o que é importante quando transformações vetoriais ou escalas produzem limites de subpixel. A direita pode ser igual à esquerda e a base pode ser igual ao topo, embora ícones visíveis comuns tenham largura e altura positivas. Limites invertidos são recusados porque não formam uma caixa válida. Acima de tudo, o tamanho da grade deve ser positivo; zero ou um valor negativo gera um erro de entrada em vez de um resultado enganoso.

Entenda a tolerância e o resultado de cada borda

A tolerância define a distância máxima entre uma borda e uma linha para que ela seja considerada alinhada. O padrão é zero, exigindo alinhamento exato após a normalização numérica estável. Uma tolerância positiva é inclusiva: com 0.02, uma borda exatamente a 0.02 unidade da linha mais próxima é aprovada. Para cada lado, a resposta apresenta a coordenada original, a linha de grade mais próxima, a distância absoluta e um indicador booleano de alinhamento. Ela também fornece um valor geral, verdadeiro somente quando as quatro bordas passam, e uma lista com todas as bordas desalinhadas. Essa combinação permite decisões rápidas e orientações úteis. Uma rotina de integração contínua pode falhar com base no indicador geral, enquanto uma ferramenta de design mostra precisamente quais lados precisam de ajuste. Os cálculos decimais são normalizados em doze casas para evitar que artefatos comuns de ponto flutuante apareçam na resposta. Quando uma borda está exatamente no meio de duas linhas, ambas são igualmente próximas; a implementação escolhe uma de modo determinístico, sem alterar a distância nem o resultado. A tolerância deve ser zero ou positiva. Defina-a conforme o seu processo de exportação, sem usar um valor grande que torne a regra da grade irrelevante.

Inclua a verificação no controle de qualidade dos ícones

O fluxo mais confiável mede os limites depois das transformações que realmente serão publicadas. Um ícone pode ter sido desenhado cuidadosamente sobre a grade no documento original e ainda ganhar valores fracionários após redimensionamento, expansão de traço, ajuste do viewBox ou otimização de exportação. Envie esses limites finais ao verificador e mantenha o resultado junto de outros controles de ativos, como nomenclatura, dimensões e tamanho de arquivo. Em conjuntos rigorosos de pixel art, use tolerância zero quando a exportação precisar produzir coordenadas inteiras da grade. Em ativos vetoriais com suavização, adote uma tolerância pequena e documentada que represente o arredondamento legítimo das ferramentas. Aplique o mesmo tamanho de grade e a mesma tolerância em toda a coleção, para que um resultado aprovado tenha significado consistente. Quando houver falha, examine primeiro a lista de bordas desalinhadas e use a linha mais próxima informada para cada lado como alvo da correção. Lembre-se de que esta capacidade avalia somente a caixa delimitadora. Ela não julga equilíbrio óptico, posição dos traços, pontos de controle internos, peso visual nem se a grade escolhida combina com a arte. Em vez disso, oferece uma regra geométrica restrita, reproduzível e fácil de automatizar, sem rede, estado oculto ou interpretação específica de uma ferramenta.