Replicação de referência
O olho humano é bom em "algo está errado" e não confiável em "errado por quanto". Quando a instrução é "replique exatamente, sem erros", meça. Cada hora perdida ajustando um valor foi uma hora que um script de extração teria resolvido.
Nunca confie nas bordas da captura de tela
Capturas de tela chegam com letterbox, molduras de dispositivos ou bordas arredondadas do navegador. Medir com base nas dimensões do arquivo coloca cada porcentagem ligeiramente errada, e o erro é invisível porque tudo está quase certo.
Encontre a caixa de conteúdo real primeiro:
from PIL import Image
import numpy as np
a = np.array(Image.open(src).convert('RGB')).astype(int).sum(axis=2)/3
rows = np.nonzero(a[:, 5] > 200)[0] # uma coluna que é fundo da página
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()
Expresse cada medição subsequente como uma porcentagem dessa caixa, nunca do arquivo.
Extraia posições, não as estime
def bbox(x0, x1, y0, y1, lo, hi):
reg = a[y0:y1, x0:x1]
ys, xs = np.nonzero((reg >= lo) & (reg <= hi))
return x0+xs.min(), x0+xs.max(), y0+ys.min(), y0+ys.max()
Janela cada elemento e defina um limite em sua faixa de luminância — UI escura sobre fundo claro, ou o contrário. Duas precauções:
- Um resultado que cai exatamente na borda da sua janela é uma medição cortada, não uma descoberta. Aumente a janela e meça novamente.
- Texto escuro e uma fotografia escura ambos passam por um limite "escuro". Escolha janelas que contenham apenas o elemento.
Converta para porcentagens da caixa de conteúdo e construa com base nelas. Agora "o título é grande demais" se torna "o título tem 22,4% da largura do painel na referência e 32% no meu".
Verifique uma afirmação antes de construí-la
Procure por um recurso duas vezes antes de se comprometer. Em uma construção, um par de linhas verticais finas foi "visto" em uma miniatura e implementado; a referência não tinha nenhuma — era a borda da silhueta do próprio sujeito. Uma verificação teria detectado:
band = a[60:330, :].mean(axis=0) # linhas livres de outra UI
dips = [i for i in range(200, W-200) if band[i] < 228 - 0.8]
Fundo plano, sem quedas, sem linhas. Uma regra de 1px aparece como uma queda isolada de coluna única; uma borda fotográfica aparece como uma rampa gradual. É trivial distingui-las numericamente e fácil de confundir visualmente.
Resolva o enquadramento de imagem, não o ajuste
Para reproduzir como uma fotografia é cortada, derive-o. Meça a largura do sujeito como uma fração da foto, e novamente como uma fração do painel:
escalaRender = larguraSujeito_noPainel / larguraSujeito_naFoto # ex: 1.231
Com object-fit: cover escalando pela altura, larguraEscalada = larguraPainel × escalaRender, então
proporcaoPainel = 1 / (escalaRender / proporcaoFoto). Isso dá a proporção do painel que o
designer usou. Em seguida, resolva object-position a partir do centro do sujeito — a fórmula está
em ../landing-page/references/traps.md.
Verifique a sanidade com uma quantidade independente que você não ajustou, como a altura da coroa do sujeito. Se a previsão cair dentro de um ou dois pixels, o modelo está correto.
Saiba quando uma referência não pode ser correspondida
Às vezes a matemática diz não. Se o object-position necessário cair fora de 0–1, nenhum valor
coloca o sujeito lá — a proporção do painel ou a imagem precisa mudar.
E se um ativo fornecido é uma regeneração do original em vez do original, suas proporções serão diferentes. Detecte: preveja uma medição a partir da fonte e compare. Correspondência ao pixel em quatro amostras significa mesma imagem; uma incompatibilidade não uniforme (203px onde 282px é previsto, em apenas um ponto) significa um sujeito diferente.
Diga claramente, declare o que é correspondido — métricas de layout, enquadramento, posicionamento — e pare de perseguir o resto. Continuar "corrigindo" produz saída pior e queima o tempo do usuário.
Ambos os viewports, sempre
Uma referência é uma captura de tela de desktop e uma captura de tela mobile. Construir apenas para desktop e inferir mobile inverte a parte difícil — mobile é onde as correções são aplicadas. Se apenas uma foi fornecida, peça a outra antes de começar.
Ciclo de trabalho
- Extraia a caixa de conteúdo; meça cada elemento em uma tabela de porcentagens.
- Construa tokens e layout com base nesses números.
- Renderize na proporção da referência, escale a referência para sua largura, empilhe-as verticalmente com um divisor brilhante. Empilhado é melhor que lado a lado — o olho acompanha uma borda vertical.
- Meça novamente seu render com o mesmo script. Compare tabelas, não impressões.
- Repita por seção. Não passe para a próxima seção se a atual estiver visivelmente errada.
Lista de verificação
- Caixa de conteúdo extraída; porcentagens relativas a ela, não ao arquivo
- Nenhuma medição na borda de sua janela de busca
- Cada "recurso" confirmado numericamente antes de implementar
- Enquadramento de imagem resolvido, não ajustado
- Referências de desktop e mobile em mãos
- Render medido novamente com o mesmo script e comparado como números