Gerador de folha de contato

Informe a largura e a altura em pixels de cada imagem, além da maior largura permitida, e esta calculadora retornará uma grade prática com uma caixa uniforme para miniaturas. O resultado apresenta colunas, linhas, tamanho da miniatura e dimensões finais da folha. O layout acomoda todas as proporções das origens, respeita o limite de largura e usa cálculos determinísticos que sempre geram o mesmo resultado.

Prepare as dimensões e o limite de largura

Comece com um registro para cada imagem que aparecerá na folha de contato. Cada registro precisa de largura e altura em pixels, ambas como números inteiros positivos. Os arquivos não são enviados nem decodificados: somente suas dimensões são necessárias. Inclua todas as imagens, pois a quantidade de registros determina quantas células a grade deve oferecer, enquanto a maior largura e a maior altura das origens definem uma caixa comum capaz de conter toda a coleção sem cortes. Em seguida, defina max_sheet_width como a largura em pixels disponível no documento, na exportação, no painel da galeria ou no fluxo de impressão. A calculadora considera esse valor um limite rígido. Ela não reserva espaço para margens externas, legendas, intervalos, bordas ou sangria; desconte essas áreas antes se outro sistema for acrescentá-las. Uma lista vazia é rejeitada porque colunas, linhas e tamanho de miniatura não têm significado útil sem itens. Dimensões fracionárias, nulas, negativas ou inválidas também são recusadas para manter previsíveis os processos automatizados.

Entenda como a grade é escolhida

O algoritmo avalia todas as quantidades viáveis de colunas, de uma até o número de imagens. Para cada opção, ele calcula as linhas necessárias com arredondamento para cima, divide a largura máxima da folha em células uniformes de largura inteira e deriva a altura correspondente a partir do envelope das dimensões originais. Isso cria uma caixa uniforme adequada ao posicionamento contain: o renderizador escala cada imagem proporcionalmente até que ela caiba, talvez deixando espaço livre em um eixo, mas sem exigir corte. Depois, o algoritmo compara a largura e a altura da folha resultante e escolhe a opção mais próxima de um quadrado. Uma folha compacta e equilibrada costuma ser mais fácil de examinar e evita a faixa extrema de uma única coluna que surgiria ao apenas maximizar miniaturas. Se duas opções forem igualmente quadradas, vence a que oferece maior área de miniatura. Persistindo o empate, menos colunas são preferidas. A largura da miniatura também não ultrapassa a origem mais larga, evitando ampliação desnecessária. Todos os cálculos usam pixels inteiros e critérios determinísticos de desempate.

Use o resultado em um renderizador

A resposta fornece count, columns, rows, thumbnail_size, sheet_size, max_sheet_width e o modo fit. Crie uma tela com sheet_size.width e sheet_size.height; depois, posicione o item de índice i na coluna equivalente a i módulo columns e na linha correspondente à parte inteira de i dividida por columns. Cada célula usa a largura e a altura de miniatura retornadas. Redimensione a origem com uma operação contain, centralize-a na célula se desejar e preserve sua proporção original. Como a última linha pode ficar incompleta, o renderizador pode deixar as células finais vazias ou centralizar essa linha; a tela calculada mantém deliberadamente uma geometria retangular simples. O resultado não inclui intervalos nem legendas. Para acrescentar, por exemplo, dez pixels entre células, reserve previamente a largura total desses espaços ou reduza uniformemente as dimensões retornadas. O endpoint atende tanto ao uso interativo quanto a lotes repetíveis: entradas idênticas produzem saídas idênticas, nenhuma solicitação de rede é feita e o conteúdo visual nunca é examinado. O uso da API custa US$ 0,002 por solicitação, enquanto o navegador pode executar localmente o mesmo cálculo puro.