/usr/bin/dcmquant

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

dcmquant: Convert DICOM color images to palette color
usage: dcmquant [options] dcmfile-in dcmfile-out

parameters:
  dcmfile-in                    DICOM input filename to be converted
                                ("-" 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:
  frame selection:
    +fr  --frame                [n]umber: integer
                                select specified frame
    +fa  --all-frames           select all frames (default)
  compatibility:
    +Mp  --accept-palettes      accept incorrect palette attribute tags
                                (0028,111x) and (0028,121x)
  median cut dimension selection:
    +Dr  --mc-dimension-rgb     max dimension from RGB range (default)
    +Dl  --mc-dimension-lum     max dimension from luminance
  median cut representative color selection:
    +Cb  --mc-color-avgbox      average colors in box (default)
    +Cp  --mc-color-avgpixel    average pixels in box
    +Cc  --mc-color-center      select center of box
  color palette value representation:
    +pw  --write-ow             write Palette LUT as OW (default)
    +pu  --write-us             write Palette LUT as US (retired)
  color palette creation:
    +pe  --lut-entries-word     write Palette LUT with 16-bit entries
    +pf  --floyd-steinberg      use Floyd-Steinberg error diffusion
    +pc  --colors               number of colors: 2..65536 (default 256)
                                number of colors to quantize to
  SOP Class UID:
    +cd  --class-default        keep SOP Class UID (default)
    +cs  --class-sc             convert to Secondary Capture Image
                                (implies --uid-always)
  SOP Instance UID:
    +ua  --uid-always           always assign new UID (default)
    +un  --uid-never            never assign new 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