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

ic ic

Last update: Thu Aug 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者
ユーザー

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

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

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

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

使用方法 section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

options

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

sourceFile

単一の入力画像ファイル。

destFile

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

sourceFolder

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

destFolder

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

戻り値 section-36a2dcfa39824d29b69547c432366219

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

オプション section-df311ace43f947b3817b60b667ae04ca

– 非圧縮

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

-deflatecompress

deflate （zip）圧縮を使用（デフォルト）

-lzwcompress

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

-jpegcompress

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

-jpegquality < quality >

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

-fullsamplechrominance

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

-usm < amount > < radius > < threshold > < monochrome >

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

-applyClippath

関連付けられたアルファデータを作成するには、ソースファイルのクリップパスを使用します（存在する場合）。

-dpi < dpi >

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

-autocrop < corner > < mode > < tolerance > < infoFile >

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

画像を変換せずに切り抜き長方形を計算するには、-autocrop without -convert and without destFile. を指定します。

corner - ul | ur | ll | lr

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

mode - 0 | 1

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

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

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

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

-embedXmpData

可能な場合は、XMPのメタデータ、 sourceFile から destFile 変更ずにコピーします。

-embedColorProfile

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

-imageprofile < file >

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

-viewprofile < file >

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

-intentPerceptual

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

-intentRelColorimetric

カラースペースコンバージョンの相対的な色域を維持レンダリングインテント（デフォルト）。

-intentAbsColorimetric

カラースペースコンバージョンの絶対的な色域を維持するレンダリングインテント。

-intentSaturation

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

-cmsNoBlackPointCompensation

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

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

-cmsNoDither8

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

-maintainpixeltype

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

- forceJPEGDecompress

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

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

-downsample2x2

標準品質（バイリニア）リサンプリングフィルターを使用します。

-downsample8x8

高品質（ランチョスウィンドウ）の再サンプリングフィルターを使用します（デフォルト）。

-downsample8x8FlashPix

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

-downsample8x8BicubicSharp

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

-nousage

最初のオプションで指定した場合、無効なオプションが見つかった場合に使用情報の出力を抑制します。

– 上書き

destFile の既存のを上書ききるようにします。デフォルトでは、上書きを防ぐために、数値のサフィックスがファイル名に追加されます。

隠しソースファイルを無視します。

-continueonerror

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

-logfile < file >

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

-loglevel < レベル >

ログレベル。

< 0 - ログが無効です。

0 – 処理するファイルをリストします。

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

2 – 進捗レポートの追加

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

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

-logappend

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

-nologappend

ログファイルを上書き。

-logprogressmssec < msec >

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

-maxmem < バイト >

メモリ使用制限。 10 MB 以上にする必要があります。

-maxmempercent < percent >

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

-version

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

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

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

形式

Pixel Type Bits/Chan

ビット/ちゃん

圧縮

Notes

BMP

（Windows ビットマップ）

RGB | インデックス作成

1 | 5/6 | 8

非圧縮 | URL

5/6 bit/channel は、16 ビット RGB （5-5-5 および 5-6-5 ビット/channel）のサポートを示します。

EPS す。

（Encapsulated Postscript）

CMYK |RGB |灰色

ASCII | ASCII85 | バイナリ |JPEG

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

CompuServe

GIF

索引付き

LZW

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

JPG す。

（JFIF/JPEG）

CMYK |RGB |灰色

JPEG

Photoshop

PSD

1 | 8 | 16

非圧縮 |圧縮

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

Macintosh

PICT

RGB

役割

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

PNG

RGB | RGBA |灰色 | grayA | インデックス作成

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でエンコードされた Pyramid 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

a26166cd-f2f4-45ce-996d-96a0f0d6cf49