Snapkit Logo

영역 및 출력 파라미터#

이미지에서 특정 영역을 추출하고 최적의 결과를 위해 출력 포맷과 품질을 제어하세요.

영역 추출 (Extract)#

설명#

다른 변환이 적용되기 전에 이미지에서 특정 영역을 추출합니다.

형식#

extract:x-y-width-height

값 유형#

  • 0-100: 원본 이미지 크기의 백분율
  • >100: 픽셀 값

사용법#

백분율 기반 (권장)#

중앙 50% 영역 추출:

?transform=extract:25-25-50-50

좌상단 25% 영역 추출:

?transform=extract:0-0-25-25

픽셀 기반#

(100, 100)부터 400x300 영역 추출:

?transform=extract:100-100-400-300

예시#

중앙 50% 추출:

원본 이미지
Original
중앙 50% 추출
Extracted

중요 사항#

  • x와 y는 0 이상이어야 함
  • width와 height는 양수여야 함
  • 최대 출력 크기: 16384 x 16384 픽셀
  • 추출은 크기 조정 이전에 발생

포맷 (Format)#

설명#

변환된 이미지의 출력 포맷을 지정합니다.

지원 포맷#

포맷압축투명도애니메이션사용 사례
jpeg / jpg손실❌❌사진, 풍경
png무손실✅❌로고, 그래픽
webp둘 다✅✅웹 최적화
avif둘 다✅❌최고 압축
gif무손실✅✅간단한 애니메이션
auto적응형✅❌브라우저 기반 (권장)
animated-webp손실✅✅GIF 대체

자동 포맷 (Auto Format) - 권장#

auto 포맷은 브라우저의 Accept 헤더를 기반으로 최적 포맷을 자동 선택합니다:

?transform=format:auto

선택 로직:

  • AVIF 지원 브라우저 → AVIF
  • WebP 지원 브라우저 → WebP
  • 레거시 브라우저 → JPEG/PNG

사용 예시#

사진: ?transform=format:jpeg,quality:85

로고 (투명): ?transform=format:png

웹 최적화: ?transform=format:webp,quality:85

최고 압축: ?transform=format:avif,quality:90

품질 (Quality)#

설명#

손실 압축 포맷(JPEG, WebP, AVIF)의 품질 수준을 설정합니다.

범위#

  • 1 ~ 100
  • 높은 값 = 더 나은 품질, 더 큰 파일 크기

기본값#

포맷기본 품질
JPEG85
WebP85
AVIF80

사용법#

?transform=quality:90

품질 가이드라인#

품질 범위사용 사례파일 크기시각적 품질
60-70썸네일, 미리보기작음허용 가능
75-85웹 표준 (권장)중간우수
90-95고품질 이미지큼완벽에 가까움
95-100전문 작업매우 큼원본 품질

참고#

대부분의 웹 사용 사례에서 quality:85는 파일 크기와 시각적 품질 사이의 훌륭한 균형을 제공합니다.

파라미터 조합#

추출 + 크기 조정 + 포맷#

?transform=extract:25-25-50-50,w:400,format:webp,quality:85

여러 변환#

?transform=extract:10-10-80-80,w:800,h:600,fit:cover,format:avif,quality:90

일반적인 사용 사례#

피사체에 초점#

중앙 영역 추출 및 최적화:

?transform=extract:20-20-60-60,w:600,format:webp

자르기 및 다운로드#

다운로드할 특정 영역 추출:

?transform=extract:100-100-400-300,format:png,dl:cropped-image

고품질 내보내기#

전문 작업용 최대 품질:

?transform=w:2000,format:png,quality:100

다음 단계#