ForHosting KIT · Images

Arrondir les coins d’une image

Arrondir les coins d’une image paraît simple, mais le rayon devient géométriquement impossible dès qu’il dépasse la moitié du côté le plus court.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Ce calculateur vérifie la largeur, la hauteur et le rayon proposé avant l’application de l’effet. Une requête valide renvoie le rayon maximal autorisé et une description claire du masque alpha en rectangle arrondi. Une valeur incorrecte provoque immédiatement une erreur, afin que les outils de conception, scripts d’exportation et systèmes de contenu écartent les réglages impossibles avant le rendu.

Validez le rayon avant de traiter une image

Saisissez la largeur et la hauteur de l’image sous forme de nombres entiers positifs de pixels, puis indiquez le rayon souhaité pour les coins. Le validateur repère le côté le plus court et le divise par deux pour déterminer le plus grand rayon qui tient sans que les arcs de coins opposés se croisent. Pour une image de 1200 par 800, par exemple, le côté court mesure 800 pixels et le rayon maximal valide vaut 400 pixels. Toute valeur comprise entre zéro et 400 est acceptée, y compris une valeur fractionnaire si le moteur de mise en page ou de rendu gère la géométrie sous-pixel. Une valeur supérieure est refusée avec une erreur d’entrée qui précise la limite calculée. Cette vérification est utile avant d’appeler un transformateur d’images, car elle sépare une décision géométrique peu coûteuse du décodage, du transfert ou du rendu du fichier. Elle impose également une règle identique aux formulaires web et aux API, évitant qu’un client réduise silencieusement une valeur tandis qu’un autre échoue. La largeur et la hauteur sont des entiers positifs représentant les dimensions matricielles réelles ; le rayon doit être un nombre fini positif ou nul.

Comprenez le masque en rectangle arrondi

Un résultat valide décrit un masque alpha ayant exactement la largeur et la hauteur de l’image source. La zone centrale reste opaque. À chaque coin, un arc de quart de cercle du rayon demandé définit la limite : les pixels situés dans le rectangle arrondi demeurent visibles, tandis que ceux qui se trouvent au-delà des quatre arcs deviennent transparents lorsque le masque est appliqué. Cette capacité décrit l’opération, mais elle ne transfère, ne décode et ne modifie aucun fichier image. Un rayon nul produit un rectangle opaque ordinaire et ne retire donc aucun pixel dans les coins. Au rayon maximal, les arcs se rejoignent le long de la dimension la plus courte ; une image carrée devient alors un cercle, tandis qu’une image rectangulaire prend une forme de capsule. La réponse reprend les dimensions acceptées, le rayon et la valeur maximale calculée, accompagnés d’une description lisible du masque. Elle convient ainsi aux journaux, messages de validation, spécifications graphiques et traitements qui doivent expliquer l’effet avant d’appeler un moteur de rendu. Aucune méthode d’interpolation n’est imposée, car l’anticrénelage relève du moteur qui appliquera finalement le masque.

Appliquez une règle géométrique unique partout

Une validation cohérente du rayon évite les différences discrètes entre maquettes, sites web, applications mobiles et traitements d’images par lots. Un système de design peut contrôler les spécifications des avatars et des cartes avant de publier ses jetons. Un service multimédia peut refuser une transformation incorrecte avant d’allouer des ressources de traitement. Une boutique peut vérifier que l’arrondi choisi convient à toutes les tailles de vignettes générées. Comme cette capacité n’effectue que des calculs déterministes et produit du texte, des entrées identiques donnent toujours le même résultat ; elle n’utilise ni réseau, ni valeur aléatoire, ni horloge, ni stockage, ni opération cachée sur l’image. Le calcul conserve les dimensions du canevas source, car l’arrondi modifie la visibilité au bord, pas la taille du canevas. Le rayon maximal dépend uniquement du côté court : permuter largeur et hauteur ne change donc pas la limite. Le tarif de l’API est de $0.002 par requête, et ce calcul pur peut aussi s’exécuter gratuitement dans le navigateur. Utilisez la description comme plan ou trace de validation, puis transmettez le rayon validé au moteur séparé qui transformera réellement les pixels.

Contrôler la géométrie d’un avatar

Vérifiez que le rayon d’une photo de profil est valide et déterminez si un avatar carré deviendra parfaitement circulaire.

Protéger une API de transformation

Refusez les réglages impossibles avant de transférer, décoder ou effectuer le rendu de l’image source.

Valider des jetons de design

Comparez les rayons partagés à chaque taille d’image pour harmoniser le web, le mobile et les exportations.

Quel est le rayon maximal autorisé ?

Il correspond à la moitié de la plus petite dimension. Pour une image de 800 par 600, le maximum est de 300 pixels.

Que se passe-t-il si le rayon est trop grand ?

La requête échoue avec une erreur d’entrée qui indique le rayon maximal calculé à partir des dimensions.

Cette capacité modifie-t-elle le fichier image ?

Non. Elle valide les dimensions et décrit le masque alpha ; un moteur distinct doit appliquer ce masque aux pixels.

Le rayon peut-il être nul ou fractionnaire ?

Oui. Zéro décrit un masque rectangulaire sans coins retirés, et toute valeur fractionnaire finie dans la limite est admise.

L’arrondi change-t-il les dimensions du canevas ?

Non. Le masque garde la largeur et la hauteur d’origine ; seuls les pixels situés hors des arcs deviennent transparents.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. Le calcul déterministe fonctionne aussi dans le navigateur sans accès au réseau.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/image/round-corners

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

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"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_mb15
max_megapixels12
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →