1dcmpsprt(1) OFFIS DCMTK dcmpsprt(1)
2
6 dcmpsprt - Read DICOM images and presentation states and render print
7 job
8
11 dcmpsprt [options] dcmfile-in...
12
14 The dcmpsprt utility reads one or more DICOM images and presentation
15 states and creates a print job. The print job consists of one Stored
16 Print object and one or more Hardcopy Grayscale images and is written
17 to the database specified in the configuration file. The print job can
18 optionally be spooled to the printer. In this case, dcmpsprt calls the
19 dcmprscu application which performs communication with the printer.
20
22 dcmfile-in DICOM image file(s) to be printed
23
25 general options
26 -h --help
27 print this help text and exit
28 --version
30 print version information and exit
31 --arguments
33 print expanded command line arguments
34 -q --quiet
36 quiet mode, print no warnings and errors
37 -v --verbose
39 verbose mode, print processing details
40 -d --debug
42 debug mode, print debug information
43 -ll --log-level [l]evel: string constant
45 (fatal, error, warn, info, debug, trace)
46 use level l for the logger
47 -lc --log-config [f]ilename: string
49 use config file f for the logger
50 processing options
52 +p --pstate [p]state file: string
53 render the following image with presentation state p
54 (this option can be specified multiple times)
55 -c --config [f]ilename: string
57 process using settings from configuration file f
58 -p --printer [n]ame: string (default: 1st printer in cfg file)
60 select printer with identifier n from cfg file
61 spooling options
63 -s --spool
64 spool print job to DICOM printer
65 --nospool
67 do not spool print job to DICOM printer (default)
68 film orientation options
70 --portrait
71 set portrait orientation
72 --landscape
74 set landscape orientation
75 --default-orientation
77 use printer default (default)
78 trim (border) options
80 --trim
81 set trim on
82 --no-trim
84 set trim off
85 --default-trim
87 use printer default (default)
88 requested decimate/crop behavior options
90 --request-decimate
91 request decimate
92 --request-crop
94 request crop
95 --request-fail
97 request failure
98 --default-request
100 use printer default (default)
101 print presentation LUT options
103 --default-plut
104 do not create presentation LUT (default)
105 --identity
107 set IDENTITY presentation LUT shape
108 --plut [l]ut identifier: string
110 add LUT l to print job
111 --inverse-plut
113 render the inverse presentation LUT into the
114 bitmap of the hardcopy grayscale image
115 --illumination [v]alue: integer (0..65535)
117 set illumination to v (in cd/m^2)
118 --reflection [v]alue: integer (0..65535)
120 set reflected ambient light to v (in cd/m^2)
121 basic film session options (only with –spool)
123 --copies [v]alue: integer (1..100, default: 1)
124 set number of copies to v
125 --medium-type [v]alue: string
127 set medium type to v
128 --destination [v]alue: string
130 set film destination to v
131 --label [v]alue: string
133 set film session label to v
134 --priority [v]alue: string
136 set print priority to v
137 --owner [v]alue: string
139 set film session owner ID to v
140 annotation options
142 --no-annotation
143 do not create annotation (default)
144 -a --annotation [t]ext: string
146 create annotation with text t
147 +pd --print-date
149 prepend date/time to annotation (default)
150 -pd --print-no-date
152 do not prepend date/time to annotation
153 +pn --print-name
155 prepend printer name to annotation (default)
156 -pn --print-no-name
158 do not prepend printer name to annotation
159 +pl --print-lighting
161 prepend illumination to annotation (default)
162 -pl --print-no-lighting
164 do not prepend illumination to annotation
165 overlay options
167 +O --overlay [f]ilename: string, [x] [y]: integer
168 load overlay data from PBM file f and display at position (x,y)
169 +Og --ovl-graylevel [v]alue: integer (0..4095)
171 use overlay gray level v (default: 4095 = white)
172 other print options
174 -l --layout [c]olumns [r]ows: integer (default: 1 1)
175 use 'STANDARD
176 --filmsize [v]alue: string
177 set film size ID to v
178 --magnification [v]alue: string
180 set magnification type to v
181 --smoothing [v]alue: string
183 set smoothing type to v
184 --configinfo [v]alue: string
186 set configuration information to v
187 --resolution [v]alue: string
189 set requested resolution ID to v
190 --border [v]alue: string
192 set border density to v
193 --empty-image [v]alue: string
195 set empty image density to v
196 --max-density [v]alue: string
198 set max density to v
199 --min-density [v]alue: string
201 set min density to v
202 --img-polarity [v]alue: string
204 set image box polarity to v (NORMAL or REVERSE)
205 --img-request-size [v]alue: string
207 set requested image size to v (width in mm)
208 --img-magnification [v]alue: string
210 set image box magnification type to v
211 --img-smoothing [v]alue: string
213 set image box smoothing type to v
214 --img-configinfo [v]alue: string
216 set image box configuration information to v
217
219 The level of logging output of the various command line tools and
220 underlying libraries can be specified by the user. By default, only
221 errors and warnings are written to the standard error stream. Using
222 option --verbose also informational messages like processing details
223 are reported. Option --debug can be used to get more details on the
224 internal activity, e.g. for debugging purposes. Other logging levels
225 can be selected using option --log-level. In --quiet mode only fatal
226 errors are reported. In such very severe error events, the application
227 will usually terminate. For more details on the different logging
228 levels, see documentation of module 'oflog'.
229 In case the logging output should be written to file (optionally with
231 logfile rotation), to syslog (Unix) or the event log (Windows) option
232 --log-config can be used. This configuration file also allows for
233 directing only certain messages to a particular output stream and for
234 filtering certain messages based on the module or application where
235 they are generated. An example configuration file is provided in
236 <etcdir>/logger.cfg.
237
239 All command line tools use the following notation for parameters:
240 square brackets enclose optional values (0-1), three trailing dots
241 indicate that multiple values are allowed (1-n), a combination of both
242 means 0 to n values.
243 Command line options are distinguished from parameters by a leading '+'
245 or '-' sign, respectively. Usually, order and position of command line
246 options are arbitrary (i.e. they can appear anywhere). However, if
247 options are mutually exclusive the rightmost appearance is used. This
248 behavior conforms to the standard evaluation rules of common Unix
249 shells.
250 In addition, one or more command files can be specified using an '@'
252 sign as a prefix to the filename (e.g. @command.txt). Such a command
253 argument is replaced by the content of the corresponding text file
254 (multiple whitespaces are treated as a single separator unless they
255 appear between two quotation marks) prior to any further evaluation.
256 Please note that a command file cannot contain another command file.
257 This simple but effective approach allows one to summarize common
258 combinations of options/parameters and avoids longish and confusing
259 command lines (an example is provided in file <datadir>/dumppat.txt).
260
262 The dcmpsprt utility will attempt to load DICOM data dictionaries
263 specified in the DCMDICTPATH environment variable. By default, i.e. if
264 the DCMDICTPATH environment variable is not set, the file
265 <datadir>/dicom.dic will be loaded unless the dictionary is built into
266 the application (default for Windows).
267 The default behavior should be preferred and the DCMDICTPATH
269 environment variable only used when alternative data dictionaries are
270 required. The DCMDICTPATH environment variable has the same format as
271 the Unix shell PATH variable in that a colon (':') separates entries.
272 On Windows systems, a semicolon (';') is used as a separator. The data
273 dictionary code will attempt to load each file specified in the
274 DCMDICTPATH environment variable. It is an error if no data dictionary
275 can be loaded.
276
278 <etcdir>/dcmpstat.cfg, <etcdir>/printers.cfg - sample configuration
279 files
280
282 dcmprscu(1)
283
285 Copyright (C) 1999-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
286 Germany.
287Version 3.6.7 Fri Apr 22 2022 dcmpsprt(1)