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

NAME

6       dcmscale - Scale DICOM images
7

SYNOPSIS

9       dcmscale [options] dcmfile-in dcmfile-out
10

DESCRIPTION

12       The  dcmscale  utility  reads a DICOM image, scales it according to the
13       command line settings and writes back the  DICOM  image.  This  utility
14       only supports uncompressed and RLE compressed DICOM images.
15

PARAMETERS

17       dcmfile-in   DICOM input filename to be scaled
18
19       dcmfile-out  DICOM output filename to be written
20

OPTIONS

22   general options
23         -h    --help
24                 print this help text and exit
25
26               --version
27                 print version information and exit
28
29               --arguments
30                 print expanded command line arguments
31
32         -q    --quiet
33                 quiet mode, print no warnings and errors
34
35         -v    --verbose
36                 verbose mode, print processing details
37
38         -d    --debug
39                 debug mode, print debug information
40
41         -ll   --log-level  [l]evel: string constant
42                 (fatal, error, warn, info, debug, trace)
43                 use level l for the logger
44
45         -lc   --log-config  [f]ilename: string
46                 use config file f for the logger
47
48   input options
49       input file format:
50
51         +f    --read-file
52                 read file format or data set (default)
53
54         +fo   --read-file-only
55                 read file format only
56
57         -f    --read-dataset
58                 read data set without file meta information
59
60       input transfer syntax:
61
62         -t=   --read-xfer-auto
63                 use TS recognition (default)
64
65         -td   --read-xfer-detect
66                 ignore TS specified in the file meta header
67
68         -te   --read-xfer-little
69                 read with explicit VR little endian TS
70
71         -tb   --read-xfer-big
72                 read with explicit VR big endian TS
73
74         -ti   --read-xfer-implicit
75                 read with implicit VR little endian TS
76
77   processing options
78       scaling:
79
80         +a    --recognize-aspect
81                 recognize pixel aspect ratio (default)
82
83         -a    --ignore-aspect
84                 ignore pixel aspect ratio when scaling
85
86         +i    --interpolate  [n]umber of algorithm: integer
87                 use interpolation when scaling (1..4, default: 1)
88
89         -i    --no-interpolation
90                 no interpolation when scaling
91
92         -S    --no-scaling
93                 no scaling, ignore pixel aspect ratio (default)
94
95         +Sxf  --scale-x-factor  [f]actor: float
96                 scale x axis by factor, auto-compute y axis
97
98         +Syf  --scale-y-factor  [f]actor: float
99                 scale y axis by factor, auto-compute x axis
100
101         +Sxv  --scale-x-size  [n]umber: integer
102                 scale x axis to n pixels, auto-compute y axis
103
104         +Syv  --scale-y-size  [n]umber: integer
105                 scale y axis to n pixels, auto-compute x axis
106
107       other transformations:
108         +C    --clip-region  [l]eft [t]op [w]idth [h]eight: integer
109                 clip rectangular image region (l, t, w, h)
110
111       SOP Instance UID:
112
113         +ua   --uid-always
114                 always assign new SOP Instance UID (default)
115
116         +un   --uid-never
117                 never assign new SOP Instance UID
118
119   output options
120       output file format:
121
122         +F    --write-file
123                 write file format (default)
124
125         -F    --write-dataset
126                 write data set without file meta information
127
128       output transfer syntax:
129
130         +t=   --write-xfer-same
131                 write with same TS as input (default)
132
133         +te   --write-xfer-little
134                 write with explicit VR little endian TS
135
136         +tb   --write-xfer-big
137                 write with explicit VR big endian TS
138
139         +ti   --write-xfer-implicit
140                 write with implicit VR little endian TS
141
142       post-1993 value representations:
143
144         +u    --enable-new-vr
145                 enable support for new VRs (UN/UT) (default)
146
147         -u    --disable-new-vr
148                 disable support for new VRs, convert to OB
149
150       group length encoding:
151
152         +g=   --group-length-recalc
153                 recalculate group lengths if present (default)
154
155         +g    --group-length-create
156                 always write with group length elements
157
158         -g    --group-length-remove
159                 always write without group length elements
160
161       length encoding in sequences and items:
162
163         +e    --length-explicit
164                 write with explicit lengths (default)
165
166         -e    --length-undefined
167                 write with undefined lengths
168
169       data set trailing padding (not with --write-dataset):
170
171         -p=   --padding-retain
172                 do not change padding
173                 (default if not --write-dataset)
174
175         -p    --padding-off
176                 no padding (implicit if --write-dataset)
177
178         +p    --padding-create  [f]ile-pad [i]tem-pad: integer
179                 align file on multiple of f bytes and items on
180                 multiple of i bytes
181

NOTES

183       The  following preferred interpolation algorithms can be selected using
184       the --interpolate option:
185
186       · 1 = free scaling algorithm with interpolation from pbmplus toolkit
187       · 2 = free scaling algorithm with interpolation from c't magazine
188       · 3 = magnification algorithm with bilinear interpolation  from  Eduard
189         Stanescu
190       · 4  =  magnification  algorithm with bicubic interpolation from Eduard
191         Stanescu

LOGGING

193       The level of logging output of  the  various  command  line  tools  and
194       underlying  libraries  can  be  specified by the user. By default, only
195       errors and warnings are written to the  standard  error  stream.  Using
196       option  --verbose  also  informational messages like processing details
197       are reported. Option --debug can be used to get  more  details  on  the
198       internal  activity,  e.g.  for debugging purposes. Other logging levels
199       can be selected using option --log-level. In --quiet  mode  only  fatal
200       errors  are reported. In such very severe error events, the application
201       will usually terminate. For  more  details  on  the  different  logging
202       levels, see documentation of module 'oflog'.
203       In  case  the logging output should be written to file (optionally with
204       logfile rotation), to syslog (Unix) or the event log  (Windows)  option
205       --log-config  can  be  used.  This  configuration  file also allows for
206       directing only certain messages to a particular output stream  and  for
207       filtering  certain  messages  based  on the module or application where
208       they are generated.  An  example  configuration  file  is  provided  in
209       <etcdir>/logger.cfg).

COMMAND LINE

211       All  command  line  tools  use  the  following notation for parameters:
212       square brackets enclose optional  values  (0-1),  three  trailing  dots
213       indicate  that multiple values are allowed (1-n), a combination of both
214       means 0 to n values.
215       Command line options are distinguished from parameters by a leading '+'
216       or  '-' sign, respectively. Usually, order and position of command line
217       options are arbitrary (i.e. they  can  appear  anywhere).  However,  if
218       options  are  mutually exclusive the rightmost appearance is used. This
219       behaviour conforms to the standard  evaluation  rules  of  common  Unix
220       shells.
221       In  addition,  one  or more command files can be specified using an '@'
222       sign as a prefix to the filename (e.g. @command.txt).  Such  a  command
223       argument  is  replaced  by  the  content of the corresponding text file
224       (multiple whitespaces are treated as a  single  separator  unless  they
225       appear  between  two  quotation marks) prior to any further evaluation.
226       Please note that a command file cannot contain  another  command  file.
227       This   simple   but  effective  approach  allows  to  summarize  common
228       combinations of options/parameters and  avoids  longish  and  confusing
229       command lines (an example is provided in file <datadir>/dumppat.txt).

ENVIRONMENT

231       The  dcmscale  utility  will  attempt  to  load DICOM data dictionaries
232       specified in the DCMDICTPATH environment variable. By default, i.e.  if
233       the   DCMDICTPATH   environment   variable   is   not   set,  the  file
234       <datadir>/dicom.dic will be loaded unless the dictionary is built  into
235       the application (default for Windows).
236       The   default   behaviour  should  be  preferred  and  the  DCMDICTPATH
237       environment variable only used when alternative data  dictionaries  are
238       required.  The  DCMDICTPATH environment variable has the same format as
239       the Unix shell PATH variable in that a colon (':')  separates  entries.
240       On  Windows systems, a semicolon (';') is used as a separator. The data
241       dictionary code will  attempt  to  load  each  file  specified  in  the
242       DCMDICTPATH  environment variable. It is an error if no data dictionary
243       can be loaded.
245       Copyright (C) 2002-2010 by OFFIS e.V., Escherweg  2,  26121  Oldenburg,
246       Germany.
247
248
249
250Version 3.6.0                     6 Jan 2011                       dcmscale(1)
Impressum