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

要

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

作成対象:

  • 開発者
  • ユーザー

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

req=debug|contents|img|imageprops|map|object|props|userdata|validate

debugコマンドをデバッグモードで実行します。
contentsビネット内のオブジェクトに関する情報を返します。
imgコマンドを実行し、レンダリング イメージを返します。
imageprops指定したビネットのプロパティを返します。
mapビネットに埋め込まれた画像マップデータを返します。
objectコマンドを実行し、マスクされたレンダリング イメージを現在のオブジェクト選択に戻します。
propsコマンドを実行して、返信画像のプロパティを返します。
userdataVignette::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に似た、一連の <area> 要素を含む <map> 要素で構成され <AREA> す。

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

ビネットは、デフォルトの属性に加えて、追加の属性を定義することもできます(作成した場合)。 このようなカスタム属性は、オブジェクトグループ属性として定義されます。 カスタム属性の名前は、<area> 要素に含める map で始める必要があります。 例えば、グループ属性に 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)のみが含まれます。

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

プロパティ

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

初期設定

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

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

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

関連項目

fmt= , attribute::ErrorImagePath, vignette::UserData, Properties

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