Calcul des bandes letterbox en pixels pour vidéo

Saisissez le format de la source, celui du canevas cible et sa hauteur. Le résultat précise si les bandes se placent en haut et en bas ou à gauche et à droite, puis indique la taille de chaque bande identique. Si les deux formats coïncident, il renvoie correctement zéro, car l’image remplit déjà le canevas sans recadrage ni marge.

Commencez par les formats de la source et du canevas

Un rapport d’aspect exprime la largeur par rapport à la hauteur : 16:9 et 1.777777 décrivent donc la même forme. Indiquez le format de l’image que vous souhaitez préserver, puis celui du canevas final. La hauteur du canevas fixe l’échelle réelle en pixels et sa largeur est déduite du format cible. Le calculateur accepte W:H, W/H ou un nombre décimal positif, notamment 4:3, 16:9, 21:9 et 2.39:1. Lorsque vous connaissez l’ouverture d’affichage exacte, utilisez-la plutôt qu’une appellation commerciale approximative. Certains formats couramment désignés par 21:9 ont, par exemple, des valeurs légèrement différentes ; à haute résolution, cet écart peut produire des bandes visibles. Toutes les dimensions doivent être positives et finies, et la hauteur du canevas doit être un nombre entier de pixels. Si les deux rapports sont égaux, aucune marge n’est requise : toutes les dimensions de bande valent zéro, sans erreur.

Distinguez les bandes horizontales des bandes latérales

La source est entièrement ajustée au canevas, sans déformation ni suppression de contenu. Lorsqu’elle est plus large que le canevas cible, sa largeur atteint d’abord les bords. Sa hauteur ajustée devient alors inférieure à celle du canevas, et l’espace libre est partagé également au-dessus et au-dessous de l’image. Le résultat nomme cette orientation top_bottom et fournit la hauteur de chaque bande. Si la source est plus étroite, sa hauteur atteint d’abord les limites et il reste de l’espace horizontal. Celui-ci est réparti entre la gauche et la droite, ce qui donne l’orientation left_right et la largeur de chaque bande latérale. Ce cas est souvent appelé pillarbox, mais les deux situations utilisent le même calcul d’ajustement. Le champ bar_size_pixels contient toujours la taille d’une seule bande, et non la marge cumulée. Les champs propres à chaque bord rendent le résultat immédiatement exploitable par un code de mise en page.

Exploitez le résultat au montage et au rendu

Utilisez les dimensions obtenues pour préparer des incrustations, des images d’aperçu, des masters encodés, des projections ou des compositions CSS et canvas. Lorsque la géométrie ne tombe pas sur des pixels entiers, le calculateur conserve une valeur fractionnaire, arrondie de façon déterministe à six décimales. Un outil exigeant des coordonnées entières doit appliquer sa propre règle, car arrondir séparément les deux bandes peut modifier la dimension finale d’un pixel. Dans un flux matriciel, vous pouvez arrondir un bord vers le bas et attribuer le pixel restant au bord opposé ; un rendu vectoriel ou Web accepte souvent la fraction. Le calcul suppose un ajustement contain centré : il conserve toute la source, ne recadre pas et répartit les marges à égalité. Il ne tient pas compte des pixels anamorphiques, de la rotation, de l’overscan ni des zones de sécurité ; convertissez-les d’abord en rapport d’affichage effectif. L’automatisation par API coûte $0.002 par requête.