dcmpsprt: DICOM画像とプレゼンテーションステートを読み込み印刷ジョブを生成する

書式

dcmpsprt [options] dcmfile-in...

説明

dcmpsprt ユーティリティは、1つ以上のDICOM画像とプレゼンテーションステートを読み込み、印刷ジョブを生成します。印刷ジョブは1つのStored Printオブジェクトと1つ以上のHardcopy Grayscale画像で構成され、設定ファイルで指定されたデータベースへ書き込まれます。印刷ジョブは任意でプリンタへスプールできます。その場合、dcmpsprt はプリンタとの通信を担う dcmprscu アプリケーションを呼び出します。

引数

dcmfile-in  印刷するDICOM画像ファイル（"-" で標準入力）

オプション

全般オプション

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

処理オプション

+p --pstate [p]state file: string: 続く画像をプレゼンテーションステート p でレンダリングします（このオプションは複数回指定できます）
-c --config [f]ilename: string: 設定ファイル f の設定で処理します
-p --printer [n]ame: string (default: 1st printer in cfg file): 設定ファイルから識別子 n のプリンタを選択します

スプーリングオプション

-s --spool: 印刷ジョブをDICOMプリンタへスプールします
--nospool: 印刷ジョブをDICOMプリンタへスプールしません（既定値）

フィルム向きオプション

--portrait: 縦向きに設定します
--landscape: 横向きに設定します
--default-orientation: プリンタの既定値を使用します（既定値）

トリム（縁取り）オプション

--trim: トリムを有効にします
--no-trim: トリムを無効にします
--default-trim: プリンタの既定値を使用します（既定値）

デシメート／クロップ要求動作オプション

--request-decimate: デシメートを要求します
--request-crop: クロップを要求します
--request-fail: 失敗を要求します
--default-request: プリンタの既定値を使用します（既定値）

印刷プレゼンテーションLUTオプション

--default-plut: プレゼンテーションLUTを作成しません（既定値）
--identity: IDENTITYプレゼンテーションLUT形状を設定します
--plut [l]ut identifier: string: 印刷ジョブにLUT l を追加します
--inverse-plut: Hardcopy Grayscale画像のビットマップに逆プレゼンテーションLUTをレンダリングします
--illumination [v]alue: integer (0..65535): 照度を v に設定します（単位 cd/m^2）
--reflection [v]alue: integer (0..65535): 反射周囲光を v に設定します（単位 cd/m^2）

基本フィルムセッションオプション（–spool指定時のみ）

--copies [v]alue: integer (1..100, default: 1): 部数を v に設定します
--medium-type [v]alue: string: 媒体タイプを v に設定します
--destination [v]alue: string: フィルムの出力先を v に設定します
--label [v]alue: string: フィルムセッションのラベルを v に設定します
--priority [v]alue: string: 印刷優先度を v に設定します
--owner [v]alue: string: フィルムセッションの所有者IDを v に設定します

アノテーションオプション

--no-annotation: アノテーションを作成しません（既定値）
-a --annotation [t]ext: string: テキスト t のアノテーションを作成します
+pd --print-date: アノテーションの先頭に日時を付加します（既定値）
-pd --print-no-date: アノテーションの先頭に日時を付加しません
+pn --print-name: アノテーションの先頭にプリンタ名を付加します（既定値）
-pn --print-no-name: アノテーションの先頭にプリンタ名を付加しません
+pl --print-lighting: アノテーションの先頭に照度を付加します（既定値）
-pl --print-no-lighting: アノテーションの先頭に照度を付加しません

オーバーレイオプション

+O --overlay [f]ilename: string, [x] [y]: integer: PBMファイル f からオーバーレイデータを読み込み、位置 (x,y) に表示します
+Og --ovl-graylevel [v]alue: integer (0..4095): オーバーレイのグレーレベル v を使用します（既定値: 4095 = 白）

その他の印刷オプション

-l --layout [c]olumns [r]ows: integer (default: 1 1): 'STANDARD\c,r' 画像表示フォーマットを使用します
--filmsize [v]alue: string: フィルムサイズIDを v に設定します
--magnification [v]alue: string: 拡大タイプを v に設定します
--smoothing [v]alue: string: 平滑化タイプを v に設定します
--configinfo [v]alue: string: 構成情報を v に設定します
--resolution [v]alue: string: 要求解像度IDを v に設定します
--border [v]alue: string: 境界濃度を v に設定します
--empty-image [v]alue: string: 空画像の濃度を v に設定します
--max-density [v]alue: string: 最大濃度を v に設定します
--min-density [v]alue: string: 最小濃度を v に設定します
--img-polarity [v]alue: string: 画像ボックスの極性を v に設定します（NORMAL または REVERSE）
--img-request-size [v]alue: string: 要求画像サイズを v に設定します（幅をmmで指定）
--img-magnification [v]alue: string: 画像ボックスの拡大タイプを v に設定します
--img-smoothing [v]alue: string: 画像ボックスの平滑化タイプを v に設定します
--img-configinfo [v]alue: string: 画像ボックスの構成情報を v に設定します

ロギング

各コマンドラインツールおよび基盤ライブラリのログ出力レベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力へ書き出されます。オプション –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 に用意されています）。

環境変数

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

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

ファイル

< etcdir>/dcmpstat.cfg, < etcdir>/printers.cfg - 設定ファイルの例