Recortar imagen a un recuadro

Este validador recibe el ancho y el alto de la imagen de origen, además de un recuadro definido por x, y, ancho y alto. Comprueba cada valor, confirma que todo el rectángulo permanezca dentro de la imagen y devuelve las dimensiones recortadas cuando es válido. No requiere cargar ni decodificar la imagen, por lo que resulta útil antes de llamar a un procesador gráfico, crear una vista previa o aceptar coordenadas de otro servicio.

Describa la imagen de origen y el recuadro

Comience con las dimensiones en píxeles de la imagen original. Asigne a image_width el número horizontal total de píxeles y a image_height el número vertical total. Después describa el rectángulo mediante x, y, width y height. Los valores x e y sitúan su esquina superior izquierda respecto de la esquina superior izquierda de la imagen, cuya coordenada es 0,0. Width se extiende hacia la derecha y height hacia abajo. Los seis valores deben ser enteros, porque la capacidad modela recortes de mapa de bits alineados con píxeles, no geometría fraccionaria. Las dimensiones de la imagen y del recorte deben ser positivas; x e y pueden valer cero. Por ejemplo, x igual a 240 omite las primeras 240 columnas de píxeles. El recuadro puede tocar exactamente cualquier borde. Por tanto, x más width puede ser igual a image_width, y y más height puede ser igual a image_height. Utilice medidas de la misma imagen que se recortará; las coordenadas de una vista redimensionada deben escalarse antes.

Comprenda la validación de los límites

El validador rechaza primero valores ausentes, no enteros, coordenadas negativas, recuadros sin superficie y cifras fuera del intervalo documentado. Luego comprueba las dos fronteras que determinan la contención. En horizontal, x más width debe ser menor o igual que image_width. En vertical, y más height debe ser menor o igual que image_height. Si alguna suma es mayor, parte del recorte queda fuera del original y la solicitud devuelve un error de entrada no válida. Esta regla explícita evita una confusión habitual de una unidad: un recorte de 100 píxeles de ancho que comienza en x 0 ocupa toda una extensión de 100 píxeles y cabe exactamente en una imagen de 100 píxeles. La capacidad no limita, desplaza ni reduce un recuadro incorrecto, porque modificar las coordenadas silenciosamente puede elegir otro sujeto o composición. Tampoco examina los bytes de la imagen. Su decisión depende únicamente de las medidas y coordenadas proporcionadas, por lo que es rápida, repetible y apropiada para formularios interactivos y procesos automatizados.

Use el resultado antes del recorte real

Una respuesta correcta devuelve el ancho y el alto del recorte resultante. Coinciden con el recuadro solicitado porque esta capacidad valida geometría; no remuestrea ni altera el rectángulo. Utilice la respuesta como protección antes de entregar las mismas coordenadas a una biblioteca de imágenes, un servicio multimedia o un trabajo de renderizado en cola. Así separa una validación barata de la decodificación costosa y evita que fallos previsibles alcancen procesos posteriores. En un editor, valide cuando la persona confirme la selección o después de convertir las coordenadas de la vista previa a píxeles del original. En un flujo de datos, compruebe los metadatos al recibirlos y derive los registros inválidos para corregirlos. Considere la orientación: si otro paso gira físicamente la imagen, use las dimensiones posteriores al giro y coordenadas expresadas en esa misma orientación. La solicitud API cuesta $0.002; el ejecutor del navegador realiza localmente el mismo cálculo determinista. Ninguna vía carga la imagen, pues la respuesta solo necesita geometría numérica.