ドキュメントDynamic Media画像サービングおよび画像レンダリング API

fmt

最終更新日: 2024年7月31日
  • トピック:

作成対象:

  • 開発者
  • ユーザー

応答画像の形式。

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

format - avif-α | avif | eps | f4m | gif アルファ | gif | ハイク | jpeg | jpeg2000 アルファ | jpeg2000 | jpegxr-alpha | jpegxr | jpg | m3u8 | pdf | pjpeg | png-alpha | png | png8 アルファ | png8 | swf-alpha | swf | swf3-α | swf3 | tif アルファ | tif | web アルファ | webp

format説明
avif-alphaアルファチャンネル付きの非可逆および非可逆 AVIF。
avif非可逆および非可逆 AVIF。
eps非圧縮バイナリでカプセル化されたPostScript。
f4mFlashストリーミングサーバーマニフェスト形式。
gif-alpha2~255 色のGIFとキーカラーの透明度。
gif2~256 色のGIF。
heic可逆ハイク。 この形式がサポートされていない場合、デフォルトでブラウザーからダウンロードされます。
jpeg非可逆JPEG。
jpeg2000-alphaアルファチャンネル付き非可逆JPEG2000。
jpeg2000非可逆および非可逆JPEG2000。
jpegxr-alphaアルファチャンネル付きの非可逆および非可逆JPEGXR。
jpegxr非可逆および非可逆JPEGXR。
jpg非可逆JPG。
m3u8Apple Streaming Server マニフェスト形式。
pdfPDFに埋め込まれた画像。
pjpegプログレッシブJPEG。
png-alphaアルファチャンネル付き 24 ビットの可逆圧縮 PNG
png24 ビットロスレス PNG。
png8-alphaアルファチャンネル付き 8 ビットの可逆圧縮 PNG
png88 ビットロスレス PNG
swf-alpha非可逆JPEGおよび圧縮されたマスクをAdobeの AS2 swf ファイルに埋め込みます。
swfAdobe AS2 swf ファイルに埋め込まれた非可逆JPEG。
swf3-alpha非可逆JPEGおよび圧縮されたマスクをAdobeの AS3 swf ファイルに埋め込みます。 メモ: swf および swf-alpha 形式は、ActionScript 2 (Flash Player 8 以前)で最も適しています。 swf3 および swf3-alpha のフォーマットは、ActionScript3 のアプリケーション(Flash Player 9 以降)で使用することをお勧めします。
swf3Adobe AS3 swf ファイルに埋め込まれた非可逆JPEG。
tif-alphaアルファチャンネルのTIFF。
tifTIFF。
webp-alphaアルファチャンネル付きの可逆および可逆性 WebP。
webp非可逆および非可逆 WebP

pixelType - rgb |灰色 | cmyk

pixelType説明
cmykCMYK 画像データを返します。
grayグレースケールの画像データを返します。
rgbRGBの画像データを返します。

compression - jpeg |非可逆 |可逆 | lzw |なし |郵便番号

compression説明
jpegJPEG圧縮(非可逆)。
lossyJPEG 2000、JPEG XR 圧縮(非可逆)、および WebP
losslessHEIC、JPEG 2000、およびJPEG XR compression (ロスレス)、および WebP
lzwLZW (Lempel-Ziv-Welch)圧縮(ロスレス)
none非圧縮。
zip「圧縮を圧縮する」(可逆圧縮)
  • クライアント format 送信する画像データの画像エンコーディング形式と、HTTP 応答ヘッダーに対応する応答 MIME タイプを指定します。

  • pixelType は、icc= が指定されていない場合に出力カラースペース変換を行うために使用できます。

    pixelType に対応するデフォルトのカラープロファイルが適用されます。 カラーマネジメントが無効の場合、ネイティブ変換が適用されます。 icc= が指定されている場合、pixelType は無視されます。これにより出力ピクセルのタイプが決まります。

  • compression は、tif、tif-alpha、pdf、webp、webp-alpha、jpeg2000、jpeg2000-alpha、jpegxr または jpegxr-alpha が format として指定されている場合にのみ許可されます。 これらの画像形式でサポートされる圧縮オプションについては、次の表を参照してください。

qlt= を使用して、JPEG、JPEG圧縮によるPDF、JPEG圧縮によるTIFF、SWFなどのJPEGエンコーディングオプションを設定できます。 WebP、JPEG 2000、およびJPEG XR でも qlt= を使用しますが、値によってフォーマットが異なります。 fmt=gif または fmt=gif-alpha の場合は quantize= を使用します。 詳細は、コマンドの説明を参照してください。 その他の形式には、設定可能なオプションはありません。

すべての formats および pixelTypes に対して、1 ピクセルあたり 8 ビットのコンポーネントが返されます(GIFの場合は 1 ピクセルあたり 8 ビット)。

次の表に、*format*と pixelType の有効な組み合わせ、対応する HTTP 応答の MIME タイプ、ICC プロファイルを埋め込むことができるかどうか(iccEmbed= を参照)、適用できる形式固有のオプションを示します。

形式
pixelType
応答 MIME タイプ
ICC プロファイルの埋め込み
Options
avif、avif-α
rgb
<image/avif>
いいえ

圧縮 ( 非可逆 、 非可逆 )

qlt= は、 の可逆 では無視されます。

WebP 形式ではクロミナンスのダウンサンプリングの概念がないため、2 番目の値を qlt で使用する場合(例: qlt=80,1 )、2 番目の値( 1 )は無視されます。

eps
rgb, グレー,cmyk
<image/eps>
はい
pathEmbed=
gif, gif アルファ

rgb、グレー

データは、グレーまたは rgb に変換された後、パレットに変換されます。

<image/gif>
いいえ
quantize=
ヒック
rgb
<image/heic>
いいえ
jpeg2000、jpeg2000 アルファ
rgb、グレー
<image/jp2>
いいえ

圧縮 ( 非可逆 、 非可逆 )

qlt= は、 の可逆 では無視されます。

WebP 形式ではクロミナンスのダウンサンプリングの概念がないため、2 番目の値を qlt で使用する場合(例: qlt=80,1 )、2 番目の値( 1 )は無視されます。

jpeg, jpg, pjpeg
rgb, グレー,cmyk
<image/jpeg>
はい

pathEmbed= 、 pscan= 、 qlt= 、 xmpEmbed=

pscan= パラメーターは、pjpeg 形式にのみ適用されます。

jpegxr、jpegxr-alpha
rgb
<image/vnd.ms-photo>
いいえ

圧縮 ( 非可逆 、 非可逆 )

qlt= は、 の可逆 では無視されます。

WebP 形式ではクロミナンスのダウンサンプリングの概念がないため、2 番目の値を qlt で使用する場合(例: qlt=80,1 )、2 番目の値( 1 )は無視されます。

PDF
rgb, グレー,cmyk
<application/pdf>
はい

圧縮

( none|zip|jpeg )、 qlt=

qlt= は、 圧縮 が jpeg 設定されていない限り、無視 れます。

png8, png8-alpha
rgb
<image/png>
はい
png, png-alpha
rgb、グレー
<image/png>
はい
swf,swf3, swf-alpha, swf-alpha3
rgb、グレー
<application/x-shockwave-flash>

いいえ

注記:AdobeFlash Playerでは、埋め込まれた ICC プロファイルは無視されます。

qlt= 、 属性::TrustedDomains
tif、tif-alpha
rgb, グレー,cmyk
<image/tiff>
はい

圧縮

( none|lzw|zip|jpeg )

「tiff」のみ。「tiff-alpha」は jpeg 圧縮をサポートしません。

qlt=

qlt= は、圧縮 が jpeg 設定されていない限り無視 れます。

, pathEmbed=, xmpEmbed=

webp、webp-alpha
rgb
<image/webp>
いいえ

圧縮 ( 非可逆 、 非可逆 )

qlt= は、 の可逆 では無視されます。

WebP 形式ではクロミナンスのダウンサンプリングの概念がないため、2 番目の値を qlt で使用する場合(例: qlt=80,1 )、2 番目の値( 1 )は無視されます。

プロパティ

リクエスト属性。 req=img (デフォルト)または req=mask の場合は、現在のレイヤー設定に関係なく適用されます。それ以外の場合は無視されます。

iccProfile= が指定されている場合、type は無視されます。

初期設定

fmt=jpeg, *defaultType*,none、defaultType は次のように処理されます。icc= が指定されている場合、defaultType は指定された ICC プロファイルのピクセルタイプに対応します。 icc= が指定されていない場合、defaultType は req=mask の場合は gray、それ以外の場合は rgb です。

例

小さい低画質のプレビュー画像を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

関連項目

qlt=、quantize=、req=、icc=、iccEmbed=、pathEmbed=、pscan。

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