지원되는 작업

이 섹션에는 Cloud CDN 이미지 최적화에서 지원하는 작업이 나열되어 있습니다. 표에는 imop 쿼리를 만드는 데 도움이 되는 작업, 문법, 속성, 설명, 예시와 같은 매개변수가 포함되어 있습니다.

Cloud CDN 이미지 최적화는 크기 조절, 자르기, 비율 조정과 같이 이미지를 변환할 수 있는 작업 집합을 지원합니다. 각 작업에는 고유한 문법, 지원되는 속성, 제약 조건이 있습니다.

이 페이지에는 imop 쿼리를 만드는 데 도움이 되는 예시와 함께 Cloud CDN 이미지 최적화에서 지원하는 작업이 나열되어 있습니다.

작업 문법 및 예시 속성 설명

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125
  • width 유형: 정수 (범위: 1~8192)
  • height 유형: 정수 (범위: 1~8192)

최대 width * height는 67mpx (67,108,864픽셀)를 초과할 수 없습니다.

  • 비율 조정 (선택사항) 유형: enum, 값: proportional, stretch
    		•

    이 작업은 너비 및 높이 매개변수를 모두 지정할 때 가로세로 비율을 유지하지 않습니다. 두 측정기준 중 하나를 생략하면 Cloud CDN 이미지 최적화에서 가로세로 비율을 유지하기 위해 다른 측정기준을 계산합니다.

    기본적으로 이미지 최적화는 엄격한 다운스케일 전용 전략을 적용합니다. scaling=stretch 매개변수를 지정하면 업스케일링이 사용 설정되지만 크기 매개변수를 하나만 지정하면 시스템에서 이를 허용하지 않습니다.

    Scale

    ?imop=Scale,ratio=<scale_ratio>

    https://www.example.com/image.jpg?imop=Scale,ratio=0.5

    		 ratio
    • 유형: 부동 소수점 수 (소수점 2자리로 제한됨)
    • 제약 조건: 0 < value

    이 작업은 특정 비율로 이미지의 비율을 조정하고 다운스케일링만 적용합니다. 크기 조절 및 자르기 작업과 상호 배타적입니다.

    단일 요청 내에 Resize 또는 Crop 작업과 함께 Scale 작업을 포함하면 시스템에서 오류를 반환합니다.

    Crop

    ?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

    https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

    		 shape
    • 유형: 문자열 (rectangle, circle)
    • 기본값: rectangle
    • 종속 항목: crop 매개변수와 함께 사용해야 합니다. 잘못된 값은 HTTP 400을 반환합니다.
    left, right, top, bottom
    • 유형: 부동 소수점 수
    • 범위: 0.0~1.0, 최대 소수점 3자리
    • 기본값: 0.0, 1.0, 0.0, 1.0
    snap_to_x, snap_to_y
    • 유형: 정수
    • 범위: 0 이상
    • 기본값: 0
    • 제약 조건: left, right, top, bottom 중 하나 이상을 포함해야 합니다.

    이 작업은 지역 마커를 기반으로 이미지를 자릅니다. shape 매개변수에 잘못된 값을 지정하면 시스템에서 HTTP 400 Bad Request를 반환합니다.

    자르기 좌표는 지정된 snap_to_x 또는 snap_to_y 값의 가장 가까운 배수로 자동 맞추기됩니다.

    Canvas

    ?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

    https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

    		 width, height
    • 유형: 정수
    • 범위: 1~8192
    • 최대 너비 x 높이는 67,108,864픽셀을 초과할 수 없습니다.
    gravity
    • 유형: 문자열
    • 값: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
    • 기본값: center
    background_color
    • 유형: 문자열
    • 형식: 3자리, 4자리 또는 6자리 16진수 코드
    • 기본값: 000000 (검은색)

    이 작업은 지정된 크기와 색상의 배경 레이아웃을 추가하여 이미지를 개선합니다. gravity 매개변수는 이 배경 캔버스에서 내부 이미지의 배치를 지정합니다.

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

    https://www.example.com/image.jpg?imop=Rotate,degrees=90

    		 degrees
    • 유형: 정수
    • 허용되는 값: 90, 180, 270

    이 작업은 타겟 이미지를 시계 방향으로 회전합니다.

    Mirror

    ?imop=Mirror,flip=<flip>

    https://www.example.com/image.jpg?imop=Mirror,flip=h

    		 flip
    • 유형: 문자열
    • 허용되는 값: h (가로), v (세로), hv (가로 및 세로)

    이 작업은 이미지를 가로 또는 세로로 또는 둘 다 미러링합니다.

    Compress

    ?imop=Compress,strength=<value>

    https://www.example.com/image.jpg?imop=Compress,strength=medium

    		 strength
    • 유형: 문자열
    • 허용되는 값: very_weak, weak, medium, strong, very_strong
    • 제약 조건: jpeg, avif, webp에서만 지원됩니다. 이 범위를 벗어나는 값은 HTTP 400을 반환합니다.

    이 작업은 타겟 이미지 품질을 낮춰 이미지를 압축합니다. strength 매개변수를 사용하면 활성 이미지 압축 수준을 제어할 수 있습니다.

    Convert

    ?imop=Convert,format=<format>

    https://www.example.com/image.jpg?imop=Convert,format=webp

    		 format
    • 유형: 문자열
    • 허용되는 값: jpeg, png, webp, avif, gif
    • 제약 조건: 나열되지 않은 다른 값은 처리 오류를 일으킵니다.

    이 작업은 이미지의 최종 전송 형식을 변경합니다. 브라우저의 수신 ACCEPT 헤더 사양과 처리 충돌이 있는 경우 시스템에서 HTTP 406 Not Acceptable 오류를 반환합니다.

    Metadata

    ?imop=Metadata,preserve=<preserve>

    https://www.example.com/image.jpg?imop=Metadata,preserve=none

    		 preserve
    • 유형: 문자열
    • 허용되는 값: none, copyright, max
    • 기본값: copyright

    이 작업은 실행 중에 이미지 메타데이터 속성이 처리되는 방식을 제어합니다.

    none: 모든 메타데이터 속성을 삭제합니다.

    max: 변환에 적용되는 EXIF 방향 및 색상 프로필을 제외한 모든 필드를 보존합니다.

    .

    copyright: Author, Copyright, Caption 필드만 유지합니다.

    Tone

    ?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

    https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50
    • brightness
      • 유형: 정수
      • 범위: -100~100
    • contrast
      • 유형: 정수
      • 범위: -100~100
    • saturation
      • 유형: 정수
      • 범위: -100~100

    이 작업은 이미지의 brightness, contrast, 및 saturation 수준을 동적으로 수정합니다. 특정 매개변수를 생략하거나 0으로 설정하면 시스템에서 해당 속성을 변경하지 않습니다. 채도를 -100으로 설정하면 그레이 스케일 변환이 적용됩니다.

    Sharpen

    ?imop=Sharpen,strength=<sharpness>

    https://www.example.com/image.jpg?imop=Sharpen,strength=50

    		 strength
    • 유형: 정수
    • 범위: 0~100

    이 작업은 이미지의 선명도를 높입니다.

    Blur

    ?imop=Blur,strength=<blur_size>

    https://www.example.com/image.jpg?imop=Blur,strength=50

    		 strength
    • 유형: 정수
    • 범위: 0~100

    이 작업은 이미지 전체에 로컬 흐림 필터를 적용합니다.

    Freeze

    ?imop=freeze,frame=<frame>

    https://www.example.com/image.gif?imop=freeze,frame=0

    		 frame
    • 유형: 정수
    • 범위: 0~100

    이 작업은 애니메이션 이미지 시퀀스(예: 애니메이션 GIF)에서 단일 정적 프레임을 추출합니다. frame 매개변수는 추출할 정확한 프레임 색인을 지정합니다.

    다음 단계