ドキュメント Dynamic Media画像サービングおよび画像レンダリング API

SVGサポート svg-support

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

トピック：

作成対象：

開発者
ユーザー

画像サービングは、ソースデータとして Scalable Vector Graphics （SVG）ファイルをサポートします。 SVG 1.1 への準拠が必要です。

画像サービングでは、静的なSVGコンテンツのみが認識されます。アニメーション、スクリプト、その他のインタラクティブコンテンツはサポートされません。

SVGは、画像ファイルが許可されている場所（URL パス、src=、mask=）であればどこでも指定できます。 SVGファイルのコンテンツがラスタライズされると、画像のように処理されます。

画像と同様に、SVGファイルは画像カタログエントリまたは相対ファイルパスとして指定できます。

代替変数 section-83b149f13f244193901df39b204c975b

SVGファイルの値文字列に、要素と任意の要素属性 <text> 入 $ *var*$ 変数を含めることができます。

埋め込み画像サービングリクエストのクエリ部分にある重要な変数は、直接置き換えられません。代わりに、使用可能なすべての変数定義がリクエストに追加され、リクエストの解析時に画像サービングで変数を置き換えることができます。

詳細は、代替変数を参照してください。

画像参照 section-a7680f9e6aca4b1a83560637cc9fac66

画像は、<image> 要素を使用してSVGに挿入できます。 <image> 要素の xlink::href 属性で参照される画像は、有効な画像提供リクエストである必要があります。外部 URL は許可されていません。

http:// で始まる完全な画像サービングリクエストまたは /is/image で始まる相対 URL を指定します。完全な HTTP パスを指定すると、相対形式に変換するためにパスからドメイン名が削除されます。フル HTTP パスを使用すると、ファイルをサードパーティのSVGレンダラーでプレビューできるので便利です。

NOTE

このリリースの画像サービングでの画像のレンダリングのサポートは制限されています。 SVG内からの画像の参照は、従来の画像サービングレイヤーやテンプレートのメカニズムでは目的の結果を得ることができない場合にのみ使用してください。どのような場合でも、SVGを使用してマルチ画像合成を生成しないでください。

NOTE

現時点では、SVGに埋め込まれた画像のサイズは自動的には変更されません。目的の画像サイズを設定するために必要な画像サービングコマンド（例：wid=）がすべての画像共有に含まれていることを確認します。画像サイズが明示的に設定されていない場合は、attribute::DefaultPix が適用されます。

カラーマネジメント section-ea76e2bc4e1842638aa97a2d470c8a68

SVGファイルに埋め込まれ、SVG変数を介して変換テンプレートに渡されるすべてのカラー値は、sRgb のカラースペースに存在すると想定されます。

SVGに画像を埋め込む際の色変換を行わない。色を忠実に再現するには、すべての埋め込み画像リクエストで icc=sRgb を必ず指定してください。

ラスタライズ後、SVG画像は、他の画像と同様にカラーマネジメントに使用されます。

例 section-036cdd45abd449849ee00a8f21788c28

次の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

制限 section-daa5eccd07204aaf993be41e87822d54

SVGファイルはスタンドアロンでなければならず、画像サービングまたは画像レンダリングリクエストで参照される外部イメージを除き、セカンダリファイルやリソースを参照してはなりません（上記を参照）。

静的コンテンツのみがレンダリングされます。アニメーション、ボタンなどのインタラクティブ機能。は存在しても、期待どおりにレンダリングされない場合があります。

ICC プロファイルベースのカラー仕様は、現時点ではサポートされていません。

<script> 要素が存在する場合がありますが、常に無視されます。