Comment recadrer une image avec des coordonnées numériques

Préparer l’image et la zone à conserver

Ce recadreur sert à extraire une région rectangulaire d’une image à partir de données d’image fournies sous forme de chaîne. Il convient lorsque vous connaissez les quatre limites de la zone à conserver : gauche, haut, droite et bas. Les coordonnées sont des valeurs numériques appliquées aux dimensions de l’image décodée, et non des pourcentages. L’image obtenue est renvoyée sous forme de données encodées, dans le format de l’image source lorsqu’il est disponible, ou en PNG dans le cas contraire.

Recadrer l’image avec des coordonnées numériques

Préparez une chaîne contenant des données d’image non vides. L’outil décode cette chaîne en base64, puis tente d’ouvrir les octets obtenus comme une image.
Renseignez les quatre limites numériques de la zone : gauche, haut, droite et bas. Si vous ne fournissez pas ces valeurs, les valeurs prévues par défaut sont respectivement 0, 0, 100 et 100.
Vérifiez que les limites correspondent aux dimensions de l’image décodée. La gauche et le haut sont ramenés dans les limites de l’image. La droite est limitée à la largeur de l’image et ajustée pour rester au moins une unité au-delà de la gauche ; le bas suit la même logique par rapport à la hauteur et au haut.
Lancez le traitement et récupérez l’image recadrée encodée en base64. Pour obtenir une zone prévisible, utilisez des coordonnées cohérentes avec la largeur et la hauteur réelles de l’image plutôt que des valeurs exprimées en pourcentage.
Si le traitement échoue, contrôlez d’abord que les données d’image ne sont pas vides et qu’elles correspondent bien à une image lisible. Une erreur peut aussi survenir pendant le décodage, l’ouverture, le recadrage ou l’enregistrement de l’image.

Comprendre l’image recadrée et les cas limites

Le résultat attendu est une nouvelle image encodée en base64, correspondant à la région rectangulaire demandée après l’application des limites. Il ne s’agit pas d’une image redimensionnée, tournée ou améliorée : le traitement porte sur le recadrage uniquement.

Interprétez les limites comme des bornes appliquées aux dimensions décodées de l’image. Une valeur droite ou basse dépassant l’image est ajustée. De même, une valeur gauche ou haute hors limites est contrainte ; l’ajustement minimal destiné à conserver une étendue peut donc modifier légèrement la borne opposée lorsque la limite atteint le bord correspondant.

Le format de sortie reprend le format de l’image source lorsqu’il peut être déterminé ; sinon, l’image est enregistrée en PNG. La réussite dépend aussi de la disponibilité de la dépendance de traitement d’image et de la possibilité de décoder, d’ouvrir, de recadrer puis d’enregistrer les données.

Exemple pratique

Vous souhaitez isoler une zone rectangulaire située au centre d’une image avant de la réutiliser.

Pour une image de 800 sur 600, fournissez ses données non vides et demandez la région allant de gauche 120, haut 80, droite 520 et bas 380. Récupérez ensuite les données encodées produites.

Le résultat prend la forme de données d’image recadrées encodées en base64 ; le format source est conservé s’il est disponible, sinon la sortie est en PNG.

Limites

Le traitement peut échouer si la dépendance d’image est indisponible ou si une erreur survient pendant le décodage, l’ouverture, le recadrage ou l’enregistrement.
Les limites hors image sont ajustées et une limite placée sur un bord peut entraîner une légère modification de la borne opposée pour conserver une étendue minimale.

Erreurs fréquentes

Une chaîne vide ou qui ne contient pas une image décodable fait échouer le traitement. Fournissez des données d’image non vides et vérifiez qu’elles sont correctement encodées avant de lancer le recadrage.

Questions fréquentes

Puis-je recadrer une image sans renseigner les quatre coordonnées ?

Oui, à condition de fournir des données d’image non vides que le traitement peut décoder et ouvrir. Les quatre bornes numériques définissent alors la région rectangulaire à extraire.

Les coordonnées sont-elles exprimées en pourcentage ?

Non. Les coordonnées sont appliquées comme des bornes numériques contre les dimensions de l’image décodée ; elles ne représentent pas des pourcentages.

Dans quel format l’image recadrée est-elle renvoyée ?

Le résultat est encodé en base64. Le format source est conservé lorsqu’il est disponible ; sinon, la sortie est enregistrée en PNG.