/usr/bin/dcmcjpeg

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

dcmcjpeg: Encode DICOM file to JPEG transfer syntax
usage: dcmcjpeg [options] dcmfile-in dcmfile-out

parameters:
  dcmfile-in                     DICOM input filename to be converted
                                 ("-" for stdin)
  dcmfile-out                    DICOM output filename
                                 ("-" 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
  compatibility (ignored by +tl):
    +Ma   --accept-acr-nema      accept ACR-NEMA images without photometric
                                 interpretation
    +Mp   --accept-palettes      accept incorrect palette attribute tags
                                 (0028,111x) and (0028,121x)
JPEG encoding options:
  JPEG process:
    +e1   --encode-lossless-sv1  encode lossless sv1 (default)
    +el   --encode-lossless      encode lossless
    +eb   --encode-baseline      encode baseline
    +ee   --encode-extended      encode extended sequential
    +es   --encode-spectral      encode spectral selection
    +ep   --encode-progressive   encode progressive
  lossless JPEG codec selection:
    +tl   --true-lossless        true lossless codec (default)
    +pl   --pseudo-lossless      old pseudo-lossless codec
  lossless JPEG representation:
    +sv   --selection-value      [sv]: integer (1..7, default: 6)
                                 use selection value sv
                                 only with --encode-lossless
    +pt   --point-transform      [pt]: integer (0..15, default: 0)
                                 use point transform pt
  lossy JPEG representation:
    +q    --quality              [q]: integer (0..100, default: 90)
                                 use quality factor q
    +sm   --smooth               [s]: integer (0..100, default: 0)
                                 use smoothing factor s
  other JPEG options:
    +ho   --huffman-optimize     optimize huffman tables (default)
    -ho   --huffman-standard     use standard huffman tables if 8 bits/sample
  compressed bits per sample (always +ba with +tl):
    +ba   --bits-auto            choose bits/sample automatically (default)
    +be   --bits-force-8         force 8 bits/sample
    +bt   --bits-force-12        force 12 bits/sample (not with baseline)
    +bs   --bits-force-16        force 16 bits/sample (lossless only)
  compression color space conversion (overridden by +tl):
    +cy   --color-ybr            use YCbCr for color images if lossy (default)
    +cr   --color-rgb            use RGB for color images if lossy
    +cm   --monochrome           convert color images to monochrome
  decompr. color space conversion (if input is compressed; always +cn with +tl):
    +cp   --conv-photometric     convert if YCbCr photometric interpr. (default)
    +cl   --conv-lossy           convert YCbCr to RGB if lossy JPEG
    +cg   --conv-guess           convert to RGB if YCbCr is guessed by library
    +cgl  --conv-guess-lossy     convert to RGB if lossy JPEG and YCbCr is
                                 guessed by the underlying JPEG library
    +ca   --conv-always          always convert YCbCr to RGB
    +cn   --conv-never           never convert color space
  decompr. workaround options for incorrect encodings (if input is compressed):
    +w6   --workaround-pred6     enable workaround for JPEG lossless images
                                 with overflow in predictor 6
    +wi   --workaround-incpl     enable workaround for incomplete JPEG data
    +wc   --workaround-cornell   enable workaround for 16-bit JPEG lossless
                                 Cornell images with Huffman table overflow
  YCbCr component subsampling (lossy JPEG only):
    +s2   --sample-422           4:2:2 subsampling with YBR_FULL_422 (default)
  non-standard YCbCr component subsampling (lossy JPEG only):
    +s4   --nonstd-444           4:4:4 sampling with YBR_FULL
    +n2   --nonstd-422-full      4:2:2 subsampling with YBR_FULL
    +n1   --nonstd-411-full      4:1:1 subsampling with YBR_FULL
    +np   --nonstd-411           4:1:1 subsampling with YBR_FULL_422
encapsulated pixel data encoding options:
  pixel data fragmentation:
    +ff   --fragment-per-frame   encode each frame as one fragment (default)
    +fs   --fragment-size        [s]ize: integer
                                 limit fragment size to s kbytes
  basic offset table encoding:
    +ot   --offset-table-create  create offset table (default)
    -ot   --offset-table-empty   leave offset table empty
  icon image encoding:
    +ic   --icon-compressed      compress icon images (default)
    +iu   --icon-uncompressed    keep icon images uncompressed
  VOI windowing for monochrome images (not with +tl):
    -W    --no-windowing         no VOI windowing (default)
    +Wi   --use-window           [n]umber: integer
                                 use the n-th VOI window from image file
    +Wl   --use-voi-lut          [n]umber: integer
                                 use the n-th VOI look up table from image file
    +Wm   --min-max-window       compute VOI window using min-max algorithm
    +Wn   --min-max-window-n     compute VOI window using min-max algorithm,
                                 ignoring extreme values
    +Wr   --roi-min-max-window   [l]eft [t]op [w]idth [h]eight: integer
                                 compute ROI window using min-max algorithm,
                                 region of interest is specified by l,t,w,h
    +Wh   --histogram-window     [n]umber: integer
                                 compute VOI window using Histogram algorithm,
                                 ignoring n percent
    +Ww   --set-window           [c]enter [w]idth: float
                                 compute VOI window using center c and width w
  pixel scaling for monochrome images (-W; ignored by +tl):
    +sp   --scaling-pixel        scale using min/max pixel value (default)
    +sr   --scaling-range        scale using min/max range
  rescale slope/intercept encoding for monochrome (-W; ignored by +tl):
    +ri   --rescale-identity     encode identity modality rescale (default)
                                 Never used for CT images
    +rm   --rescale-map          use modality rescale to scale pixel range
                                 Never used for XA/RF/XA Biplane images
  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:
    +ud   --uid-default          assign new UID if lossy compression (default)
    +ua   --uid-always           always assign new UID
    +un   --uid-never            never assign new UID
output options:
  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:
    -p=   --padding-retain       do not change padding (default)
    -p    --padding-off          no padding
    +p    --padding-create       [f]ile-pad [i]tem-pad: integer
                                 align file on multiple of f bytes
                                 and items on multiple of i bytes