dcmquant: DICOMカラー画像をパレットカラーへ変換する

書式

dcmquant [options] dcmfile-in dcmfile-out

説明

dcmquant ユーティリティは、DICOMカラー画像を読み込み、その画像に対して指定したサイズのパレットカラールックアップテーブルを（Paul Heckbert が発表したメディアンカット法に基づいて）算出し、カラー画像をDICOMパレットカラー画像へ変換します。

引数

dcmfile-in   DICOM input filename to be converted ("-" for stdin)

dcmfile-out  DICOM output filename to be written ("-" for stdout)

オプション

全般オプション

-h --help: このヘルプを表示して終了します
--version: バージョン情報を表示して終了します
--arguments: 展開されたコマンドライン引数を表示します
-q --quiet: 静音モード。警告およびエラーを表示しません
-v --verbose: 詳細表示モード。処理の詳細を表示します
-d --debug: デバッグモード。デバッグ情報を表示します
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) ロガーにレベル l を使用します
-lc --log-config [f]ilename: string: ロガーに設定ファイル f を使用します

入力オプション

+f --read-file: ファイル形式またはデータセットを読み込みます（既定値）
+fo --read-file-only: ファイル形式のみを読み込みます
-f --read-dataset: ファイルメタ情報なしでデータセットを読み込みます入力転送構文:
-t= --read-xfer-auto: TS の自動認識を使用します（既定値）
-td --read-xfer-detect: ファイルメタヘッダで指定された TS を無視します
-te --read-xfer-little: 明示的VRリトルエンディアン TS で読み込みます
-tb --read-xfer-big: 明示的VRビッグエンディアン TS で読み込みます
-ti --read-xfer-implicit: 暗黙的VRリトルエンディアン TS で読み込みます

画像処理およびエンコードのオプション

+F --frame [n]umber: integer: 指定したフレームを選択します
+Fa --all-frames: すべてのフレームを選択します（既定値）互換性:
+Mp --accept-palettes: 不正なパレット属性タグ (0028,111x) および (0028,121x) を受け入れますメディアンカットの次元選択:
+Dr --mc-dimension-rgb: RGB範囲から最大次元を求めます（既定値）
+Dl --mc-dimension-lum: 輝度から最大次元を求めますメディアンカットの代表色選択:
+Cb --mc-color-avgbox: ボックス内の色の平均をとります（既定値）
+Cp --mc-color-avgpixel: ボックス内のピクセルの平均をとります
+Cc --mc-color-center: ボックスの中心の色を選択しますパレット値の表現:
+pw --write-ow: パレットLUTを OW として書き出します（既定値）
+pu --write-us: パレットLUTを US として書き出します（廃止）カラーパレットの作成:
+pe --lut-entries-word: パレットLUTを16ビットエントリで書き出します
+pf --floyd-steinberg: Floyd-Steinberg 誤差拡散を使用します
+pc --colors number of colors: 2..65536 (default 256): 量子化する色数 SOP Class UID:
+cd --class-default: SOP Class UID を維持します（既定値）
+cs --class-sc: Secondary Capture Image へ変換します（--uid-always を伴う） SOP Instance UID:
+ua --uid-always: 常に新しい UID を割り当てます（既定値）
+un --uid-never: 新しい UID を割り当てません

出力オプション

+F --write-file: ファイル形式で書き出します（既定値）
-F --write-dataset: ファイルメタ情報なしでデータセットを書き出します出力転送構文:
+t= --write-xfer-same: 入力と同じ TS で書き出します（既定値）
+te --write-xfer-little: 明示的VRリトルエンディアン TS で書き出します
+tb --write-xfer-big: 明示的VRビッグエンディアン TS で書き出します
+ti --write-xfer-implicit: 暗黙的VRリトルエンディアン TS で書き出します 1993年以降の値表現（VR）:
+u --enable-new-vr: 新しいVR（UN/UT）のサポートを有効にします（既定値）
-u --disable-new-vr: 新しいVRのサポートを無効にし、OB へ変換しますグループ長エンコード:
+g= --group-length-recalc: 存在する場合はグループ長を再計算します（既定値）
+g --group-length-create: 常にグループ長要素を付けて書き出します
-g --group-length-remove: 常にグループ長要素を付けずに書き出しますシーケンスおよびアイテムの長さエンコード:
+e --length-explicit: 明示的な長さで書き出します（既定値）
-e --length-undefined: 不定長で書き出しますデータセット末尾のパディング（--write-dataset とは併用不可）:
-p= --padding-retain: パディングを変更しません（--write-dataset 指定がなければ既定値）
-p --padding-off: パディングなし（--write-dataset 指定時は暗黙的に適用）
+p --padding-create [f]ile-pad [i]tem-pad: integer: ファイルを f バイトの倍数に、アイテムを i バイトの倍数に整列します

ロギング

各コマンドラインツールおよびその基盤となるライブラリのロギング出力レベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力へ書き出されます。オプション –verbose を使うと、処理の詳細といった情報メッセージも報告されます。オプション –debug は、デバッグ用途などで内部動作の詳細を得るために使えます。その他のロギングレベルはオプション –log-level で選択できます。–quiet モードでは致命的エラーのみが報告されます。そうした非常に重大なエラー事象では、通常アプリケーションは終了します。各ロギングレベルの詳細は、モジュール "oflog" のドキュメントを参照してください。

ロギング出力をファイルへ書き出す場合（必要に応じてログファイルのローテーションを伴う）、syslog（Unix）やイベントログ（Windows）へ書き出す場合は、オプション –log-config が使えます。この設定ファイルでは、特定のメッセージだけを特定の出力ストリームへ振り分けたり、メッセージが生成されるモジュールやアプリケーションに基づいて特定のメッセージをフィルタリングしたりすることもできます。設定ファイルの例は < etcdir>/logger.cfg に用意されています。

コマンドライン

すべてのコマンドラインツールは、引数について次の表記法を用います。角括弧は省略可能な値（0〜1個）を囲み、末尾の3つのドットは複数の値が許されること（1〜n個）を示し、両者の組み合わせは0〜n個の値を意味します。

コマンドラインオプションは、先頭の '+' または '-' 記号によって引数と区別されます。通常、コマンドラインオプションの順序や位置は任意です（つまりどこに現れてもかまいません）。ただし、オプションが相互排他的な場合は、最も右に現れたものが使われます。この挙動は一般的なUnixシェルの標準的な評価規則に従います。

加えて、ファイル名の前に '@' 記号を付けることで、1つ以上のコマンドファイルを指定できます（例: @command.txt）。このようなコマンド引数は、それ以降の評価に先立って、対応するテキストファイルの内容に置き換えられます（複数の空白は、引用符に挟まれていない限り単一の区切りとして扱われます）。コマンドファイルの中に別のコマンドファイルを含めることはできない点に注意してください。この単純ながら効果的な仕組みにより、よく使うオプションや引数の組み合わせをまとめておくことができ、長く分かりにくいコマンドラインを避けられます（例は < datadir>/dumppat.txt に用意されています）。

環境変数

dcmquant ユーティリティは、DCMDICTPATH 環境変数で指定されたDICOMデータ辞書を読み込もうとします。既定では、すなわち DCMDICTPATH 環境変数が設定されていない場合は、辞書がアプリケーションに組み込まれている（Windowsでの既定）のでない限り、ファイル < datadir>/dicom.dic が読み込まれます。

既定の動作が望ましく、DCMDICTPATH 環境変数は代替のデータ辞書が必要な場合にのみ使うべきです。DCMDICTPATH 環境変数の形式はUnixシェルの PATH 変数と同じで、エントリをコロン (":") で区切ります。Windowsシステムでは、区切りにセミコロン (";") を使います。データ辞書のコードは、DCMDICTPATH 環境変数で指定された各ファイルを読み込もうとします。データ辞書を1つも読み込めなかった場合はエラーとなります。