← Todos os guias do FaintType

Solução de problemas

Por que a medição de contraste muda no mesmo texto de uma captura

Entenda como antisserrilhamento, escala, compressão, limites do OCR e fundos mistos podem alterar a estimativa sem mudar as cores previstas no design.

Publicado em Atualizado em

Escolha uma cor escura para o texto e um fundo claro em uma ferramenta de design, e o cálculo de contraste será simples. Meça o mesmo texto em uma captura e surgirão dezenas de cores intermediárias nas bordas das letras. Uma única linha também pode atravessar uma sombra, um gradiente ou um bloco de imagem comprimida.

É por isso que verificadores de capturas podem divergir de uma calculadora de tokens de design mesmo quando os dois cálculos estão implementados corretamente. A parte difícil é decidir quais pixels renderizados representam o primeiro plano e quais representam o fundo.

O antisserrilhamento cria cores que nunca estiveram na paleta

A rasterização da fonte mistura os pixels das bordas com o fundo para suavizar curvas e diagonais. Usar um pixel da borda como cor do texto produz um contraste menor do que usar o interior da letra. Essa proporção muda com a escala da tela, a renderização da fonte e o redimensionamento da imagem.

O FaintType procura pixels centrais do primeiro plano em vez de tratar todos os pixels do retângulo de OCR como texto. Ao escolher candidatos a primeiro plano, também exclui uma faixa fina próxima da borda da caixa de OCR, reduzindo a chance de confundir a borda de um botão próximo com uma letra.

Um retângulo de OCR indica uma posição, não uma máscara das letras

O Apple Vision retorna observações de texto reconhecido com regiões delimitadoras normalizadas e valores de confiança. A caixa de uma linha normalmente inclui espaços entre letras e pode incluir decoração próxima. A estimativa de cor precisa refinar essa região ampla antes de comparar primeiro plano e fundo.

O FaintType amostra a região e uma faixa ao redor dela, agrupa cores semelhantes e separa os componentes de letras retidos do fundo ao redor. Se o reconhecimento unir textos sem relação ou deixar passar um rótulo pequeno, a caixa e a estimativa de cor ainda poderão estar erradas.

Uma linha pode ter mais de um fundo válido

Um gradiente, uma fotografia, um painel translúcido ou uma sombra significa que não há uma única cor de fundo atrás da linha inteira. O FaintType estima um fundo local para os componentes de letras retidos e resume as medições em um valor típico, uma estimativa local mais baixa e a cobertura da área que atinge o limiar.

Esses resumos respondem a perguntas diferentes. O valor típico descreve a maior parte do texto renderizado; a estimativa mais baixa ajuda a localizar um trecho vulnerável; a cobertura mostra quanto da área amostrada atinge o limiar WCAG selecionado. Não informe apenas o número mais favorável quando a linha claramente atravessa um fundo variável.

Como investigar um resultado inesperado

Volte à captura no tamanho original, selecione o resultado e compare as amostras de primeiro plano e fundo com os pixels destacados. Verifique se a imagem foi redimensionada, recomprimida ou capturada em outra escala de tela. Se a confiança for média ou baixa, confirme as cores no design original ou no inspetor do navegador.

Uma estimativa de captura deve ser reproduzível para os mesmos pixels, mas não se espera que coincida com um cálculo das cores de origem depois que os pixels forem transformados. Preserve a exportação original quando uma pequena diferença em torno do limiar puder mudar a decisão.