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

オブジェクト object

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者
ユーザー

Source オブジェクト指定子。 Image、SVG、および ICC プロファイルオブジェクトは、画像カタログエントリまたは相対ファイルパスとして指定できます

*object*[/]{[ *rootId*/] *objId*}| *path*

rootId

画像カタログの名前（ attribute::RootId ）

objtId

指定した、メインまたはデフォルトの画像カタログ内の画像、SVG、テンプレートまたは ICC プロファイルレコードの ID

path

画像、マスク、または ICC プロファイルファイルの相対パスと名前

オブジェクト

は、メイン URL パス、または src= 、 mask= 、icc= コマンドのいずれかで使用きます。

rootId は画像カタログを識別します。（詳しくは、画像カタログを参照してください。） URL パスで rootId が指定されている場合、そのカタログはこのリクエストの メインカタログ になります。それ以外の場合は、デフォルトのカタログがメインカタログとして使用されます。同じリクエストで複数の異なる画像カタログを使用できます。

サーバは最初に、rootId、src=、mask= のコマンドで icc= が省略されていると仮定し、メインカタログ内のカタログエントリを検索しようとします。実際には、サーバーは object 文字列全体を objId. のように使用しようとします

カタログエントリが見つかった場合はそのエントリが使用されます。見つからなかった場合は、次にサーバーによって画像カタログの rootId の照合が試行されます。カタログが識別された場合は、objId が検索されます。およびエントリが見つかった場合は、使用されます。

それ以外の場合は、object は明示的なファイルパスと見なされます。この場合、メインのカタログで attribute::FullMatch が設定されていると、このオブジェクトではカタログが無視され、代わりにデフォルトのカタログが使用されます。 attribute::FullMatch が設定されていない場合は、メインカタログを使用してさらに処理を行います。

rootId と objId はどちらも大文字と小文字が区別されます。 path は、UNIX でのみ大文字と小文字を区別します。

先頭の / を指定すると、メインのカタログではなく既定のカタログが検索されます。これは主に、明示的なパスがメインカタログの default::RootPath ではなく attribute::RootPath を必要とする場合に役立ちますが、既定のカタログ内のエントリへのアクセスを取得する場合にも使用できます。このアクセスを無効にすると、メインカタログ内のエントリによって優先されます。

Server 構成ガイド の コンテンツの管理 を参照して、path を物理ファイルパスに変換する方法を確認してください。

NOTE

object. では、コンマ「,」は使用できません

サポートされる画像ファイル形式 section-12c85aead78e4f759856ca9ff10637d7

サポートされているファイル形式の完全なリストについては、IC （Image Converter）ユーティリティの説明を参照してください。

複数の異なる解像度の画像データを必要とするアプリケーションは、Dynamic Media Pyramid TIFF（PTIF）マルチレゾリューション形式を使用する場合に最も高いパフォーマンスを発揮します。 IC ユーティリティは、サポートされている任意の画像形式から PTIF 画像を作成するために使用されます。

例 section-728ca9b566b54ea1afdf8f5f0a031a57

2 つの異なる画像カタログの画像および ICC プロファイルへのアクセス

' myImage'として識別される画像カタログ内の画像' myCatalog'を取得し、' sRGB'という名前の画像カタログにある ICC プロファイル myProfiles'を添付してください：

http:// * サーバー */myCatalog/myImage?icc=myProfiles/sRGB&iccEmbed=true

レイヤー化による単一の画像カタログの使用

3 つのレイヤーで構成される単純な複合画像を作成します。すべてのレイヤーは「myCatalog」から取得されます。

http:// * サーバー */myCatalog?layer=0&src=img0&layer=1&src=img1&layer=2&src=img2&wid=200

カタログを使用して属性を指定しながら、画像ファイルに直接アクセスする

my/image/path/myImage.tif で設定されたデフォルトの jpg 属性を使用して、myImageCatalog にアクセスします。

http://server/myImageCatalog/my/image/path/myImage.tif?wid=200

オブジェクト object

サポートされる画像ファイル形式 section-12c85aead78e4f759856ca9ff10637d7

例 section-728ca9b566b54ea1afdf8f5f0a031a57

関連項目 section-b6eccefad63f441d922699c4aba58fc9