Adapter une image avec bandes
Placez une image dans un cadre fixe sans la rogner ni l'étirer : une photo de 1920 sur 1080 dans un carré de 1000 sur 1000 devient 1000 sur 562, avec des bandes de 219 pixels en haut et en bas. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Largeur source
- 1 920
- Hauteur source
- 1 080
- Largeur de la toile
- 1 000
- Hauteur de la toile
- 1 000
- Échelle
- 0,5208333333
- Fit
- letterbox
Insérez une image dans un canevas fixe sans approximation, déformation ni perte de contenu. Indiquez les dimensions de la source et du canevas pour obtenir l’échelle uniforme, la taille finale en pixels et les bandes précises en haut, à droite, en bas et à gauche. Le résultat distingue les bandes horizontales, les bandes verticales et la correspondance exacte des proportions, ce qui convient aux vidéos, présentations, chaînes d’images et aperçus adaptatifs.
Préservez toute l’image et ses proportions
Un ajustement de type « contenir » garantit que chaque pixel source reste visible dans le canevas cible. Le calculateur compare les rapports d’aspect, retient le plus petit facteur horizontal ou vertical, puis applique ce facteur unique aux deux dimensions. Les cercles restent donc ronds, les visages ne sont pas comprimés et aucune partie de la composition n’est coupée.
La largeur et la hauteur renvoyées sont des nombres entiers de pixels qui ne dépassent jamais le canevas. Si une dimension proportionnelle exacte tombe entre deux pixels, l’axe contraint remplit son bord et l’autre est arrondi à l’entier inférieur, car un arrondi supérieur pourrait placer une ligne ou une colonne hors du cadre. La réponse fournit aussi l’échelle mathématique avant l’arrondi, pratique pour configurer un logiciel graphique ou comparer plusieurs canevas.
Les quatre dimensions doivent être des entiers positifs ; zéro ne définit aucun rapport exploitable et provoque donc une erreur de saisie.
Interprétez les bandes horizontales et verticales
L’objet des bandes indique en pixels l’espace situé en haut, à droite, en bas et à gauche. Une image large placée dans un canevas relativement haut laisse de l’espace vertical et produit des bandes au-dessus et au-dessous. Une image haute ou étroite dans un canevas relativement large laisse de l’espace horizontal, avec des bandes à gauche et à droite.
Si les rapports sont identiques, l’ajustement est exact et les quatre valeurs sont nulles. L’image est toujours centrée. Lorsque l’espace restant est pair, les bandes opposées ont la même taille.
Lorsqu’il est impair, le haut ou la gauche reçoit la plus petite part, tandis que le bas ou la droite reçoit le pixel restant. Cette règle déterministe permet aux dimensions de se recomposer exactement et évite les demi-pixels ambigus. Vous pouvez employer ces valeurs comme marges internes, décalages ou coordonnées de dessin : l’origine se trouve à gauche et en haut du rectangle ajusté.
Intégrez le résultat à vos traitements multimédias
Utilisez ces valeurs avant le redimensionnement plutôt qu’après l’exportation. Créez le canevas cible, redimensionnez la source selon la largeur et la hauteur calculées avec la méthode de rééchantillonnage voulue, puis placez-la aux décalages gauche et supérieur renvoyés. Remplissez l’espace restant avec une couleur, de la transparence, une extension floutée ou un autre arrière-plan.
Le calcul n’analyse pas les octets, ne choisit aucune couleur et ne rééchantillonne rien : il fournit une géométrie indépendante du format et de la bibliothèque. Pour un traitement par lots, validez les dimensions tôt et conservez le résultat avec la demande afin que chaque étape partage la même géométrie. Une même entrée produit toujours exactement le même placement.
Cas d’usage
Préparer des images vidéo
Insérez une séquence ou une illustration dans une résolution fixe et obtenez les bandes avant l’encodage.
Créer des aperçus sans recadrage
Centrez produits, portfolios ou documents dans des cartes uniformes sans supprimer de contenu.
Planifier une présentation
Calculez le rectangle et les marges équilibrées pour diapositives, affichage dynamique et écrans.
Questions fréquentes
Quel est le prix du calcul ?
Vous pouvez aussi effectuer gratuitement le calcul dans le navigateur.
L’image est-elle recadrée ou déformée ?
Non. Une échelle uniforme conserve l’image entière et les bandes occupent l’espace inutilisé.
Pourquoi deux bandes opposées diffèrent-elles parfois d’un pixel ?
Un espace impair ne se partage pas également en pixels entiers. Le pixel supplémentaire va à droite ou en bas.
Que se passe-t-il si les proportions correspondent déjà ?
L’ajustement est déclaré exact, l’image remplit le canevas et les quatre bandes sont nulles.
Puis-je saisir zéro pour une dimension inconnue ?
Non. Chaque dimension doit être un entier positif, car zéro ne définit aucun rapport d’aspect valide.
Cette capacité redimensionne-t-elle un fichier image ?
Non. Elle calcule uniquement la géométrie. Utilisez la taille et les décalages dans le moteur de rendu de votre choix.
Outils associés
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/image/letterbox-fit \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}'const res = await fetch("https://api.kit.forhosting.com/image/letterbox-fit", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"source_width": 1920,
"source_height": 1080,
"canvas_width": 1000,
"canvas_height": 1000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/letterbox-fit",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"source_width": 1920,
"source_height": 1080,
"canvas_width": 1000,
"canvas_height": 1000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/letterbox-fit", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/letterbox-fit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"source_width": 1920,
"source_height": 1080,
"canvas_width": 1000,
"canvas_height": 1000
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.letterbox_fit",
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_mb | 15 |
max_megapixels | 12 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Intégrez le résultat à vos traitements multimédias
Il convient ainsi à CSS, Canvas, SVG, FFmpeg, ImageMagick, aux API mobiles, aux présentations et aux miniatures. Une requête API coûte $0.002, tandis que le calcul peut aussi s’exécuter dans le navigateur.