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

ic ic

最終更新日： 2025年8月14日

トピック：
Dynamic Media Classic
SDK/API

作成対象：

Developer
User

画像変換ユーティリティ。

icは、画像ファイルを最適化されたピラミッド TIFF形式（PTIFF）に変換するコマンドラインツールです。画像サービングは変換なしで画像を処理できますが、512 x 512 ピクセルを超えるすべての画像をPTIFFに変換することをお勧めします。この変換により、最適なサーバーパフォーマンスとリソース使用が保証され、応答時間が最小限に抑えられます。

写真コンテンツを含むPTIFF ファイルは、JPEGでエンコードすることをお勧めします（-jpegcompressを指定）。コンピューター生成コンテンツは、可逆圧縮（-deflatecompressまたは-lzwcompress）の恩恵を受けることができます。色変換や画素型変換が必要でない限り、JPEGのソース画像データはデコードせずにPTIFFに転送され、画質の劣化を防ぎます。この場合、指定された圧縮オプションは、低解像度のピラミッドレベルにのみ適用されます。

大きな画像を変換しない場合は、使用するメモリ量を制御するパラメーターを設定する必要はありません。ただし、次に示す-maxmem設定を使用して、ic個のメモリを追加します。必要なメモリ量を計算するための良い経験則は、画像の幅に画像の高さにチャネル数を掛けることです。例えば、アルファ値が3のRGB画像の場合は4です。さらに、チャンネルがコンポーネントごとに8倍ではなく16 ビットの場合、最終的な結果は2倍になります。

使用方法 section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

オプション

コマンドオプション（以下を参照）。

sourceFile

単一の入力画像ファイル

destFile

単一の出力PTIFF ファイル（SourceDirectoryで使用する場合は無効）。

sourceFolder

入力画像を含むフォルダー。

destFolder

出力PTIFF ファイルが書き込まれるフォルダー。

返品 section-36a2dcfa39824d29b69547c432366219

成功した場合は0です。エラーが発生した場合、ゼロ以外の値が返され、エラーの詳細がstderrに送信されます。

オプション section-df311ace43f947b3817b60b667ae04ca

– 圧縮されていない

出力画像を圧縮しないでください。

-deflatecompress

収縮（zip）圧縮を使用します（デフォルト）。

-lzwcompress

LZW （Lempel-Ziv-Welch）圧縮を使用します。

-jpegcompress

JPEGのエンコーディングを利用します。 sourceFile にアルファデータが含まれている場合、無視されます。

-jpegquality < 品質>

JPEGの画質（0～100、デフォルトは95）

-fullsamplechrominance

JPEGのクロマダウンサンプリングを無効にします（カラーテキストとグラフィックの品質を向上させることができます）。これは、CMYKまたはグレースケールの出力画像には影響しません。

-usm < 量> < 半径> < しきい値> < モノクロ >

サブサンプルしたピラミッドレベルにアンシャープマスクを適用します。詳しくは、 op_usm=を参照してください。（フル解像度の画像には適用されません）。

-applyClippath

ソースファイル内のクリップパスを使用して、関連するアルファデータを作成します。

-dpi < dpi >

destFile の印刷解像度（dpi）。指定しない場合、 srcFile の印刷解像度は destFile にコピーされます。

-autocrop < corner > < mode > < 許容値> < infoFile >

切り抜き長方形を計算して、単色の背景を最小限に抑えます。自動切り抜きアルゴリズムによって画像全体が切り抜かれる場合、切り抜き情報は出力されません。

画像を変換せずに切り抜き長方形を計算するには、 – 自動切り抜き（なし） – 変換（なし） destFile （）を指定します。

corner - ul | ur | ll | lr

シードポイントを使用する画像のコーナーを指定します。モードが1の場合は無視されます。

モード- 0 | 1

指定したコーナーピクセルのカラーに基づいて切り抜くには0に設定します。アルファデータがソースイメージに関連付けられている場合は、事前に乗算されたカラーデータに対して機能します。

アルファデータに基づいて切り抜く場合は「1」に設定します。角は無視され、0は常にシード値になります。ソースイメージにアルファデータが関連付けられていない場合は切り抜きは適用されません。

許容値 – 許容値と一致します。実数値0.0 ～ 1.0。一致するピクセルコンポーネント値の許容値を指定します。完全一致の場合は0に設定します。

infoFile – 切り抜き情報データが書き込まれるXML出力ファイルのパスと名前。

-embedXmpData

利用可能な場合は、XMP メタデータを sourceFile から destFile まで変更なしでコピーします。

-embedColorProfile

使用可能な場合は、 destFile にICC カラープロファイルを埋め込みます（デフォルトではプロファイルが埋め込まれていません）。

-imageprofile < ファイル >

ICC プロファイルファイルのパスと名前。 sourceFile のカラースペースを定義します。このカラースペースはピクセルタイプと一致する必要があります。プロファイルが sourceFile に埋め込まれていない場合にのみ、埋め込まれたプロファイルを上書きするため、指定する必要があります。

-viewprofile < ファイル >

ICC プロファイルファイルのパスと名前。 destFile のピクセルタイプとカラースペースを定義します。 sourceFile に埋め込まれたプロファイルがある場合、または -imageprofile が指定されている場合、ICはこのプロファイルに変換します。

-intentPerceptual

カラースペース変換のための知覚的レンダーインテント。

-intentRelColorimetric

カラースペース変換の相対的な色域レンダリングインテント（デフォルト）。

-intentAbsColorimetric

カラースペース変換のための絶対的な色域レンダーインテント。

-intentSaturation

カラースペース変換の彩度レンダリングインテント。

-cmsNoBlackPointCompensation

特定のカラーコンバージョンのブラックポイント補正を無効にする

デフォルトで有効になっています。

-cmsNoDither8

カラー変換時のディザリング（エラー拡散）を無効にします。

-maintainpixeltype

CMYKからRGBへの自動変換を無効にします。

- forceJPEGDecompress

JPEG入力画像のデコードと再エンコードを強制します。

注意：このオプションを適用すると、画質が低下する可能性があります。

-downsample2x2

標準品質（双線形）リサンプリングフィルターを使用します。

-downsample8x8

より高い画質（Lanczos ウィンドウ）のリサンプリングフィルター（デフォルト）を使用します。

-downsample8x8FlashPix

高画質（FlashPix）のリサンプリングフィルターを使用します。

-downsample8x8BicubicSharp

Photoshopスタイル 8x8 バイキュービックシャープフィルターを使用したダウンサンプル。

– 使用法

最初のオプションとして指定した場合、無効なオプションが検出された場合は、使用情報の出力を抑制します。

– 上書き

既存の destFile の上書きを許可します。デフォルトでは、ファイル名に数値サフィックスが追加され、上書きができなくなります。

– 非表示をスキップ

非表示のソースファイルを無視します。

-continueonerror

エラーが発生したときに処理を停止しないでください。複数のファイルを処理する場合にのみ効果があります。

-logfile < ファイル >

ログファイルのパスと名前（デフォルトは stdout ）。

-loglevel < level >

ログレベル：

< 0 - ログ記録が無効です。

0 – 処理するファイルを一覧表示します。

1 – 不要なファイルのレポートを追加します。

2 – 進行状況レポートを追加します。

3 – 発生したすべてのファイルに関するレポートを追加します。

4 - ファイルレベルで進行状況レポートを追加します。

-logappend

ログファイルに追加（デフォルト）。

-nologappend

ログファイルを上書きします。

-logprogressmsec < ミリ秒>

ログレベル 2以降のログ間隔（ミリ秒単位）（デフォルトは3000）。

-maxmem < バイト >

メモリ使用量の制限。少なくとも10 MBである必要があります。

-maxmempercent < パーセント >

メモリ使用量の制限。デフォルトは物理メモリの25%です。 maxmem も maxmempercent も明示的に設定されていない場合は、maxmempercentのデフォルトを使用します。

– バージョン

このユーティリティのバージョン情報を返します。他のオプションなしで指定します。

サポートされる入力画像形式 section-ab13d941d6724e65b9f84b62d949d31c

次の表に、ICでサポートされている画像ファイル形式と形式オプションを示します。

形式

ピクセルの種類 ビット/チャン

ビット/チャン

圧縮

件のメモ

BMP

（Windows ビットマップ）

RGB | インデックス

1 | 5/6 | 8

非圧縮| RLE

5/6 ビット/チャンネルは、16 ビット RGB（5-5-5および5-6-5 ビット/チャンネル）のサポートを示します。

EPS

（カプセル化されたPostscript）

CMYK | RGB | グレー

ASCII | ASCII85 | バイナリ | JPEG

Photoshopで生成されたEPS ファイルのみがサポートされます。

CompuServe

GIF

索引付き

LZW

存在する場合、パレットの透明度の値はアルファに変換されます。

JPG

（JFIF/JPEG）

CMYK | RGB | グレー

JPEG

Photoshop

PSD

CMYK | CMYKA | RGB | RGBA | グレー| グレー

1 | 8 | 16

非圧縮|圧縮

結合された画像のみ。レイヤーと追加チャンネルは無視されます。

Mac OS

PICT

RGB

RLE

ビットマップデータのみ。ベクターデータは無視されます。

PNG

RGB | RGBA | グレー| グレーA | インデックス

1 | 2 | 4 | 8 | 16

圧縮

TIFF

1 | 8 | 16

最初に関連付けられたアルファチャンネルを除き、追加のチャンネルは無視されます。

埋め込まれたICC プロファイルは、EPS、JPG、PSD、PNG、およびTIFF ファイルで認識されます。

埋め込みパスとXMP メタデータは、EPS、JPG、PSD、およびTIFF ファイルで認識されます。

例 section-3c1986b30315431989bd76b1ee5bef6d

単一の画像を最高画質で変換し、同じフォルダーに保存します。

ic -convert src/myFile.png src/myFile.tif

srcFolderのすべての画像をJPEGでエンコードされたピラミッド TIFFに変換し、destFolderに配置します。

ic -convert -jpegcompress -jpegquality 90 -overwrite -continueOnError srcFolder destFolder

srcFolderのすべての画像を変換します。 JPGファイルのエンコードされた画像データは、これらの画像の残りのピラミッドと、JPG以外のすべての入力ファイルの出力画像全体に対して、完全な解像度レベルのロスレス LZW圧縮に使用されます。ピクセルタイプ、埋め込みカラープロファイル、XMP メタデータなど。は維持されます。

ic -convert -lzwcompress -embedXmpData -embedColorProfile -maintainpixeltype -overwrite -continueOnError srcFolder destFolder

recommendation-more-help

dynamic-media-developer-resources-help-aem-is-ir-api