최신 업데이트:2023-10-17 18:18:09
1 VAS 소개
1.1 개요
CDN 아키텍처에 통합된 이미지 처리 서비스는 포맷 전환, 잘라내기, 축소, 회전, 워터마크 등을 포함하는 이미지 처리 솔루션을 제공합니다. 이 서비스는 고객이 이미지 처리 시간을 절약하고 오리진에 돌아가는 요청 비율을 줄일 수 있습니다. 이외에도 인근한 CDN network를 통해 신뢰성이 높은 적응성 콘텐츠를 수출함으로써 페이지 접근 속도를 높일 수 있습니다.
1.2 해당 제품 라인
1.3 애플리케이션 시나리오
참고: 일부 이미지 관련 서비스는 URL 재작성을 통해 사용자 정의할 수 있습니다. 예를 들어 한 CDNetworks고객이 다른 CDN 공급상의 이미지 최적 기능을 사용하고 있는데 CDNetworks와 다른 매개 변수를 가지고 있습니다. 이 때 CDNetworks는 사용 작업을 변경하지 않고 기본적으로 고객 URL을 다시 정의할 수 있습니다. 상세한 내용은 CDNetworks CSE에 문의하십시오.
2 VAS 상세 정보
이미지 처리 서비스에는 압축, 잘라내기, 축소, 회전, 형식 전환, 그레이 스케일 축소, 워터 마크, 이미지 정보 수집 등이 포함됩니다. 여러 기능에 해당하는 대부분 운행 매개 변수를 동시에 활성화하는 것을 지원합니다. 예를 들어 파일 정보 가져오는 매개 변수는 별도의 단계를 통해 적용됩니다.
이미지 처리는 이미지 요청 URL의 매개 변수를 기반으로 이미지 처리 서버에서 수행됩니다. URL의 매개 변수 형식은 고정되어 있으며 두 단계로 나눌 수 있습니다. 첫번째, "&"은 구분자이고 "="는 대입 값이며 키워드는 {q, Q, crop, resize, r, o, f, g, watermark, info}입니다. 두번째, ","는 구분자이고 "_"는 대입 값이며 키워드는 {p, w, h, x, y, a, g, s, e, t, r, s, image, text, d, front, color, size, bc, bs}입니다. 이미지 처리 요청을 처리할 때 매개 변수 중에 키워드는 이미지 처리 매개 변수로 간주됩니다. 여러 매개 변수의 조합을 통해 복잡한 이미지 처리를 실현하여 다양한 시나리오의 각종 사용자 요구를 충족할 수 있습니다.
2.1 이미지 축소
절대 품질 | 오리진 이미지를 q로 축소합니다. 오리진 이미지 화질이 90%이고 q=80이면 80% 화질의 신규 이미지가 생성됩니다. |
상대 품질 | Q로 오리진 이미지를 축소합니다. 오리진 이미지 화질이 90%이고 Q=80이면 72% 화질의 신규 이미지가 생성됩니다. |
2.2 이미지 잘라내기
첫번째 매개 변수 | 두번째 매개 변수 | 매개 변수 값 | 작업 설명 | 값 범위 |
crop= | p_ | 0 | 고정점 포인트 잘라내기 오리진 이미지의 왼쪽 상단에 고정점 포인트 좌표(x, y)를 설정하고 지정된 너비와 높이(w,h)로 이미지를 잘라냅니다. 지정한 높이(혹은 너비)가 0이거나 시작점부터 너비(혹은 높이)가 오리진 이미지를 초과하면 오리진 이미지 끝까지 잘라냅니다. 시작점이 오리진 이미지를 초과하면 오리진 이미지를 반환합니다. 예: 죄표 x_50, y_50에서 시작하고 400*200 이미지를 잘라냅니다 http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_0, x_50,y_50,w_400,h_200 | w,h 값 범위:[0, +∞) |
1 | 중심 잘라내기 오리진 이미지의 중심을 이미지 중심으로 지정된 픽셀(w,h)의 너비 및 높이의 이미지를 잘라냅니다. w 또는 h가 올바르지 않으면 오리진 이미지로 돌아갑니다. 예: 오리진 이미지의 중심을 잘라내기 중심으로 400*200의 이미지를 잘라냅니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_1,w_400,h_200 참고: 해당 이전 매개 변수, p=4 | w,h 값≥0 | ||
2 | 무게 중심 잘라내기 매개 변수 g를 사용하여nine-rectangle-grid의 위치를 설정하고 x와 y를 오프셋한 후 지정된 픽셀(w,h)의 너비와 높이의 이미지를 잘라냅니다. w 또는 h가 올바르지 않으면 오리진 이미지로 돌아갑니다. 예: 동남쪽으로 시작하여 400*200 이미지를 잘라냅니다 http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_2,w_400,h_200,g_se | x,y 값≥0, 기본값 0; w,h 값≥0; g 값 범위: [nw,north,ne,west,center,east,sw,south,se]. | ||
3 | 지수 잘라내기 오리진 이미지의 x축(y축)을 지정된 길이로 잘라낸 후 특수화 지수 구역 내의 이미지를 가져옵니다. 길이 범위는 [1, 잘라낸 면의 길이]입니다. 입력 길이가 잘라낸 길이를 초과하면 오리진 이미지로 돌아갑니다. 이 규칙은 지수 크롭에도 적용됩니다. 즉 입력 지수가 최대값을 초과할 경우. 예: y축의 길이가 100이고 특수화 지수 구역이 2인 구역을 잘라냅니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_2,i_2,y_100 | x,y 값≥0, 기본값 0; w,h 값≥0; i 값≥0, 기본값 0. | ||
4 | 내접원 오리진 이미지를 원형으로 표시합니다 최종 이미지 형식이 png, webp 또는 투명도를 지원하는 다른 형식(알파 채널이라고도 함)일 경우 원형 아닌 구역에 투명도로 채웁니다. 최종 이미지 형식이 jpg일 경우 원형이 아닌 구역에 흰색으로 채웁니다. 값 범위: r 값이 0보다 크면 내접원과 배율을 동시에 적용할 수 있습니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_4,r_200 | r 값≥0 | ||
6 | 사각형 확대 잘라내기 매개 변수 s가 1이면 오리진 이미지의 짧은 변을 정사각형으로 잘라냅니다. 매개 변수 e와 s가 1이면 오리진 이미지의 긴 쪽을 이용하여 사각형을 확대합니다. 예: 정사각형을 확대하면 오리진 이미지의 긴 변이 정사각형이 됩니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_6,s_1,e_1 | s 값 범위0-1,기본값 없음; e 값 범위 0-1, 기본값 없음. | ||
7 | 확대 잘라내기 (t값: 1) 요청한 너비와 높이가 오리진 이미지보다 클 경우 오리진 이미지를 중심으로 주변을 흰색으로 채웁니다. 요청한 너비와 높이가 오리진 이미지보다 작을 경우 오리진 이미지를 중심으로 주변을 잘라냅니다. 요청한 너비가 오리진 이미지보다 크고 높이가 작을 경우 이미지를 중심으로 잘라내고 좌우 양쪽을 흰색으로 채웁니다. 요청한 너비가 오리진 이미지보다 작고 높이가 클 경우 이미지를 중심으로 잘라내고 위 아래쪽을 흰색으로 채웁니다. 예: 오리진 이미지 크기는 640x354이고 요청한 크기는 700x500일 때 오리진 이미지를 중심으로 잘라내고 주변을 흰색으로 채웁니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_7,w_700,h_500 | | ||
| 9 | 비율 잘라내기 w, h: 섬네일의 너비와 높이는 각각 w%W와 h%H이고 값 범위는 [1, 1000]입니다. w와 h가 지정되면 픽셀 단위의 너비와 높이(w%W, h%H)의 이미지를 오리진 이미지의 시작점에서 잘라냅니다. w가 지정되면 픽셀 단위의 너비와 높이(w%W, w%H)의 이미지를 오리진 이미지의 시작점에서 잘자냅니다. h가 지정되면 픽셀 단위의 너비와 높이(h%W, h%H)의 이미지를 오리진 이미지의 시작점에서 잘라냅니다. x,y: 시작 고정점 좌표입니다; x,y를 지정하면 고정점 좌표는 (x,y)입니다; X를 지정하면 고정점 좌표는 (x, (H-h)/2)입니다; Y를 지정하면 고정점 좌표는 ((W-w)/2, y)입니다; 참고: w와 h는 백분율로 계산된 후 픽셀 단위의 너비 및 높이입니다; 예: 오리진 이미지의50% 너비, 70% 높이인 이미지를 잘라냅니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?crop=p_9,w_50,h_70 | w,h 값 범위 [1, 1000]; x,y 값 범위 [0, +∞). | |
| 10 | 배율 조정 후 무게 중심 잘라내기 오리진 이미지를 축소하고 조정한 후에 이미지 너비와 높이가 w*h와 같거나 큽니다. 지정된 g로 잘라내면 w*h의 축소 이미지가 될 수 있습니다. w 또는 h가 오리진 이미지의 값보다 클 경우 오리진 이미지의 해당 값을 채택합니다. w 또는 h가 0일 때 다른 쪽과 배율로 조정합니다; 예: 오리진 이미지는 300x70의 비율로 조정하고 중력 중심의 위쪽 부분을 채택합니다. | w,h 동시 0일 수 없음; w,h 값 [0, +∞) | |
x,y | x-coordinate value, y-coordinate value | | | |
w,h | Width, height value | | | |
g | [nw,north,ne,west,center,east,sw,south,se] | 매개변수 g를 사용하여nine-rectangle-grid의 위치를 설정합니다. | 기본값 se | |
i | Specify index block | 지정된 길이로 잘라낸 후 인덱스를 지정합니다 | 기본값 0 | |
s,e | 0 or 1 | 지정된 방법으로 잘라냅니다. | | |
t | 0 or 1 | 지정된 방법으로 잘라냅니다. | |
2.3 이미지 배율 조정
첫번째 매개 변수 | 두번째 매개 변수 | 매개 변수 값 | 작업 설명 | 값 범위 |
resize= | p_ | 0 | 강제 스트레칭 w*h 픽셀에 따라 오리진 이미지를 스트레칭합니다. w*h 값이 없을 경우 오리진 이미지의 값을 사용합니다. w와 h의 매개 변수가 동시 존재해야 합니다. 그렇지 않을 경우 오리진 이미지로 반환됩니다. 예: 오리진 이미지 스트레칭, 너비 및 높이의 픽셀 단위는 500*200입니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?resize=p_0,w_500,h_200 참고: 해당 이전 매개 변수 p=0 | w,h 값 범위 [1-10000] |
1 | 배율 조정 오리진 이미지의 너비 및 높이를 배율로 조정합니다. 예: 너비는 오리진의 50%로, 높이는 오리진의 50%로 축소합니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?resize=p_1,w_50,h_50; 참고: 해당 이전 매개 변수p=5 | w,h 값 범위 [1-1000] | ||
2 | 배율 조정 후 채우기 w와 h를 설정하고 오리진 이미지를 배율로 조정합니다. 너비와 높이가 w*h를 초과하면 안 됩니다. 조정된 이미지를 가운데로 놓고 공백 부분을 색상으로 채웁니다. w 또는 h가 무효하면 오리진 이미지로 반환됩니다. 예: 오리진 이미지를 200*200으로 축소하고 공백 부분을 흰색으로 채웁니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?resize=p_2,w_200,h_200; | w,h 값 범위 [1-10000]; 색상 지원 16진수, 기본값 #ffffff(white) | ||
3 | 배율 조정 후 잘라내기 1) w 및 h를 지정합니다: 배율로 축소한 후 w*h를 초과하는 부분을 잘라냅니다. 처리된 이미지는 w*h입니다. 2) w만 지정합니다: w가 너비와 높이보다 작으면 먼저 축소한 후 잘라내고 처리된 이미지는 w*w입니다; w가 너비보다 작고 높이보다 크면 이미지를 잘라내고 처리된 이미지는 w*높이입니다; w가 너비보다 크고 높이보다 작으면 이미지를 잘라내고 처리된 이미지는 너비*w입니다; w가 너비와 높이보다 크면 오리진 이미지로 반환됩니다. 3) h만 지정합니다: h가 너비와 높이보다 작으면 먼저 축소한 후 잘라내고 처리된 이미지는 h*h입니다; h가 너비보다 작고 높이보다 크면 이미지를 잘라내고 처리된 이미지는 h*높이입니다; h가 너비보다 크고 높이보다 작으면 이미지를 잘라내고 처리된 이미지는 너비*h입니다; h가 너비와 높이보다 크면 오리진 이미지로 반환합니다. 예: 오리진 이미지를 축소하고 처리된 이미지 크기는 300*200입니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?resize=p_3,w_300,h_200; 참고: 해당 이전 매개 변수p=1 | w,h 값 범위 [1-10000] | ||
4 | 배율로 축소하고 너비와 높이가 w*h를 초과하지 않아야 합니다. 1) w와 h를 지정합니다: 너비는 w이고 높이는 배율로 축소합니다. 높이는 h이고 너비는 배율로 축소합니다. 너비와 높이는 w*h를 초과하지 않아야 합니다. 2) w만 지정합니다: w는 너비이고 높이는 배율로 축소합니다. 3) h만 지정합니다: h는 높이이고 너비는 배율로 축소합니다. 참고: 해당 이전 매개 변수 p=2 | w,h 값 범위 [1-10000] | ||
5 | 배율로 축소하고 너비와 높이가 w*h보다 작으면 안 됩니다. 1) w와 h를 지정합니다: 너비는 w이고 너비는 배율로 축소합니다; 높이는 h이고 높이는 배율로 축소합니다. 올바른 결과는 너비와 높이가 w*h보다 작지 않아야 합니다. 2) w만 지정합니다: 너비가 w일 경우 높이를 배율로 축소합니다. 3) h만 지정합니다: 높이가 h일 경우 너비를 배율로 축소합니다. Note: 해당 이전 매개 변수p=3 | w,h 값 범위 [1-10000] | ||
6 | 배율로 확대합니다. w와 h가 모두 오리진 이미지보다 작으면 너비와 높이는 w*h를 초과하면 안 됩니다. 1) 오리진 이미지의 너비가 지정된 w보다 작고 오리진 이미지의 높이가 지정된 h보다 크면 오리진 이미지로 반환합니다. 2) 오리진 이미지의 너비가 지정된 w보다 크고 오리진 이미지의 높이가 지정된 h보다 작으면 오리진 이미지로 반환합니다. 3) 오리진 이미지의 너비가 지정된 w보다 크고 오리진 이미지의 높이가 지정된 h보다 크면 주어진 w, h에 따라 이미지의 크기를 배율로 조정합니다. 그리고 w, h를 초과하지 않는 값만 사용합니다. 참고: 해당 이전 매개 변수p=8 | w,h 값 범위 [1-10000] | ||
7 | 배율로 조정합니다. 픽셀이 지정된 값을 초과하면 안 됩니다. 오리진 이미지는 배율로 조정하고 너비*높이의 값이 지정된 구역의 픽셀 값을 초과하지 않아야 합니다. 예: 10000을 픽셀 값으로 지정하고 이미지를 배율로 조정합니다. http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?resize=p_7,a_10000 또는: http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?resize=a_10000; 참고: 이전 매개 변수, a | a 값 범위 [1-24999999] | ||
| 8 | 너비 및 높이 제한 요청한 이미지가 일정 너비와 높이보다 크면 배율로 조정합니다. 섬네일의 너비와 높이는 지정된 너비와 높이보다 작거나 같아야 합니다. 그렇지 않으면 아무 처리가 되지 않습니다. w와 h가 지정되면 오리진의 너비와 높이가 지정된 값보다 작으면 처리가 되지 않습니다. 그렇지 않으면 배율로 축소되고 섬네일의 너비와 높이가 작거나 w*h와 같습니다. w가 지정되고 오리진의 너비가 지정된 값보다 작으면 처리가 되지 않고 그렇지 않으면 w에 따라 배율로 축소합니다. h가 지정되고 오리진의 높이가 지정된 값보다 작으면 처리가 되지 않고 그렇지 않으면 h에 따라 배율로 축소합니다; | w,h 값 범위 [1-10000] | |
w,h | Width, height | 값 범위가 0,2,3,4,5일 경우 w와 h는 섬네일 이미지의 너비와 높이를 지정합니다 | | |
color | Color code | 색상 코드는 #로 시작하는 16진수 값만 지원합니다. | 기본값 #ffffff(white) | |
a | Width*height | p의 값 범위가 7일 경우 이미지를 배율로 조정하고 너비*높이의 픽셀은 지정된 픽셀 a를 초과하지 않아야 합니다. | A 값 범위 [1-24999999] |
2.4 이미지 회전
2.5 이미지 자동 회전
2.6 이미지 형식 전환
2.7 이미지 그레이 조정
개요
이미지 색상을 제거하고 그레이 스케일만 남겨 둡니다.
매개 변수
매개 변수: g
값 범위: 0, 1
기본값: 0
예시
http://images.demo.cdnetworks.com/ctuU-fxriqqx2975432.jpg?g=1
2.8 이미지 워터 마크
개요
이미지 워터마크, 텍스트 워터마크 및 조합 워터마크를 지원합니다
첫번째 매개 변수 | 두번째 매개변수 | 매개 변수 값 및 작업 설명 |
watermark= | m_ | 워터마크 처리 모드 0: 워터마크 없음, 기본값; 1.이미지 워터마크; 2. 텍스트 워터마크; 3. 조합 워터마크, 텍스트 아래의 이미지; 4. 조합 워터마크, 이미지 아래의 텍스트; |
image_ | Base64 인코딩, 워터마크 이미지의 사전 처리를 지원합니다 | |
text_ | Base64 인코딩 | |
d_ | 워터마크 투명도, 값 범위: 0-100 | |
g_ | 워터마크 위치, 값 범위: [nw,north,ne,west,center,east,sw,south,se] | |
dx_ | X-axis의 오프셋, 값 범위 [1,+∞), 기본값 10, 단위: pixel | |
dy_ | Y-axis의 오프셋, 값 범위 [1,+∞),기본값 10, 단위: pixel | |
font_ | 워터마크 텍스트의 글꼴, base64 인코딩 | |
color_ | 워터마크 텍스트의 색상, 기본값은 흰색입니다. 추가 옵션:”파란색”, “#0000ff”, “rgb (0,0,255)”, base 64 인코딩 | |
size_ | 텍스트 워터마크의 글꼴 크기, 값 범위 (0,1000], 기본값 30 | |
r_ | 텍스트 워터마크의 회전, 값 범위 [0,360], 기본값 0 | |
bc_ | 워터마크 텍스트의 윤곽 색상, base64 인코딩 | |
bs_ | 워터마크 텍스트의 윤곽 두께, 값 범위 (0, 50), 기본값 1, 권장값 0.5-2 |
2.8 이미지 정보 가져오기
2.9 이미지 광도 및 대비
2.10 퍼지 처리
두번째 매개 변수 | 설명 | 값 |
---|---|---|
r | 가우시안 블러 반지름 | 값 범위 1-50 |
s | 가우시안 분포의 표준 편차 | 값 범위 1-50 |
2.11 배경색
2.12 보간
3 주요 장점