1dcmscale(1) OFFIS DCMTK dcmscale(1)
2
6 dcmscale - Scale DICOM images
7
10 dcmscale [options] dcmfile-in dcmfile-out
11
13 The dcmscale utility reads a DICOM image, scales it according to the
14 command line settings and writes back the DICOM image. This utility
15 only supports uncompressed and RLE compressed DICOM images.
16
18 dcmfile-in DICOM input filename to be scaled
19 dcmfile-out DICOM output filename to be written
21
23 general options
24 -h --help
25 print this help text and exit
26 --version
28 print version information and exit
29 --arguments
31 print expanded command line arguments
32 -q --quiet
34 quiet mode, print no warnings and errors
35 -v --verbose
37 verbose mode, print processing details
38 -d --debug
40 debug mode, print debug information
41 -ll --log-level [l]evel: string constant
43 (fatal, error, warn, info, debug, trace)
44 use level l for the logger
45 -lc --log-config [f]ilename: string
47 use config file f for the logger
48 input options
50 input file format:
51 +f --read-file
53 read file format or data set (default)
54 +fo --read-file-only
56 read file format only
57 -f --read-dataset
59 read data set without file meta information
60 input transfer syntax:
62 -t= --read-xfer-auto
64 use TS recognition (default)
65 -td --read-xfer-detect
67 ignore TS specified in the file meta header
68 -te --read-xfer-little
70 read with explicit VR little endian TS
71 -tb --read-xfer-big
73 read with explicit VR big endian TS
74 -ti --read-xfer-implicit
76 read with implicit VR little endian TS
77 image processing and encoding options
79 scaling:
80 +a --recognize-aspect
82 recognize pixel aspect ratio when scaling (default)
83 -a --ignore-aspect
85 ignore pixel aspect ratio when scaling
86 +i --interpolate [n]umber of algorithm: integer
88 use interpolation when scaling (1..4, default: 1)
89 -i --no-interpolation
91 no interpolation when scaling
92 -S --no-scaling
94 no scaling, ignore pixel aspect ratio (default)
95 +Sxf --scale-x-factor [f]actor: float
97 scale x axis by factor, auto-compute y axis
98 +Syf --scale-y-factor [f]actor: float
100 scale y axis by factor, auto-compute x axis
101 +Sxv --scale-x-size [n]umber: integer
103 scale x axis to n pixels, auto-compute y axis
104 +Syv --scale-y-size [n]umber: integer
106 scale y axis to n pixels, auto-compute x axis
107 other transformations:
109 +C --clip-region [l]eft [t]op [w]idth [h]eight: integer
111 clip rectangular image region (l, t, w, h)
112 SOP Instance UID:
114 +ua --uid-always
116 always assign new SOP Instance UID (default)
117 +un --uid-never
119 never assign new SOP Instance UID
120 output options
122 output file format:
123 +F --write-file
125 write file format (default)
126 -F --write-dataset
128 write data set without file meta information
129 output transfer syntax:
131 +t= --write-xfer-same
133 write with same TS as input (default)
134 +te --write-xfer-little
136 write with explicit VR little endian TS
137 +tb --write-xfer-big
139 write with explicit VR big endian TS
140 +ti --write-xfer-implicit
142 write with implicit VR little endian TS
143 post-1993 value representations:
145 +u --enable-new-vr
147 enable support for new VRs (UN/UT) (default)
148 -u --disable-new-vr
150 disable support for new VRs, convert to OB
151 group length encoding:
153 +g= --group-length-recalc
155 recalculate group lengths if present (default)
156 +g --group-length-create
158 always write with group length elements
159 -g --group-length-remove
161 always write without group length elements
162 length encoding in sequences and items:
164 +e --length-explicit
166 write with explicit lengths (default)
167 -e --length-undefined
169 write with undefined lengths
170 data set trailing padding (not with --write-dataset):
172 -p= --padding-retain
174 do not change padding
175 (default if not --write-dataset)
176 -p --padding-off
178 no padding (implicit if --write-dataset)
179 +p --padding-create [f]ile-pad [i]tem-pad: integer
181 align file on multiple of f bytes and items on
182 multiple of i bytes
183
185 The following preferred interpolation algorithms can be selected using
186 the --interpolate option:
187 • 1 = free scaling algorithm with interpolation from pbmplus toolkit
189 • 2 = free scaling algorithm with interpolation from c't magazine
190 • 3 = magnification algorithm with bilinear interpolation from Eduard
191 Stanescu
192 • 4 = magnification algorithm with bicubic interpolation from Eduard
193 Stanescu
195 The level of logging output of the various command line tools and
196 underlying libraries can be specified by the user. By default, only
197 errors and warnings are written to the standard error stream. Using
198 option --verbose also informational messages like processing details
199 are reported. Option --debug can be used to get more details on the
200 internal activity, e.g. for debugging purposes. Other logging levels
201 can be selected using option --log-level. In --quiet mode only fatal
202 errors are reported. In such very severe error events, the application
203 will usually terminate. For more details on the different logging
204 levels, see documentation of module 'oflog'.
205 In case the logging output should be written to file (optionally with
206 logfile rotation), to syslog (Unix) or the event log (Windows) option
207 --log-config can be used. This configuration file also allows for
208 directing only certain messages to a particular output stream and for
209 filtering certain messages based on the module or application where
210 they are generated. An example configuration file is provided in
211 <etcdir>/logger.cfg.
213 All command line tools use the following notation for parameters:
214 square brackets enclose optional values (0-1), three trailing dots
215 indicate that multiple values are allowed (1-n), a combination of both
216 means 0 to n values.
217 Command line options are distinguished from parameters by a leading '+'
218 or '-' sign, respectively. Usually, order and position of command line
219 options are arbitrary (i.e. they can appear anywhere). However, if
220 options are mutually exclusive the rightmost appearance is used. This
221 behavior conforms to the standard evaluation rules of common Unix
222 shells.
223 In addition, one or more command files can be specified using an '@'
224 sign as a prefix to the filename (e.g. @command.txt). Such a command
225 argument is replaced by the content of the corresponding text file
226 (multiple whitespaces are treated as a single separator unless they
227 appear between two quotation marks) prior to any further evaluation.
228 Please note that a command file cannot contain another command file.
229 This simple but effective approach allows one to summarize common
230 combinations of options/parameters and avoids longish and confusing
231 command lines (an example is provided in file <datadir>/dumppat.txt).
233 The dcmscale utility will attempt to load DICOM data dictionaries
234 specified in the DCMDICTPATH environment variable. By default, i.e. if
235 the DCMDICTPATH environment variable is not set, the file
236 <datadir>/dicom.dic will be loaded unless the dictionary is built into
237 the application (default for Windows).
238 The default behavior should be preferred and the DCMDICTPATH
239 environment variable only used when alternative data dictionaries are
240 required. The DCMDICTPATH environment variable has the same format as
241 the Unix shell PATH variable in that a colon (':') separates entries.
242 On Windows systems, a semicolon (';') is used as a separator. The data
243 dictionary code will attempt to load each file specified in the
244 DCMDICTPATH environment variable. It is an error if no data dictionary
245 can be loaded.
247 Copyright (C) 2002-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
248 Germany.
249Version 3.6.7 Fri Apr 22 2022 dcmscale(1)