/usr/bin/dcmscale

$dcmtk: dcmscale v3.7.1 2026-10-15 $

dcmscale: Scale DICOM images
usage: dcmscale [options] dcmfile-in dcmfile-out

parameters:
  dcmfile-in                     DICOM input filename to be scaled
                                 ("-" for stdin)
  dcmfile-out                    DICOM output filename to be written
                                 ("-" for stdout)

general options:
  -h      --help                 print this help text and exit
          --version              print version information and exit
          --arguments            print expanded command line arguments
  -q      --quiet                quiet mode, print no warnings and errors
  -v      --verbose              verbose mode, print processing details
  -d      --debug                debug mode, print debug information
  -ll     --log-level            [l]evel: string constant
                                 (fatal, error, warn, info, debug, trace)
                                 use level l for the logger
  -lc     --log-config           [f]ilename: string
                                 use config file f for the logger
input options:
  input file format:
    +f    --read-file            read file format or data set (default)
    +fo   --read-file-only       read file format only
    -f    --read-dataset         read data set without file meta information
  input transfer syntax:
    -t=   --read-xfer-auto       use TS recognition (default)
    -td   --read-xfer-detect     ignore TS specified in the file meta header
    -te   --read-xfer-little     read with explicit VR little endian TS
    -tb   --read-xfer-big        read with explicit VR big endian TS
    -ti   --read-xfer-implicit   read with implicit VR little endian TS
image processing and encoding options:
  scaling:
    +a    --recognize-aspect     recognize pixel aspect ratio when scaling (def)
    -a    --ignore-aspect        ignore pixel aspect ratio when scaling
    +i    --interpolate          [n]umber of algorithm: integer
                                 use interpolation when scaling (1..4, def: 1)
    -i    --no-interpolation     no interpolation when scaling
    -S    --no-scaling           no scaling, ignore pixel aspect ratio (default)
    +Sxf  --scale-x-factor       [f]actor: float
                                 scale x axis by factor, auto-compute y axis
    +Syf  --scale-y-factor       [f]actor: float
                                 scale y axis by factor, auto-compute x axis
    +Sxv  --scale-x-size         [n]umber: integer
                                 scale x axis to n pixels, auto-compute y axis
    +Syv  --scale-y-size         [n]umber: integer
                                 scale y axis to n pixels, auto-compute x axis
  other transformations:
    +C    --clip-region          [l]eft [t]op [w]idth [h]eight: integer
                                 clip rectangular image region (l, t, w, h)
  SOP Instance UID:
    +ua   --uid-always           always assign new SOP Instance UID (default)
    +un   --uid-never            never assign new SOP Instance UID
output options:
  output file format:
    +F    --write-file           write file format (default)
    -F    --write-dataset        write data set without file meta information
  output transfer syntax:
    +t=   --write-xfer-same      write with same TS as input (default)
    +te   --write-xfer-little    write with explicit VR little endian TS
    +tb   --write-xfer-big       write with explicit VR big endian TS
    +ti   --write-xfer-implicit  write with implicit VR little endian TS
  post-1993 value representations:
    +u    --enable-new-vr        enable support for new VRs (UN/UT) (default)
    -u    --disable-new-vr       disable support for new VRs, convert to OB
  group length encoding:
    +g=   --group-length-recalc  recalculate group lengths if present (default)
    +g    --group-length-create  always write with group length elements
    -g    --group-length-remove  always write without group length elements
  length encoding in sequences and items:
    +e    --length-explicit      write with explicit lengths (default)
    -e    --length-undefined     write with undefined lengths
  data set trailing padding (not with --write-dataset):
    -p=   --padding-retain       do not change padding
                                 (default if not --write-dataset)
    -p    --padding-off          no padding (implicit if --write-dataset)
    +p    --padding-create       [f]ile-pad [i]tem-pad: integer
                                 align file on multiple of f bytes
                                 and items on multiple of i bytes