1dcmpsprt(1)                       OFFIS DCMTK                      dcmpsprt(1)
2
3
4

NAME

6       dcmpsprt  -  Read DICOM images and presentation states and render print
7       job
8
9

SYNOPSIS

11       dcmpsprt [options] dcmfile-in...
12

DESCRIPTION

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

PARAMETERS

22       dcmfile-in  DICOM image file(s) to be printed
23

OPTIONS

25   general options
26         -h   --help
27                print this help text and exit
28
29              --version
30                print version information and exit
31
32              --arguments
33                print expanded command line arguments
34
35         -q   --quiet
36                quiet mode, print no warnings and errors
37
38         -v   --verbose
39                verbose mode, print processing details
40
41         -d   --debug
42                debug mode, print debug information
43
44         -ll  --log-level  [l]evel: string constant
45                (fatal, error, warn, info, debug, trace)
46                use level l for the logger
47
48         -lc  --log-config  [f]ilename: string
49                use config file f for the logger
50
51   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
56         -c   --config  [f]ilename: string
57                process using settings from configuration file f
58
59         -p   --printer  [n]ame: string (default: 1st printer in cfg file)
60                select printer with identifier n from cfg file
61
62   spooling options
63         -s   --spool
64                spool print job to DICOM printer
65
66              --nospool
67                do not spool print job to DICOM printer (default)
68
69   film orientation options
70              --portrait
71                set portrait orientation
72
73              --landscape
74                set landscape orientation
75
76              --default-orientation
77                use printer default (default)
78
79   trim (border) options
80              --trim
81                set trim on
82
83              --no-trim
84                set trim off
85
86              --default-trim
87                use printer default (default)
88
89   requested decimate/crop behavior options
90              --request-decimate
91                request decimate
92
93              --request-crop
94                request crop
95
96              --request-fail
97                request failure
98
99              --default-request
100                use printer default (default)
101
102   print presentation LUT options
103              --default-plut
104                do not create presentation LUT (default)
105
106              --identity
107                set IDENTITY presentation LUT shape
108
109              --plut  [l]ut identifier: string
110                add LUT l to print job
111
112              --inverse-plut
113                render the inverse presentation LUT into the
114                bitmap of the hardcopy grayscale image
115
116              --illumination  [v]alue: integer (0..65535)
117                set illumination to v (in cd/m^2)
118
119              --reflection  [v]alue: integer (0..65535)
120                set reflected ambient light to v (in cd/m^2)
121
122   basic film session options (only with –spool)
123              --copies  [v]alue: integer (1..100, default: 1)
124                set number of copies to v
125
126              --medium-type  [v]alue: string
127                set medium type to v
128
129              --destination  [v]alue: string
130                set film destination to v
131
132              --label  [v]alue: string
133                set film session label to v
134
135              --priority  [v]alue: string
136                set print priority to v
137
138              --owner  [v]alue: string
139                set film session owner ID to v
140
141   annotation options
142              --no-annotation
143                do not create annotation (default)
144
145         -a   --annotation  [t]ext: string
146                create annotation with text t
147
148         +pd  --print-date
149                prepend date/time to annotation (default)
150
151         -pd  --print-no-date
152                do not prepend date/time to annotation
153
154         +pn  --print-name
155                prepend printer name to annotation (default)
156
157         -pn  --print-no-name
158                do not prepend printer name to annotation
159
160         +pl  --print-lighting
161                prepend illumination to annotation (default)
162
163         -pl  --print-no-lighting
164                do not prepend illumination to annotation
165
166   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
170         +Og  --ovl-graylevel  [v]alue: integer (0..4095)
171                use overlay gray level v (default: 4095 = white)
172
173   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
179              --magnification  [v]alue: string
180                set magnification type to v
181
182              --smoothing  [v]alue: string
183                set smoothing type to v
184
185              --configinfo  [v]alue: string
186                set configuration information to v
187
188              --resolution  [v]alue: string
189                set requested resolution ID to v
190
191              --border  [v]alue: string
192                set border density to v
193
194              --empty-image  [v]alue: string
195                set empty image density to v
196
197              --max-density  [v]alue: string
198                set max density to v
199
200              --min-density  [v]alue: string
201                set min density to v
202
203              --img-polarity  [v]alue: string
204                set image box polarity to v (NORMAL or REVERSE)
205
206              --img-request-size  [v]alue: string
207                set requested image size to v (width in mm)
208
209              --img-magnification  [v]alue: string
210                set image box magnification type to v
211
212              --img-smoothing  [v]alue: string
213                set image box smoothing type to v
214
215              --img-configinfo  [v]alue: string
216                set image box configuration information to v
217

LOGGING

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
230       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

COMMAND LINE

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
244       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
251       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

ENVIRONMENT

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
268       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

FILES

278       <etcdir>/dcmpstat.cfg,  <etcdir>/printers.cfg  -  sample  configuration
279       files
280

SEE ALSO

282       dcmprscu(1)
283
285       Copyright (C) 1999-2022 by OFFIS e.V., Escherweg  2,  26121  Oldenburg,
286       Germany.
287
288
289
290Version 3.6.7                   Fri Apr 22 2022                    dcmpsprt(1)
Impressum