ForHosting KIT · Imagens

Arredondar cantos da imagem

Em uma imagem de 1200 × 800 cabe qualquer raio de canto de 0 a 400 pixels, porque o limite é metade do lado menor. Confira o raio antes de exportar e veja quais pixels dos cantos ficarão transparentes. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Largura
1.200
Altura
800
Raio
64
Você obtém
Raio máximo
400

Arredondar os cantos de uma imagem parece simples, mas o raio se torna geometricamente inválido quando ultrapassa metade do menor lado. Esta calculadora verifica largura, altura e raio proposto antes que um fluxo aplique o efeito. Uma solicitação válida retorna o maior raio permitido e uma descrição clara da máscara alfa em forma de retângulo arredondado. Uma entrada inválida falha imediatamente, ajudando ferramentas de design, scripts de exportação e sistemas de conteúdo a recusarem configurações impossíveis antes da renderização.

Valide o raio antes de processar a imagem

Informe a largura e a altura da imagem como números inteiros positivos de pixels e depois indique o raio desejado para os cantos, também em pixels. O validador identifica o menor lado e o divide por dois para determinar o maior raio que cabe sem cruzar os arcos de cantos opostos. Em uma imagem de 1200 por 800, por exemplo, o menor lado tem 800 pixels e o raio máximo válido é 400 pixels.

Qualquer raio de zero a 400 é aceito, inclusive valores fracionários quando o mecanismo de layout ou renderização trabalha com geometria de subpixel. Valores maiores são recusados com um erro de entrada que informa o limite calculado. Essa verificação é útil antes de chamar um transformador de imagens, pois separa uma decisão geométrica barata da decodificação, do envio ou da renderização do arquivo.

Largura e altura devem ser inteiros positivos porque representam dimensões raster reais, enquanto o raio precisa ser um número finito não negativo.

Entenda a máscara de retângulo arredondado

Um resultado válido descreve uma máscara alfa com a mesma largura e altura da imagem original. A área central permanece opaca. Em cada canto, um arco de um quarto de círculo com o raio solicitado define o limite: os pixels dentro do retângulo arredondado continuam visíveis, enquanto os pixels fora dos quatro arcos ficam transparentes quando a máscara é aplicada.

A capacidade descreve essa operação, mas não envia, decodifica nem altera um arquivo de imagem. Um raio igual a zero produz um retângulo opaco comum, sem remover pixels dos cantos. No raio máximo, os arcos se encontram ao longo da menor dimensão; assim, uma imagem quadrada vira um círculo, enquanto uma imagem retangular assume uma forma semelhante a uma cápsula.

A resposta repete as dimensões aceitas, o raio e o máximo calculado, além de apresentar uma descrição legível da máscara. Isso torna o resultado adequado para registros, mensagens de validação, especificações de design e código posterior que precise explicar o efeito antes de chamar um renderizador. Nenhum método de interpolação é presumido, pois a suavização pertence ao mecanismo que aplicará a máscara.

Use uma regra geométrica em design e automação

A validação consistente do raio evita diferenças sutis entre protótipos, sites, aplicativos móveis e tarefas de imagens em lote. Um sistema de design pode conferir especificações de avatares e cartões antes de publicar tokens. Um serviço de mídia pode recusar uma transformação inválida antes de reservar recursos de processamento.

Uma loja pode confirmar que o arredondamento escolhido funcionará em todos os tamanhos de miniatura gerados. Como esta capacidade executa somente aritmética determinística e construção de texto, entradas idênticas sempre geram resultados idênticos; não há rede, aleatoriedade, relógio, armazenamento nem operação oculta sobre imagens. O cálculo preserva as dimensões da tela original porque arredondar cantos altera a visibilidade nas bordas, e não o tamanho da tela.

O raio máximo depende apenas do menor lado, portanto girar as dimensões ou trocar largura e altura não muda o limite permitido. Use a descrição retornada como plano ou registro de validação e depois envie o raio validado ao renderizador separado que realizará a transformação dos pixels.

Verificar a geometria de avatares

Confirme se o raio de uma foto de perfil é válido e descubra se um avatar quadrado ficará totalmente circular.

Validar tokens de design

Compare raios compartilhados com cada tamanho de imagem e mantenha o mesmo comportamento na web, no celular e nas exportações.

Qual é o maior raio permitido para os cantos?

É metade da menor dimensão da imagem. Em uma imagem de 800 por 600, o raio máximo é 300 pixels.

O que acontece quando o raio é grande demais?

A solicitação falha com um erro de entrada inválida que inclui o raio máximo calculado com base nas dimensões.

Esta capacidade altera o arquivo da imagem?

Não. Ela valida dimensões e descreve a máscara alfa; um renderizador separado precisa aplicar a máscara aos pixels.

O raio pode ser zero ou fracionário?

Sim. Zero descreve uma máscara retangular sem cantos removidos, e qualquer valor fracionário finito dentro do limite é aceito.

Arredondar os cantos muda as dimensões da tela?

Não. A máscara mantém a largura e a altura originais e apenas deixa transparentes os pixels fora dos arcos.

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/round-corners

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/round-corners \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":800,"radius":64}'
{
  "width": 1200,
  "height": 800,
  "radius": 64
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.round_corners",
  "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.

Valide o raio antes de processar a imagem

Ela também estabelece uma regra única para formulários do navegador e API, evitando que um cliente reduza silenciosamente o valor enquanto outro falha.

Use uma regra geométrica em design e automação

O preço da API é US$ 0,002 por solicitação, e o mesmo cálculo puro pode ser usado gratuitamente no navegador.

Proteger uma API de transformação

Recuse configurações impossíveis antes de enviar, decodificar ou renderizar a imagem de origem.

Quanto custa uma solicitação API?

Cada solicitação API custa US$ 0,002. O cálculo determinístico também pode ser executado no navegador sem acesso à rede.

Ver a documentação completa do KIT →