이미지 변환
Fóir는 이미지의 크기를 조정하고 형식을 변환합니다. 이미지 필드는 요청한 형식으로 이름 붙은 각 크기의 URL을 반환하며, URL 뒤의 이미지는 처음 요청될 때 만들어집니다.
이름 붙은 여덟 가지 크기
크기는 이미지 긴 변의 너비(픽셀)로 이름 붙인 프리셋입니다. thumbnail(160), small(640), medium(1024), large(1280), xlarge(1920)와 2560, 3840, 5120의 더 큰 세 단계가 있습니다. 원본이 단계보다 작으면 그 크기에 맞춰 확대하지 않으며, 각 변형은 렌더링된 너비와 높이를 보고합니다.
네 가지 형식
기본값은 WebP이며 AVIF, JPEG, PNG를 사용할 수 있습니다. 형식은 쿼리에서 variants(format:)로 선택합니다. 형식은 URL의 일부이며 브라우저의 Accept 헤더로 협상되지 않으므로 URL마다 표현이 하나입니다. 데이터 클라이언트는 이미지 값에 WebP와 AVIF 세트도 담아, 한 번의 읽기로 picture 요소를 채울 수 있습니다.
첫 요청에서 렌더링
API는 크기와 형식마다 URL을 제공합니다. 이미지는 URL이 처음 요청될 때 만들어지고 이후에는 CDN 캐시에서 제공됩니다. 지시 사항은 Fóir가 발급한 토큰에 담겨 있으므로, URL에 직접 추가한 너비나 형식 매개변수는 적용되지 않으며, Fóir가 인식하지 못하는 쿼리는 원본 이미지를 반환합니다.
크롭과 초점
크롭은 퍼센트로 표시한 사각형이며 선택적으로 초점을 가지고, 이미지가 사용되는 곳에 함께 저장됩니다. 에셋 라이브러리의 파일 하나는 나타나는 곳마다 다르게 크롭할 수 있습니다.
플레이스홀더
업로드할 때 Fóir는 각 이미지의 blurhash와 대표 색상을 계산합니다. 이미지 필드는 URL, 크기, 대체 텍스트와 함께 이 둘을 반환합니다.
자세한 내용
미디어 API 레퍼런스는 프리셋, 형식 옵션, 크롭 필드, 이미지 필드가 반환하는 형태를 나열합니다.