文件Dynamic Media影像提供與轉譯API

需要 req

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
  • 使用者

請求型別。 指定要求的資料型別。

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

偵錯
在偵錯模式下執行命令。
內容
傳回暈映中物件的相關資訊。
img
執行命令並傳回演算後的影像。
imageprops
傳回指定暈映的屬性。
對應
傳回內嵌在暈映中的影像地圖資料。
物件
執行命令並將遮色片所呈現的影像傳回至目前的物件選取範圍。
prop
執行命令並傳回回覆影像的屬性。
使用者資料
傳回暈映：：UserData 的內容。

除非在詳細描述中另有說明，否則伺服器會傳回MIME型別<text/plain>的文字回應。

debug

執行指定的命令並傳回演算後的影像。 如果發生錯誤，會傳回錯誤和偵錯資訊，而非錯誤影像( attribute::ErrorImagePath)。

contents

傳回暈映中物件階層的XML表示法，包括選取的物件屬性。 會忽略請求中的其他命令。

img

執行指定的命令並傳回演算後的影像。 回覆資料格式和回應型別由fmt=決定。

imageprops

傳回URL路徑中所指定暈映檔案或目錄專案的選取屬性。 如需回覆語法和回應MIME型別的說明，請參閱屬性。 會忽略請求中的其他命令。 系統會傳回下列屬性：

屬性
類型
說明
image.expiration
兩次
屬性：：到期或預設存留時間。
image.height
整數
以畫素為單位的完整解析度高度。
image.iccProfile
字串
與此暈映關聯的設定檔名稱/說明。
image.embeddedIccProfile
布林值
1 （如果相關聯的設定檔內嵌於暈映中）。
image.embedded PhotoshopPaths
布林值
1 （如果暈映嵌入路徑資料）。
image.modifier
字串
屬性：：修飾元；若不是目錄專案，則為空白。
image.pixTyp
列舉
回應影像的畫素型別；可以是「CMYK」、「RGB」或「BW」（適用於灰階影像）。
image.printRes
實數
以dpi為單位的預設列印解析度。
image.timeStamp
字串
修改日期/時間（來自目錄：：TimeStamp 或暈映檔案）。
image.width
整數
以畫素為單位的完整解析度寬度。
vignette.name
字串
暈映名稱（根暈映物件的名稱字串）。
vignette.res
實數
最大物件解析度材質解析度單位（通常是畫素/英吋）。
vignette.res.avg
實數
平均物件解析度材質解析度單位（通常是畫素/inc 材質解析度h）。
vignette.res.min
實數
以材質解析度單位（通常是畫素/英吋）為單位的最小物件解析度。
vignette.version
整數
暈映檔案版本號碼。

map

傳回暈映中包含的影像地圖資料。 依預設，會傳回所有最外層群組的對應資料。 可使用取得所有最內層群組的對應資料

req=map&groupLevel=-1

對應資料未縮放為wid=或hei=或以其他方式修改。 回應MIME型別為<text/xml>。

回應資料包含<map>元素，其中包含一組與HTML<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=命令選取的群組或物件）遮罩的演算影像。 通常搭配支援Alpha的影像格式使用（請參閱fmt=）。 如果使用不支援Alpha的影像格式，遮色片外的區域為黑色。

props

執行指定的命令並傳回暈映屬性和群組或物件屬性，而不是彩現的影像。 如需回覆語法和回應MIME型別的說明，請參閱屬性。 除非同時指定obj=或sel=，否則會套用預設選取範圍（請參閱obj=）。

回應中可能包含以下屬性：

屬性
類型
說明
image.bgc
字串
回覆影像背景顏色。
image.height
整數
回覆影像高度（畫素）。
image.iccEmbed
布林值
如果ICC設定檔內嵌在回覆影像中，則為True （請參閱 iccEmbed=）。
image.iccProfile
字串
與回覆影像關聯之設定檔的捷徑名稱（請參閱 icc=）。
image.mask
布林值
如果回覆影像包含Alpha，則為True。
image.pathEmbed
布林值
如果回覆影像包含路徑資料，則為True （請參閱 pathEmbed=）。
image.pixTyp
字串
回覆影像型別，可以是'CMYK'、'RGB'或'BW' （適用於灰階影像）
image.printRes
實數
列印解析度(dpi)
image.quality
整數，布林值
JPEG品質和色度旗標（請參閱 qlt=）
image.type
字串
回覆影像的MIME型別（請參閱 fmt=）。
image.width
整數
回覆影像寬度（畫素）。
選取專案。屬性
字串
目前選取範圍的屬性字串。
選擇。計數
整數
目前選取範圍中的物件數目。
選取範圍。縮排
整數
目前選取範圍的縮排值。
選取選取專案。屬性ion.name
字串
目前物件選取範圍的完整名稱路徑。
選取範圍。重疊
整數
目前選取範圍中的重疊物件數目。
選取範圍。可轉譯
整數
目前選取範圍中的可轉譯物件數目。
選取範圍。可紋理化
整數
目前選取範圍中的可紋理物件數目。
選取範圍。可見
整數
目前顯示/隱藏目前選取專案的狀態。
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

另請參閱 section-f7a955525fb44ef2ae7cd7ede25a96c3

fmt= ， attribute：：ErrorImagePath， 暈映：：UserData， 屬性

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