ForHosting KIT · Imagens

Redimensionar tela com preenchimento

Redimensione a tela de uma imagem com preenchimento quando a figura precisar manter as dimensões originais em pixels.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Roda direto no seu navegador. Grátis, sem cadastro — seus dados não são enviados para lugar nenhum.

Informe a largura e a altura da imagem, as dimensões maiores da tela de destino e a cor de fundo. A calculadora retorna o preenchimento exato de cada lado e a posição superior esquerda da imagem na nova tela. Ela nunca corta, estica nem reamostra a fonte. Se qualquer dimensão de destino for pequena demais para conter a imagem, a solicitação falhará em vez de alterar a arte silenciosamente.

Amplie a tela preservando cada pixel da origem

Redimensionar a tela e escalar a imagem resolvem problemas diferentes. A escala muda a quantidade de pixels ocupada pela figura, o que pode suavizar detalhes, alterar dimensões preparadas com cuidado ou desrespeitar uma exigência de produção. Esta calculadora mantém a largura e a altura da imagem intactas. Ela subtrai essas dimensões da tela solicitada e descreve a área vazia que precisa ser acrescentada ao redor da origem. Isso é útil quando uma foto de produto, ilustração, captura de tela ou recurso gerado já está no tamanho correto, mas precisa de uma moldura maior. Informe dimensões inteiras positivas em pixels e a cor de fundo que a operação posterior deverá usar. O resultado repete as dimensões, apresenta o preenchimento superior, direito, inferior e esquerdo e fornece as coordenadas x e y do início da imagem. Nenhum arquivo é enviado ou decodificado, pois o cálculo depende somente da geometria.

Entenda a centralização quando os pixels restantes são ímpares

A centralização perfeita é simples quando a diferença entre a tela e a imagem é par. Por exemplo, 400 pixels horizontais adicionais geram 200 à esquerda e 200 à direita. Uma diferença ímpar não pode ser dividida em duas metades com pixels inteiros. Nesse caso, a calculadora coloca a parte menor à esquerda ou em cima e o pixel adicional à direita ou embaixo. Assim, uma diferença horizontal de 401 vira 200 pixels à esquerda e 201 à direita. Essa convenção mantém a posição determinística e evita coordenadas fracionárias que ferramentas rasterizadas não representam. O campo image_position é igual ao preenchimento esquerdo e superior, portanto você pode enviá-lo diretamente a muitas API de desenho, composição ou linha de comando. Somar esquerda, largura e direita sempre recompõe a largura da tela; a soma vertical equivalente sempre recompõe sua altura. Essas propriedades facilitam a validação automática antes do processamento real.

Valide o destino antes de montar o fluxo de imagens

A tela de destino deve ser pelo menos tão larga e tão alta quanto a imagem de origem. Atender a apenas uma condição não basta: uma tela larga, porém baixa, ainda cortaria na vertical; uma tela alta, porém estreita, cortaria na horizontal. A calculadora rejeita os dois casos com um erro de entrada inválida, tornando um corte acidental visível ainda no planejamento. Dimensões iguais são aceitas e retornam preenchimento zero nos quatro lados, o que ajuda quando um fluxo recebe arquivos variados e alguns já correspondem ao destino. A cor de fundo é tratada como uma string não vazia, e não interpretada segundo uma sintaxe específica. Você pode usar uma cor hexadecimal, um valor CSS, um nome ou um token como transparent, desde que o processador posterior o reconheça. Use a resposta para configurar a expansão da tela em sua ferramenta preferida. A API custa US$ 0,002 por solicitação e entradas repetidas geram resultados idênticos.

Padronizar telas de fotos de produtos

Centralize uma imagem de produto já dimensionada em uma tela uniforme de catálogo sem ampliar nem cortar o item.

Preparar artes sociais com segurança

Calcule a borda necessária ao redor de uma arte pronta antes de exportá-la para uma tela maior de uma plataforma.

Configurar um fluxo de imagens

Converta dimensões de origem e destino em deslocamentos exatos para uma operação posterior de expansão da tela.

A ferramenta redimensiona ou reamostra a imagem?

Não. Ela preserva as dimensões informadas e calcula somente a área adicional da tela ao redor da imagem.

O que acontece quando a tela de destino é menor?

A solicitação retorna um erro de entrada inválida se qualquer dimensão de destino for menor que a dimensão correspondente da imagem.

Onde fica o pixel extra quando o preenchimento é ímpar?

O pixel adicional vai para a direita ou para baixo; a esquerda e a parte superior recebem a metade inteira menor.

Quais formatos de cor de fundo são aceitos?

A calculadora aceita qualquer string de cor não vazia e a retorna sem espaços externos. A ferramenta posterior determina se a sintaxe é válida.

Quanto custa uma solicitação de API?

Cada solicitação de API custa US$ 0,002. O cálculo usa apenas as dimensões e o texto da cor, não o arquivo da imagem.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/image/canvas-resize-pad

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/image/canvas-resize-pad \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_width":1200,"image_height":800,"canvas_width":1600,"canvas_height":1000,"background_color":"#ffffff"}'
{
  "image_width": 1200,
  "image_height": 800,
  "canvas_width": 1600,
  "canvas_height": 1000,
  "background_color": "#ffffff"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.canvas_resize_pad",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_mb15
max_megapixels12
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →