Transformaciones de imagen

Fóir redimensiona y convierte tus imágenes. Un campo de imagen devuelve una URL para cada tamaño con nombre en el formato que pidas, y la imagen detrás de una URL se produce la primera vez que se solicita.

Ocho tamaños con nombre

Los tamaños son preajustes, nombrados por el ancho en píxeles del lado largo de la imagen: thumbnail (160), small (640), medium (1024), large (1280), xlarge (1920) y tres niveles mayores de 2560, 3840 y 5120. Un original más pequeño que un nivel no se amplía para ajustarse a él, y cada variante informa del ancho y el alto con que se renderizó.

Cuatro formatos

WebP es el predeterminado, y AVIF, JPEG y PNG están disponibles. Eliges uno en la consulta con variants(format:). El formato forma parte de la URL y no se negocia a partir de la cabecera Accept del navegador, así que cada URL tiene una sola representación. El cliente de datos también pone conjuntos WebP y AVIF en el valor de la imagen, y una lectura puede rellenar un elemento picture.

Renderizada en la primera solicitud

La API entrega una URL para cada tamaño y formato. La imagen se produce cuando su URL se solicita por primera vez y después se sirve desde la caché de la CDN. Las instrucciones viajan en un token que emite Fóir, así que los parámetros de ancho y formato añadidos a mano a una URL no se respetan, y una consulta que Fóir no reconoce devuelve la imagen original.

Recortes y puntos focales

Un recorte es un rectángulo en porcentajes con un punto focal opcional, almacenado con la imagen donde se usa. Un archivo de la biblioteca de recursos puede recortarse de forma distinta en cada lugar donde aparece.

Marcadores de posición

Al subir, Fóir calcula un blurhash y un color dominante para cada imagen. Un campo de imagen devuelve ambos con la URL, las dimensiones y el texto alternativo.

Lee el detalle

La referencia de la API de medios lista los preajustes, las opciones de formato, los campos de recorte y la forma que devuelve un campo de imagen.