설명서Dynamic Media 이미지 제공 및 렌더링 API

fmt fmt

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자
  • 사용자

응답 이미지 형식.

fmt=format[, [pixelType],[compression]]

format - 아비프-알파 | avif | eps | f4m | gif-alpha | gif | 높이 | jpeg | jpeg2000-alpha | jpeg2000 | jpegxr-alpha | jpegxr | jpg | m3u8 | pdf | pjpeg | png-alpha | png | png8-alpha | png8 | swf 알파 | swf | swf3-alpha | swf3 | tif-alpha | tif | 웹 알파 | webp

format
설명
avif-alpha
알파 채널을 사용한 손실 및 무손실 AVIF.
avif
손실 및 무손실 AVIF.
eps
압축되지 않은 바이너리 캡슐화된 PostScript.
f4m
Flash 스트리밍 서버 매니페스트 형식입니다.
gif-alpha
2~255색 및 키 색상 투명도가 포함된 GIF.
gif
2~256색 GIF.
heic
무손실 높이. 이 형식은 지원되지 않는 경우 브라우저에서 기본적으로 다운로드됩니다.
jpeg
손실 JPEG.
jpeg2000-alpha
알파 채널이 있는 손실 및 무손실 JPEG 2000.
jpeg2000
손실 및 손실 없는 JPEG 2000.
jpegxr-alpha
알파 채널이 있는 손실 및 무손실 JPEG XR.
jpegxr
손실 및 무손실 JPEG XR.
jpg
손실 JPG.
m3u8
Apple 스트리밍 서버 매니페스트 형식입니다.
pdf
이미지가 PDF에 포함되었습니다.
pjpeg
점진적 JPEG.
png-alpha
알파 채널을 사용한 24비트 무손실 PNG.
png
24비트 무손실 PNG.
png8-alpha
알파 채널이 포함된 8비트 무손실 PNG.
png8
8비트 무손실 PNG.
swf-alpha
손실 JPEG과 수축 압축된 마스크가 Adobe AS2 swf 파일에 포함되어 있습니다.
swf
Adobe AS2 swf 파일에 포함된 손실 JPEG.
swf3-alpha
손실 JPEG과 수축 압축된 마스크가 Adobe AS3 swf 파일에 포함되어 있습니다. 참고: swf 및 swf 알파 형식은 ActionScript 2 응용 프로그램(Flash Player 8 이하)에 가장 적합합니다. swf3 및 swf3-alpha 형식은 ActionScript3 응용 프로그램(Flash Player 9 이상)에 사용하는 것이 좋습니다.
swf3
Adobe AS3 swf 파일에 포함된 손실 JPEG.
tif-alpha
알파 채널을 사용하는 TIFF.
tif
TIFF.
webp-alpha
알파 채널이 있는 손실 및 무손실 WebP.
webp
손실 및 손실 없는 WebP.

pixelType - rgb | 회색 | cmyk

pixelType
설명
cmyk
CMYK 이미지 데이터를 반환합니다.
gray
회색 음영 이미지 데이터를 반환합니다.
rgb
RGB 이미지 데이터를 반환합니다.

compression - jpeg | 손실 | 무손실 | lzw | 없음 | zip

compression
설명
jpeg
JPEG 압축(손실).
lossy
JPEG 2000, JPEG XR 압축(손실) 및 WebP
lossless
HEIC, JPEG 2000, JPEG XR 압축(무손실), WebP
lzw
LZW (Lempel-Ziv-Welch) 압축(무손실).
none
압축이 해제되었습니다.
zip
"수축" 압축(무손실).

  • format ​은(는) 클라이언트로 보낸 이미지 데이터의 이미지 인코딩 형식을 지정하고 HTTP 응답 헤더의 해당 응답 MIME 형식을 지정합니다.

  • icc=이(가) 지정되지 않은 경우 pixelType ​을(를) 사용하여 출력 색상 공간 변환을 수행할 수 있습니다.

    pixelType ​에 해당하는 기본 색상 프로필이 적용됩니다. 색상 관리가 비활성화되어 있으면 순조로운 변환이 적용됩니다. 출력 픽셀 유형을 결정하는 icc=을(를) 지정하면 pixelType ​이(가) 무시됩니다.

  • compression ​은(는) tif, tif-alpha, pdf, webp, webp-alpha, jpeg2000, jpeg2000-alpha, jpegxr 또는 jpegxr-alpha이(가) format(으)로 지정된 경우에만 허용됩니다. 이러한 이미지 형식에 대해 지원되는 압축 옵션은 아래 표를 참조하십시오.

qlt=을(를) 사용하여 JPEG, JPEG 압축을 사용한 TIFF, JPEG 압축을 사용한 PDF 및 SWF 형식에 대한 JPEG 인코딩 옵션을 설정할 수 있습니다. WebP, JPEG 2000 및 JPEG XR도 qlt=을(를) 사용하지만 값이 다른 형식에 대해 다른 품질을 제공합니다. fmt=gif 또는 fmt=gif-alpha인 경우 quantize=을(를) 사용합니다. 자세한 내용은 명령 설명을 참조하십시오. 다른 형식에는 설정 가능한 옵션이 없습니다.

모든 formats 및 pixelTypes ​에 대해 픽셀 구성 요소당 8비트(GIF의 경우 픽셀당 8비트)가 반환됩니다.

다음 표에는 유효한 *format*과(와) pixelType 조합, 해당 HTTP 응답 MIME 유형, ICC 프로필을 포함할 수 있는지 여부(iccEmbed= 참조) 및 적용할 수 있는 형식별 옵션이 나열되어 있습니다.

형식
pixelType
응답 MIME 유형
ICC 프로필 포함
옵션
avif, avif-alpha
rgb
<image/avif>
아니요

압축 ( 손실 , 무손실 )

qlt= 이(가) 무손실 에 대해 무시됩니다.

WebP 형식의 색차 다운샘플링이라는 개념이 없으므로 qlt 과(와) 함께 두 번째 값을 사용하는 경우(예: qlt=80,1 ) 두 번째 값( 1 )이 무시됩니다.

eps
rgb, 회색, cmyk
<이미지/eps>
예
pathEmbed=
gif, gif-alpha

rgb, 회색

데이터는 회색 또는 rgb로 변환된 후 팔레트로 변환됩니다.

<image/gif>
아니요
quantize=
높이
rgb
<이미지/높이>
아니요
jpeg2000, jpeg2000-alpha
rgb, 회색
<image/jp2>
아니요

압축 ( 손실 , 무손실 )

qlt= 이(가) 무손실 에 대해 무시됩니다.

WebP 형식의 색차 다운샘플링이라는 개념이 없으므로 qlt 과(와) 함께 두 번째 값을 사용하는 경우(예: qlt=80,1 ) 두 번째 값( 1 )이 무시됩니다.

jpeg, jpg, pjpeg
rgb, 회색, cmyk
<image/jpeg>
예

pathEmbed= , pscan= , qlt= , xmpEmbed=

pscan= 매개 변수는 pjpeg 형식에만 적용됩니다.

jpegxr, jpegxr-alpha
rgb
<image/vnd.ms-photo>
아니요

압축 ( 손실 , 무손실 )

qlt= 이(가) 무손실 에 대해 무시됩니다.

WebP 형식의 색차 다운샘플링이라는 개념이 없으므로 qlt 과(와) 함께 두 번째 값을 사용하는 경우(예: qlt=80,1 ) 두 번째 값( 1 )이 무시됩니다.

pdf
rgb, 회색, cmyk
<application/pdf>
예

압축

( none|zip|jpeg ), qlt=

압축 이(가) jpeg (으)로 설정되지 않은 경우 qlt= 이(가) 무시됩니다.

png8, png8-alpha
rgb
<image/png>
예
png, png-alpha
rgb, 회색
<image/png>
예
swf,swf3, swf-alpha, swf-alpha3
rgb, 회색
<application/x-shockwave-flash>

아니요

참고: Adobe Flash Player은 임베드된 ICC 프로파일을 무시합니다.

qlt= , 특성::TrustedDomains
tif, tif-alpha
rgb, 회색, cmyk
<image/tiff>
예

압축

( 없음|lzw|zip|jpeg )

'tiff'만 해당. 'tiff-alpha'는 jpeg 압축을 지원하지 않습니다.

qlt=

압축 이(가) jpeg (으)로 설정되지 않은 경우 qlt= 이(가) 무시됩니다.

, pathEmbed=, xmpEmbed=

webp, webp-alpha
rgb
<image/webp>
아니요

압축 ( 손실 , 무손실 )

qlt= 이(가) 무손실 에 대해 무시됩니다.

WebP 형식의 색차 다운샘플링이라는 개념이 없으므로 qlt 과(와) 함께 두 번째 값을 사용하는 경우(예: qlt=80,1 ) 두 번째 값( 1 )이 무시됩니다.

속성 section-5f96b0ce7c5a4df1bf52e24ea78c3dae

요청 속성입니다. req=img(기본값) 또는 req=mask인 경우 현재 레이어 설정에 관계없이 적용되고, 그렇지 않은 경우에는 무시됩니다.

iccProfile=이(가) 지정된 경우 type ​이(가) 무시됩니다.

기본값 section-f885a785b32c44fea347db15fdb2ab1f

fmt=jpeg, *defaultType*,none. 여기서 defaultType ​은(는) 다음과 같이 처리됩니다. icc=이(가) 지정된 경우 defaultType ​은(는) 지정된 ICC 프로필의 픽셀 유형에 해당합니다. icc=이(가) 지정되지 않은 경우 defaultType ​은(는) req=mask인 경우 gray이고, 그렇지 않은 경우 rgb입니다.

예제 section-b93222e652df404a84c69025247f07df

JPEG 형식(기본값)으로 작고 낮은 품질의 미리 보기 이미지를 요청합니다.

http:// *서버*/myRootId/myImageId?qlt=60&wid=200

회색으로 변환된 동일한 이미지를 요청:

http:// *서버*/myRootId/myImageId?fmt=jpeg,gray&qlt=60&wid=200

동일한 이미지를 알파 채널을 사용하여 손실 없는 형식으로 높은 해상도로 요청:

http:// *서버*/myRootId/myImageId?fmt=png-alpha&wid=300

회색 음영 TIFF 이미지와 같은 이미지에 대해 알파 채널을 요청합니다.

http:// *서버*/myRootId/myImageId?req=mask&fmt=tif,gray&wid=300

기본 ICC 프로필을 사용하여 동일한 이미지를 cmyk로 변환:

http:// *서버*/myRootId/myImageId?fmt=tif,cmyk&wid=300

다른 ICC 프로필을 사용하여 동일한 이미지를 cmyk로 변환하고 TIFF 이미지에 해당 프로필을 포함합니다.

http:// *서버*/myRootId/myImageId?fmt=tif&wid=300&icc=myPrinterProfile&iccEmbed=1

픽셀 형식 변환 없이 JPEG 압축을 사용하여 이 이미지를 TIF 파일로 전달:

http:// *서버*/myRootId/myImageId?fmt=tif,,jpeg&qlt=95&wid=300

이미지를 키 색상 투명도를 사용하는 두 색조 GIF으로 변환하고 색상을 검정과 흰색으로 강제 변환:

http:// *서버*/myRootId/myImageId?fmt=gif-alpha&wid=100&quantize=adaptive,off,2,000000,ffffff

손실(품질 설정 80:)

http:// *서버*/myRootId/myImageId?wid=300&fmt=webp&qlt=80

알파 무손실:

http:// *서버*/myRootId/myImageId?wid=300&fmt=webp-alpha,,lossless

손실(품질 설정 80:)

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000&qlt=80

알파 무손실:

http://server/myRootId/myImageId?wid=300&fmt=jpeg2000-alpha,,lossless

손실(품질 설정 80:)

http://server/myRootId/myImageId?wid=300&fmt=jpegxr&qlt=80

알파 무손실:

http://server/myRootId/myImageId?wid=300&fmt=jpegxr-alpha,,lossless

참조 section-fce8d69c74234bf48cf814d799409541

qlt= , quantize=, req=, icc=, iccEmbed=, pathEmbed=, pscan.

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49