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

要 req

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者
ユーザー

リクエストタイプ。リクエストされたデータのタイプを指定します。

debug

コマンドをデバッグモードで実行します。

contents

ビネット内のオブジェクトに関する情報を返します。

img

コマンドを実行し、レンダリングイメージを返します。

imageprops

指定したビネットのプロパティを返します。

map

ビネットに埋め込まれた画像マップデータを返します。

object

コマンドを実行し、マスクされたレンダリングイメージを現在のオブジェクト選択に戻します。

props

コマンドを実行して、返信画像のプロパティを返します。

userdata

Vignette::UserData の内容返します。

詳細な説明に特に記載がない限り、サーバーは MIME タイプ <text/plain> のテキスト応答を返します。

debug

指定したコマンドを実行し、レンダリングイメージを返します。エラーが発生した場合は、エラー画像の代わりにエラーとデバッグの情報が返されます（attribute::ErrorImagePath）。

contents

選択されたオブジェクト属性を含む、ビネット内のオブジェクト階層の XML 表現を返します。リクエスト内のその他のコマンドは無視されます。

img

指定したコマンドを実行し、レンダリングイメージを返します。返信データの形式と応答のタイプは、fmt= で決定されます。

imageprops

URL パスで指定されたビネットファイルまたはカタログエントリの、選択されたプロパティを返します。返信構文と応答の MIME タイプについて詳しくは、プロパティを参照してください。リクエスト内のその他のコマンドは無視されます。次のプロパティが返されます。

プロパティ

種類

説明

image.expiration

ダブル

属性：:Expiration またはデフォルトの有効期間。

image.height

整数

解像度の高さ（ピクセル単位）。

image.iccProfile

文字列

このビネットに関連付けられたプロファイルの名前と説明。

image.embeddedIccProfile

ブール値

関連付けられたプロファイルがビネットに埋め込まれている場合は 1。

image.embedded PhotoshopPaths

ブール値

ビネットにパスデータが埋め込まれている場合は 1。

image.modifier

文字列

属性：:Modifier またはカタログエントリでない場合は空です。

image.pixTyp

列挙

レスポンスイメージのピクセルタイプ。「CMYK」、「RGB」または「BW」（グレースケール画像の場合）のいずれかです。

image.printRes

実数

デフォルトの印刷解像度（dpi）。

image.timeStamp

文字列

変更日時（カタログ：:TimeStamp またはビネットファイルより）。

image.width

整数

フル解像度の幅（ピクセル単位）。

vignette.name

文字列

ビネット名（ルートビネットオブジェクトの名前文字列）。

vignette.res

実数

マテリアルの解像度単位（通常はピクセル/インチ）表す最大オブジェクト解像度。

vignette.res.avg

実数

マテリアル解像度単位おける平均オブジェクト解像度（通常はピクセル/インチマテリアル解像度h）。

vignette.res.min

実数

マテリアルの解像度単位（通常はピクセル/インチ）おける最小オブジェクト解像度。

vignette.version

整数

ビネットファイルのバージョン番号。

map

ビネットに含まれる画像マップデータを返します。デフォルトでは、すべての一番外側のグループのマップデータが返されます。すべての最も内側のグループのマップデータは、

req=map&groupLevel=-1

マップデータは、wid=、hei=、またはその他の方法で変更されたサイズに変更されません。応答の MIME タイプは <text/xml> です。

レスポンスデータは、HTML <map> タグと同様に、<area> の要素のセットを含む <AREA> 要素で構成されます。

各 <area> 要素には、標準の type= 属性と coord= 属性、およびビネットグループ名または名前パスを指定する name= 属性が含まれます。対応するオブジェクトグループのマスクが不連続な領域を持つ場合、同じ名前の <area> 要素が複数存在します。

ビネットは、デフォルトの属性に加えて、追加の属性を定義することもできます（作成した場合）。このようなカスタム属性は、オブジェクトグループ属性として定義されます。カスタム属性の名前は、map 要素に含める <area> で始める必要があります。例えば、グループ属性に map.href=http://www.scene7.com が含まれる場合、対応する <area> 要素には href="http://www.scene7.com" が含まれます。

ビネットにマップデータが含まれていない場合、空の <map> 要素を含む XML ドキュメントが返されます。

object

指定されたコマンドを実行し、残余オブジェクトの選択（要求の最後の sel= または obj= のコマンドで選択されたグループまたはオブジェクト）によってマスクされたレンダリングイメージを返します。通常、アルファをサポートする画像形式で使用します（fmt= を参照）。アルファをサポートしていない画像形式を使用すると、マスクの外側の領域は黒になります。

props

指定されたコマンドを実行し、レンダリングされたイメージではなく、ビネットプロパティとグループまたはオブジェクトプロパティを返します。返信構文と応答の MIME タイプについて詳しくは、プロパティを参照してください。 obj= または sel= も指定されていない限り、デフォルトの選択が適用されます（obj= を参照）。

応答には、次のプロパティが含まれる場合があります。

プロパティ

種類

説明

image.bgc

文字列

返信画像の背景色。

image.height

整数

返信画像の高さ（ピクセル単位）。

image.iccEmbed

ブール値

True を指定すると、ICC プロファイルが返信画像に埋め込まれます（ iccEmbed=を参照）。

image.iccProfile

文字列

返信画像に関連付けられたプロファイルのショートカット名（ icc=を参照）。

image.mask

ブール値

返信画像にアルファ版が含まれる場合は True を指定します。

image.pathEmbed

ブール値

返信画像にパスデータが含まれる場合は、true を指定します（ pathEmbed=を参照）。

image.pixTyp

文字列

返信画像のタイプは、「CMYK」、「RGB」または「BW」（グレースケール画像の場合）にすることができます

image.printRes

実数

印刷解像度（dpi）

image.quality

整数、ブール

JPEGの画質とクロマフラグ（ qlt=を参照）

image.type

文字列

返信画像の MIME タイプ（ fmt=を参照）。

image.width

整数

返信画像の幅（ピクセル単位）。

selection.attributes

文字列

現在の選択範囲の属性文字列。

selection.count

整数

現在の選択範囲内にあるオブジェクトの数。

selection.ident

整数

現在の選択範囲のインデント値。

selection.attributes ion.name を選択してくださ。

文字列

現在のオブジェクト選択のフルネームのパス。

selection.overlapping

整数

現在選択されているオブジェクトのオーバーラップ数。

selection.renderable

整数

現在の選択範囲内にあるレンダリング可能なオブジェクトの数。

selection.texturable

整数

現在選択されているテキスト編集可能オブジェクトの数。

selection.visible

整数

現在の選択の現在の表示/非表示ステータス。

selection.zorder

整数

現在の選択範囲内の最初のオーバーラップオブジェクトの Z オーダー値。

userdata

vignette::UserData のコンテンツを返します。サーバーは、'??' 内の vignette::UserData をすべて行終端文字（<cr><lf>）で置き換えます。返信は、応答の MIME タイプを <text/plain> に設定したテキストデータ形式になります。

URL パスで指定されたオブジェクトが有効なビネットマップエントリに解決されない場合、または vignette::UserData が空の場合、返信には行終端文字（CR/LF）のみが含まれます。

リクエスト文字列内のその他のコマンドは無視されます。

プロパティ section-e44092e190ff4f6380583e8ed6ea5b0b

リクエストコマンド。リクエスト文字列のどこにでも発生する可能性があります。

初期設定 section-00c593cbf1af4364b6b78812e6b93c64

URL に画像のパスや修飾子が含まれていない場合は、次のようになります。

#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.

それ以外の場合は、req=img

要 req

プロパティ section-e44092e190ff4f6380583e8ed6ea5b0b

初期設定 section-00c593cbf1af4364b6b78812e6b93c64

関連項目 section-f7a955525fb44ef2ae7cd7ede25a96c3