| On this page |
概要 ¶
icp [options] [res] [sub] <入力画像> [sub] <出力画像>
意味:
resは[-w ‹width›] [-h ‹height›]、subは[-x ‹xoff›] [-y ‹yoff›] [-w ‹width›] [-h ‹height›]または[-d
‹divs› ‹section›]です。
説明 ¶
icpは 入力画像 の一部を 出力画像 にコピーします。
引数を指定しなければ、icpは入力画像の全体を出力画像にコピーします。入力画像と出力画像の解像度が異なっていても、icpは入力画像の部分を出力画像に合うようにコピーします。
出力画像 が 入力画像 とファイルタイプが違っていても、画像は自動的に新しいファイルタイプに変換されます。例えば:
icp myimage.exr myimage.tif
これは myimage.exr を .tif ファイルフォーマットに変換します。
解像度とオフセット(res) ¶
画像の任意の箇所は入力画像から解像度とオフセットで指定します。サブ領域の幅と高さは-wと-hのオプションで指定します。片方を省略すれば、その値は画像の全体の幅または高さに設定されます。これらのオプションはコマンドラインでは入力画像の前に指定しなければなりません。
入力画像または出力画像のどちらかでサブ領域のオフセットを指定します。それらの画像には-xと-yオプションを指定します。オフセットオプションを入力画像の前に指定すれば、入力画像に適用されます。同様に出力画像の前に指定すれば出力画像に適用されます。片方または両方とも省略すれば、それらの値はデフォルトの0に設定されます。
解像度なしでオフセットを指定すれば、icpは画像の解像度を指定したオフセット値で適切に調整します。
分割と画像(sub) ¶
サブ画像(または領域)は入力画像または出力画像に対して、その前に-dオプションを付けます。このオプションにはサブフレームの番号を意味する2つの値を分割する画像とこのコピー操作で使うサブ画像番号に設定します。
サブ分割の数は整数の2乗でなければなりません。サブ画像番号は0とサブ分割の数-1の間でなければなりません。サブ画像番号0は左上で、サブ分割の数-1は右下を意味します。
オフセットの仕様と同様に、入力画像の前にオプションを指定すれば、入力画像に適用されます。同様に出力画像の前に指定すれば出力画像に適用されます。
画像のサブ領域を指定するのに2通りの方法が混在していて、1つは入力画像で指定し、もう一方は出力画像で使われます。前述のように、入力画像と出力画像の解像度が異なっていても、入力画像の部分を出力画像に合うようにコピーします。
オプション ¶
-e
エラーが発生してもコピーを継続します。
-m
出力画像が既存ファイルであれば、-mオプションを指定すると、ファイルが再作成されるのではなくて修正されます。
これはサブフレーム(領域)をディスクに保存した既存フレームにサブ画像領域外の出力画像の一部を壊すことなくコピーすることができます。
-u
画像が圧縮されないようにするには、-uオプション(非圧縮)を使います。
これは、出力フォーマットのランレングス圧縮(RLE)を避ける事ができます。
この圧縮をサポートしているフォーマットは、Prisms/Houdini(.pic)、Wavefront(.rla/.rlb)、Targa(.tga/.vst)です。
-v
-vオプションは、コピー操作のコピー元、コピー先、解像度を示したステータスメッセージを標準エラーファイルに出力します。
-r ‹width› ‹height›
画像を、指定した解像度までスケールします。
-w ‹width›
指定した幅までスケールします(-wを動作させるには、-hオプションも指定する必要があります)。
-h ‹height›:
指定した高さまでスケールします(-hを動作させるには、-wオプションも指定する必要があります)。
-s ‹scale›:
元の解像度を、指定した割合までスケールします。 例えば、‹scale›が50ならば、解像度が半分になります。
-j ‹u1› ‹v1› ‹u2› ‹v2›
データウィンドウ(UV座標)を書き込みます。
-J ‹x1› ‹y1› ‹x2› ‹y2›
データウィンドウ(ピクセル座標)を書き込みます。
-c ‹u1› ‹v1› ‹u2› ‹v2›
クロップ領域(UV座標)を指定します。
-C ‹x1› ‹y1› ‹x2› ‹y2›
クロップ領域(ピクセル座標)を指定します。
-f
コピーする時に画像を垂直に反転させます。
-F
コピーする時に画像を水平に反転させます。
-R
コピーする時に画像を反時計回りに90度回転させます。
-d ‹data_type›
出力画像のデータタイプを上書きします:
-
int8: 符号付き8ビット整数 -
uint8: 符号なし8ビット整数 -
int16: 符号付き16ビット整数 -
uint16: 符号なし16ビット整数 -
int32: 符号付き32ビット整数 -
uint32: 符号なし32ビット整数 -
real16: 16ビット浮動小数点 -
real32: 32ビット浮動小数点
-p ‹pattern›
指定したpatternにマッチしたAOVsのみを出力画像に含めます。
(スペース区切りで)複数のパターンを指定することができます。
このパターンには、AOV名、または、*や?を含めることができます。
-P ‹indices›
indicesのリストで指定されたAOVsのみを出力画像に含めます。
1番目のAOVのインデックスは1です。
範囲は、[x-y]で指定することができます。
-x
AOVsを別々のファイルに抽出します。
デフォルトでは、すべてのAOVsが抽出されますが、-pまたは-Pオプションを使用することで、AOVsを選択することができます。
各AOVは、元のファイル名の後にAOV名が付いた新しい画像に保存されます。例:
% icp -x output.exr % ls output*exr output_basecolor.exr output_diffuse.exr output_hitN.exr output_hitP.exr
-X ‹pattern›
AOVsを別々のファイルに抽出する時、(出力フォーマットが8ビットで、sRGBカラーしか格納できない場合であっても)リニア空間のままにしたいAOVsのリストを指定することができます。
-g ‹mode›
画像カラー空間の自動変換を有効にします。
-
auto: 画像フォーマットから自動判定します(デフォルト)。 -
off: カラー空間の変換を無効にします。
-L ‹lut_file›
cineon LUTファイルを使用して画像を読み込みます。
-O ‹lut_file›
cineon LUTファイルを使用して保存を保存します。
-A
新規ファイルの作成者関連のメタデータを更新します。
-D
必要に応じて親ディレクトリを作成します。
サンプル ¶
OpenEXR画像をJPEG画像に変換します
icp source.exr output.jpg
OpenEXR画像のすべてのAOVを別々のファイルに分割します
icp -x source.exr