建立暈映的新發佈格式。
暈映格式會指定已發佈暈映及其縮圖的大小,以及縮放等級、銳利化引數和從IPS發佈至「影像演算」伺服器的主要暈映所產生暈映的檔案格式版本。
較新的影像演算伺服器版本可支援金字塔暈映,因此無需定義特定的暈映格式大小以進行發佈。
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
ImagePortalAdmin
輸入(createVignettePublishFormatParam)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
companyHandle | xsd:string | 是 | 處理暈映所屬的公司。 |
名稱 | 程式碼片語 | 是 | 可識別暈映發佈格式的名稱。 |
targetwidth | 程式碼片語 | 是 | 指定所產生暈映檢視的目標寬度(畫素)。 使用零,讓輸出暈映的大小與主要暈映相同。 |
targetHeight | 程式碼片語 | 是 | 建立為影像演算伺服器上的縮放最佳化的金字塔暈映。 從目標暈映大小欄位設定的大小上限開始,這會在單一暈映輸出檔案中建立多個大小檢視。 每個後續的檢視大小都會減半,直到寬度和高度在128x128畫素以內。 |
createPyramid | 程式碼片語 | 是 | 指定每個所產生縮圖的寬度(畫素)。 此設定為選用。 保留為0表示沒有縮圖檔案。 |
thumbWidth | 程式碼片語 | 是 | 指定已發佈暈映的檔案格式。 指定影像製作的新版本和影像演算伺服器的舊版本,您必須指定ImageRendering伺服器可讀取的暈映版本。 如果您指定較高的版本,影像演算伺服器將無法讀取已發佈的暈映。 設定為零可發佈最新版本的暈映。 |
saveAsVersion | 程式碼片語 | 是 | 指定分隔暈映名稱和表示其寬度的字尾的字元。 |
sizeSuffixSeparator | 程式碼片語 | 是 | 指定分隔暈映名稱和表示其寬度的字尾的字元。 |
銳利化 | 程式碼片語 | 否 | 針對每個發佈的暈映大小將銳利化套用至主檢視影像。銳利化可在縮放暈映時補償模糊。 |
usmAmount | 程式碼片語 | 是 | 數位銳利化調整遮色片是一種彈性且強大的方式,可增加銳利度,尤其是在掃描的影像中。 這會控制每個超調的幅度(邊緣邊界會變暗和變亮多少)。 |
usmRadius | 程式碼片語 | 是 | 影響要增強的邊的大小或邊框的寬度,因此較小的半徑會增強較小尺寸的細節。 較高的半徑值可能會在邊緣產生光暈。 精細細節需要較小的半徑,因為相同大小或小於半徑的微小細節會遺失。 |
usmThreshold | 程式碼片語 | 是 | 控制要銳利化的最小亮度變化,或濾鏡運作前相鄰色調值必須相距多遠。 此設定可銳利化較銳利的邊緣,同時保留較輕微的邊緣不受接觸。 允許的0到255臨界值範圍。 |
輸出(createVignettePublishFormatReturn)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
vignetteFormatHandle | xsd:string |
是 | 已建立暈映格式的控點。 |
此程式碼會建立暈映發佈格式。 建立請求會指定名稱、目標寬度和高度,以及其他必要的值。
請求
<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>