Recadrer une image dans une zone

Ce validateur accepte la largeur et la hauteur de l’image source ainsi qu’une zone définie par x, y, sa largeur et sa hauteur. Il contrôle chaque valeur, vérifie que le rectangle entier reste dans l’image et renvoie les dimensions recadrées lorsque la zone est valide. Aucun transfert ni décodage d’image n’est nécessaire. Vous pouvez donc l’utiliser avant un processeur graphique, pour un aperçu de recadrage ou pour accepter les coordonnées d’un autre service.

Décrivez l’image source et la zone

Commencez par les dimensions en pixels de l’image d’origine. Indiquez dans image_width le nombre total de pixels horizontaux et dans image_height le nombre total de pixels verticaux. Décrivez ensuite le rectangle avec x, y, width et height. Les valeurs x et y placent son coin supérieur gauche par rapport à celui de l’image, situé en 0,0. Width s’étend vers la droite et height vers le bas. Les six valeurs doivent être des nombres entiers, car cette capacité traite un recadrage matriciel aligné sur les pixels, et non une géométrie fractionnaire. Les dimensions de l’image et de la zone doivent être positives, tandis que x et y peuvent valoir zéro. Par exemple, x égal à 240 ignore les 240 premières colonnes de pixels. Une zone peut toucher exactement chaque bord : x plus width peut donc égaler image_width, et y plus height peut égaler image_height. Utilisez les mesures du fichier réellement recadré ; les coordonnées d’un aperçu redimensionné doivent d’abord être remises à l’échelle.

Comprenez la validation des limites

Le validateur refuse d’abord les valeurs absentes, les nombres non entiers, les coordonnées négatives, les zones sans surface et les valeurs hors de la plage documentée. Il contrôle ensuite les deux frontières qui déterminent l’inclusion. Horizontalement, x plus width doit être inférieur ou égal à image_width. Verticalement, y plus height doit être inférieur ou égal à image_height. Si une somme est supérieure, une partie du recadrage sort de la source et la requête renvoie une erreur d’entrée non valide. Cette règle évite une confusion fréquente d’une unité : une zone large de 100 pixels commençant à x 0 occupe bien une étendue complète de 100 pixels et tient exactement dans une image large de 100 pixels. La capacité ne contraint, ne déplace et ne réduit jamais une zone incorrecte, car une modification silencieuse peut sélectionner un autre sujet ou modifier la composition. Elle n’analyse pas non plus les octets de l’image. Sa décision dépend uniquement des dimensions et coordonnées fournies, pour un résultat rapide, reproductible et adapté aux formulaires comme aux traitements automatisés.

Exploitez le résultat avant le recadrage réel

Une réponse réussie renvoie la largeur et la hauteur du recadrage obtenu. Elles correspondent à la zone demandée puisque cette capacité valide la géométrie sans rééchantillonner ni modifier le rectangle. Servez-vous de la réponse comme garde-fou avant de transmettre les mêmes coordonnées à une bibliothèque graphique, un service multimédia ou une tâche de rendu en attente. Vous séparez ainsi une validation peu coûteuse du décodage plus lourd et empêchez des erreurs prévisibles d’atteindre les traitements suivants. Dans un éditeur, validez après confirmation de la sélection ou après conversion des coordonnées de l’aperçu en pixels de l’original. Dans un pipeline, contrôlez les métadonnées dès leur réception et orientez les enregistrements incorrects vers une correction. Tenez compte de l’orientation : si une autre étape fait pivoter physiquement l’image, employez les dimensions après rotation et des coordonnées exprimées dans la même orientation. La requête API coûte $0.002 ; l’exécuteur du navigateur réalise localement le même calcul déterministe. Aucun des deux parcours ne transfère l’image.