createVignettePublishFormat createvignettepublishformat

建立暈映的新發佈格式。

暈映格式會指定已發佈暈映及其縮圖的大小,以及縮放等級、銳利化引數和從IPS發佈至「影像演算」伺服器的主要暈映所產生暈映的檔案格式版本。

較新的影像演算伺服器版本可支援金字塔暈映,因此無需定義發佈的特定暈映格式大小。

授權的使用者型別 section-f5c563e3695c4dba8df41e2a965aace7

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

參數 section-3a368186ec1d4005bca056fc9d9bacc7

輸入(createVignettePublishFormatParam)

名稱
類型
必要
說明
companyHandle
xsd:string
處理暈映所屬的公司。
名稱
字碼片語
可識別暈映發佈格式的名稱。
targetWidth
字碼片語

指定所產生暈映檢視的目標寬度(畫素)。

使用零,讓輸出暈映的大小與主要暈映相同。

targetHeight
字碼片語
建立為影像演算伺服器上的縮放最佳化的金字塔暈映。 從目標暈映大小欄位設定的大小上限開始,這會在單一暈映輸出檔案中建立多個大小檢視。 每個後續的檢視大小都會減半,直到寬度和高度都在128x128畫素以內。
createPyramid
字碼片語
指定每個所產生縮圖的寬度(畫素)。 此設定為選用。 保留為0,表示沒有縮圖檔案。
thumbWidth
字碼片語
指定已發佈暈映的檔案格式。 如果您有新版的「影像製作」和舊版的「影像演算伺服器」,就必須指定ImageRendering伺服器可讀取的暈映版本。 如果您指定較高的版本,影像演算伺服器將無法讀取發佈的暈映。 設定為零可發佈最新版本的暈映。
saveAsVersion
字碼片語
指定分隔暈映名稱與表示其寬度之字尾的字元。
sizeSuffixSeparator
字碼片語
指定分隔暈映名稱與表示其寬度之字尾的字元。
銳利化
字碼片語
針對每個發佈暈映大小的主檢視影像套用銳利化「銳利化」可在縮放暈映時補償模糊。
usmAmount
字碼片語
數位不銳利化遮色片是一種彈性且強大的方式,可增加銳利度,尤其是在掃描的影像中。 這會控制每個超調的大小(邊緣邊界會變暗和變亮的程度)。
usmRadius
字碼片語
影響要增強的邊的大小,或邊框變得多寬,因此較小的半徑會增強較小尺寸的細節。 較高的半徑值可能會在邊緣產生光暈。 細微細節需要較小的半徑,因為相同大小或小於半徑的微小細節會遺失。
usmThreshold
字碼片語
控制要銳利化的最小亮度變化,或相鄰色調值在濾鏡運作之前必須相距多遠。 此設定可以銳利化較銳利的邊緣,同時保持較輕微的邊緣不變。 允許的0到255臨界值範圍。

輸出(createVignettePublishFormatReturn)

名稱
類型
必要
說明
vignetteFormatHandle
xsd:string
已建立暈映格式的控點。

範例 section-0564752d439642b9bb8de2903db6de1e

此程式碼會建立暈映發佈格式。 建立請求會指定名稱、目標寬度和高度,以及其他必要的值。

要求

<createVignettePublishFormatParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <name>APIcreateVignettePublishFormat1</name>
   <targetWidth>1200</<targetWidth>
   <targetHeight>800</targetHeight>
   <createPyramid>true</createPyramid>
   <thumbWidth>400</thumbWidth>
   <saveAsVersion>0</saveAsVersion>
   <sizeSuffixSeparator>-</sizeSuffixSeparator>
   <sharpen>50</sharpen>
   <usmAmount>230.0</usmAmount>
   <usmRadius>1.1</usmRadius>
   <usmThreshold>130</usmThreshold>
</createVignettePublishFormatParam>

回應

<createVignettePublishFormatReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <vignetteFormatHandle>v|21|282</vignetteFormatHandle>
</createVignettePublishFormatReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681