SVG支援

影像伺服支援可縮放向量圖形(SVG)檔案作為源資料。 需要符合SVG 1.1。

「影像伺服」僅識別靜態SVG內容;不支援動畫、指令碼和其他互動式內容。

可以在允許影像檔案的位置指定SVG(URL路徑、src=mask=)。 柵格化SVG檔案的內容後,其處理方式就像影像一樣。

與影像類似,SVG檔案可以指定為影像目錄條目或相對檔案路徑。

替代變數

$ *var*$ 替代變數可以包含在SVG檔案中的值字串元素 <text> 和任何元素屬性中。

內嵌影像伺服請求的查詢部分中的重要變數不會直接取代。 反之,所有可用的變數定義都會附加至請求,讓影像伺服在剖析請求時能取代變數。

如需詳細資訊,請參閱替代變數

影像參考

可使用<image>元素將影像插入SVG中。 <image>元素的xlink::href屬性所參考的影像必須是有效的影像服務請求。 不允許使用外國URL。

指定完整的「影像伺服」請求(以http://開頭),或以/is/image開頭的相對URL。 如果指定了完整的HTTP路徑,則將從路徑中刪除域名,以轉換為相對格式。 使用完整HTTP路徑可能有其優點,因為它可讓檔案以協力廠商SVG轉譯器預覽。

注意

此版本的「影像伺服」僅支援轉譯影像。 只有在傳統影像服務分層和模板機制不足以達到期望結果的情況下,才應使用從SVG內引用影像。 在任何情況下,都不應使用SVG來產生多影像複合。

注意

目前不會自動調整SVG中嵌入的影像大小。 請確定所有影像參數都包含必要的「影像伺服」命令,以設定所需的影像大小(例如wid=)。 如果未明確設定影像大小,則將應用attribute::DefaultPix

色彩管理

所有嵌入在SVG檔案中並通過替代變數傳遞到SVG模板的顏色值都假定存在於sRgb顏色空間中。

將影像嵌入到SVG中時,不執行顏色轉換。 為確保色彩保真度,請務必為所有內嵌的影像要求指定icc=sRgb

光柵化後,SVG影像與任何其他影像一樣參與色彩管理。

範例

以下SVG範本說明影像參考和變數的使用。

<?xml version="1.0" standalone="no"?> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"> <svg width="500" height="500"> <image x="50" y="50" width="400" height="400" xlink:href="/is/image?src=$img$&wid=300&hei=400"/> <text x="150" y="400" style="font-size:$pts$; fill:$color$"> Title: $txt$ </text> </svg>

此SVG模板的使用方式如下:

http://server/is/image/mySvgTemplate.svg?$txt=Svg%20Template%20Test&$img=myImage.tif&$color=red&$pts=40&qlt=95

限制

SVG檔案必須是獨立的,且不得參考任何次要檔案或資源,但與影像伺服或影像呈現請求參照的外部影像除外(請參閱上文)。

只會轉譯靜態內容。 動畫、互動式功能,如按鈕等。 可能存在,但可能無法如預期呈現。

目前不支援ICC設定檔色彩規格。

<script> 元素可能存在,但一律會忽略。

另請參閱

src= , mask=, SVG 1.1規範

本頁內容