dcmprscu: プレゼンテーションステートビューア用プリントスプーラ

書式

dcmprscu [options] [dcmfile-in...]

説明

dcmprscu は、DICOM Basic Grayscale Print Management Service Class を SCU として実装するユーティリティです。オプションの Basic Annotation Box および Presentation LUT SOP クラスにも対応します。本ユーティリティは DICOMscope ビューアでの利用を想定しています。

dcmprscu は、Stored Print オブジェクトと 1 つ以上の Hardcopy Grayscale オブジェクトからなる完全な印刷ジョブを受け取り、プリンタへスプールします。Stored Print オブジェクトに定義された属性が Print SCP でサポートされているかどうかの確認は行いません。ただし、オプションの Annotation サービスや Presentation LUT サービスについては、Print SCP とのネゴシエーションに成功しなかった場合には利用しません。

dcmprscu は、通信相手となるプリンタの特性を設定ファイルから読み込みます。プリンタの Presentation LUT 対応状況に応じて、印刷ジョブに含まれる Presentation LUT は、必要であればプリンタへスプールする前に hardcopy 画像へレンダリングされます。プリンタが 12 bits/pixel での画像送信に対応していない場合(設定ファイルの指定による)、グレースケールの hardcopy 画像は送信前に 8 bits/pixel へダウンサンプリングされます。

dcmprscu は 2 つのモードで動作します。「プリンタモード」では Stored Print オブジェクトのファイル名を渡す必要があります。「スプールモード」では、スプールディレクトリからコマンドを定期的に読み取ります。

引数

dcmfile-in   stored print file(s) to be spooled ("-" for stdin)

オプション

全般オプション

-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 を使用します

印刷オプション

--noprint: 印刷出力を生成しません (n-action-rq を送りません)
--session-print: film box ではなく film session の n-action-rq を送信します
--monochrome1: basic grayscale 画像を MONOCHROME1 で送信します

モードオプション

+p --print: プリンタモード。ファイルを印刷して終了します (既定)
+s --spool [n]ame: string: スプーラモード。ジョブ接頭辞 n を使用します

処理オプション

-c --config [f]ilename: string: 設定ファイル f の設定を用いて処理します
-p --printer [n]ame: string (default: 1st printer in cfg file): 設定ファイル内の識別子 n のプリンタを選択します
+d --dump: すべての DIMSE メッセージをダンプします

スプーラオプション (--spool 指定時のみ)

       --sleep  [d]elay: integer (default: 1)
         sleep d seconds between spooler checks

基本 film session オプション (--spool との併用不可):

--copies [v]alue: integer (1..100, default: 1): 印刷部数を v に設定します
--medium-type [v]alue: string: medium type を v に設定します
--destination [v]alue: string: film destination を v に設定します
--label [v]alue: string: film session label を v に設定します
--priority [v]alue: string: 印刷優先度を v に設定します
--owner [v]alue: string: film session owner ID を 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 にあります)。

環境変数

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

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

ファイル

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