需要

最後更新： 2024年7月22日
  • 主題：

建立對象：

  • 開發人員
  • 使用者

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

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)。

會忽略請求字串中的任何其他命令。