Corte quadrado centralizado no rosto: calcule a região exata

O estimador de corte centralizado no rosto transforma o resultado de uma detecção facial em uma região de corte quadrado pronta para uso. Você envia as dimensões da imagem e a caixa delimitadora do rosto detectado — esquerda, topo, largura e altura — além de uma margem opcional, e recebe de volta os valores exatos de x, y e lado de um quadrado que mantém o rosto centralizado e totalmente dentro da imagem. Nenhum pixel é enviado, decodificado ou transformado: trata-se de geometria pura e determinística, a etapa de planejamento que você executa antes do corte real.

Por que estimar o corte antes de cortar

O corte sensível a rostos aparece em todo lugar: fotos de perfil, geradores de avatar, miniaturas de um diretório de pessoas, pré-visualizações inteligentes em uma biblioteca de fotos. Em todos eles, a parte custosa é decodificar e recodificar a imagem, e a parte irritante é descobrir depois que o enquadramento saiu errado — o rosto cortado na borda, o quadrado fora do centro, a margem apertada demais para uma máscara circular. Esta capacidade separa a decisão barata da execução cara.

Você já executou um detector de rostos e tem uma caixa delimitadora; em vez de alimentar a imagem diretamente em um pipeline e torcer pelo melhor, você solicita primeiro a região exata de corte.

Como a região é calculada

O algoritmo é deliberadamente simples e totalmente determinístico. Primeiro, ele encontra o centro da caixa delimitadora do rosto. O lado do quadrado começa como o maior valor entre a largura e a altura do rosto, multiplicado por um mais duas vezes a margem — assim, a margem padrão de 0.25 adiciona um quarto do tamanho do rosto em cada lado, gerando um quadrado uma vez e meia maior que o maior lado do rosto, um enquadramento confortável para retratos.

Se esse quadrado for maior que a própria imagem, ele é reduzido à menor dimensão dela. O quadrado é então centralizado no centro do rosto e, quando ultrapassaria alguma borda, deslocado de volta para dentro da imagem — limitado, nunca deformado — de modo que a região retornada é sempre um corte válido e dentro dos limites.

Onde ele se encaixa em um pipeline

O fluxo típico é: execute o detector de rostos de sua preferência, pegue a melhor caixa delimitadora, chame este estimador e depois passe a região retornada a um cortador real, como a capacidade image.crop ou o seu próprio worker de miniaturas. Como o estimador nunca toca nos bytes da imagem, você também pode usá-lo apenas com metadados — por exemplo, para decidir, antes de baixar qualquer coisa, se um rosto detectado perto da borda renderá um quadrado utilizável ou se deve recorrer a outro layout.

O parâmetro de margem é o seu único ajuste: 0 produz um quadrado justo exatamente ao redor do maior lado do rosto, 0.25 é o enquadramento padrão para retratos e 0.5 ou mais deixa espaço para cabelo e ombros.