W: ########################################################################## W: # # W: # dcm2pnm is deprecated, use dcm2img instead! # W: # # W: ########################################################################## $dcmtk: dcm2img v3.7.1 2026-10-15 $ dcm2img: Convert DICOM image to standard image format usage: dcm2img [options] dcmfile-in [bitmap-out] parameters: dcmfile-in DICOM input filename to be converted ("-" for stdin) bitmap-out output filename to be written (default: 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 options: frame selection: +F --frame [n]umber: integer select specified frame (default: 1) +Fr --frame-range [n]umber [c]ount: integer select c frames beginning with frame n +Fa --all-frames select all frames rotation: +Rl --rotate-left rotate image left (-90 degrees) +Rr --rotate-right rotate image right (+90 degrees) +Rtd --rotate-top-down rotate image top-down (180 degrees) flipping: +Lh --flip-horizontally flip image horizontally +Lv --flip-vertically flip image vertically +Lhv --flip-both-axes flip image horizontally and vertically 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 color space conversion (JPEG compressed images only): +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 bits stored: +bs --bits-stored-fix correct inconsistent bits stored value (default) -bs --bits-stored-keep preserve inconsistent bits stored value workaround options for incorrect encodings (JPEG compressed images only): +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 modality LUT transformation: -M --no-modality ignore stored modality LUT transformation +M --use-modality use modality LUT transformation (default) VOI LUT transformation: -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 +Wfl --linear-function set VOI LUT function to LINEAR +Wfs --sigmoid-function set VOI LUT function to SIGMOID presentation LUT transformation: +Pid --identity-shape set presentation LUT shape to IDENTITY +Piv --inverse-shape set presentation LUT shape to INVERSE +Pod --lin-od-shape set presentation LUT shape to LIN OD overlay: -O --no-overlays do not display overlays +O --display-overlay [n]umber: integer display overlay n (0..16, 0=all, default: +O 0) +Omr --ovl-replace use overlay mode "Replace" (default for Graphic overlays) +Omt --ovl-threshold use overlay mode "Threshold Replace" +Omc --ovl-complement use overlay mode "Complement" +Omv --ovl-invert use overlay mode "Invert Bitmap" +Omi --ovl-roi use overlay mode "Region of Interest" (default for ROI overlays) +Osf --set-foreground [d]ensity: float set overlay foreground density (0..1, def: 1) +Ost --set-threshold [d]ensity: float set overlay threshold density (0..1, def: 0.5) display LUT transformation: +Dm --monitor-file [f]ilename: string calibrate output according to monitor characteristics defined in f +Dp --printer-file [f]ilename: string calibrate output according to printer characteristics defined in f +Da --ambient-light [a]mbient light: float ambient light value (cd/m^2, default: file f) +Di --illumination [i]llumination: float illumination value (cd/m^2, default: file f) +Dn --min-density [m]inimum optical density: float Dmin value (default: off, only with +Dp) +Dx --max-density [m]aximum optical density: float Dmax value (default: off, only with +Dp) +Dg --gsd-function use GSDF for calibration (default for +Dm/+Dp) +Dc --cielab-function use CIELAB function for calibration compatibility: +Ma --accept-acr-nema accept ACR-NEMA images without photometric interpretation +Mp --accept-palettes accept incorrect palette attribute tags (0028,111x) and (0028,121x) +Mc --check-lut-depth check 3rd value of the LUT descriptor, compare with expected bit depth based on LUT data +Mm --ignore-mlut-depth ignore 3rd value of the modality LUT descriptor, determine bits per table entry automatically +Mv --ignore-vlut-depth ignore 3rd value of the VOI LUT descriptor, determine bits per table entry automatically TIFF format: +Tl --compr-lzw LZW compression (default) +Tr --compr-rle RLE compression +Tn --compr-none uncompressed +Pd --predictor-default no LZW predictor (default) +Pn --predictor-none LZW predictor 1 (no prediction) +Ph --predictor-horz LZW predictor 2 (horizontal differencing) +Rs --rows-per-strip [r]ows: integer (default: 0) rows per strip, default 8K per strip PNG format: +il --interlace create interlaced file (default) -il --nointerlace create non-interlaced file +mf --meta-file create PNG file meta information (default) -mf --meta-none no PNG file meta information JPEG format: +Jq --compr-quality [q]uality: integer (0..100, default: 90) quality value for compression (in percent) +Js4 --sample-444 4:4:4 sampling (no subsampling) +Js2 --sample-422 4:2:2 subsampling (horizontal subsampling of chroma components, default) +Js1 --sample-411 4:1:1 subsampling (horizontal and vertical subsampling of chroma components) JPEG-LS format: +Trl --rendered-lossless lossless compression of rendered image (default) +Tll --true-lossless lossless compression of raw image +f8 --force-8-bit force output bit depth to 8 bits (not with --true-lossless) other transformations: +G --grayscale convert color image to grayscale (monochrome) +P --change-polarity change polarity (invert pixel output) +C --clip-region [l]eft [t]op [w]idth [h]eight: integer clip image region (l, t, w, h) output options: general: -im --image-info print image details (requires verbose mode) -o --no-output do not create any output (useful with -im) filename generation (only with --frame-range or --all-frames): +Fc --use-frame-counter use 0-based counter for filenames (default) +Fn --use-frame-number use absolute frame number for filenames image format: +oa --write-auto determine file format from filename extension (default for files) +op --write-raw-pnm write 8-bit binary PGM/PPM +opb --write-8-bit-pnm write 8-bit ASCII PGM/PPM (default for stdout) +opw --write-16-bit-pnm write 16-bit ASCII PGM/PPM +opn --write-n-bit-pnm [n]umber: integer write n-bit ASCII PGM/PPM (1..32) +ob --write-bmp write 8-bit (monochrome) or 24-bit (color) BMP +obp --write-8-bit-bmp write 8-bit palette BMP (monochrome only) +obt --write-24-bit-bmp write 24-bit truecolor BMP +obr --write-32-bit-bmp write 32-bit truecolor BMP +ot --write-tiff write 8-bit (monochrome) or 24-bit (color) TIFF +on --write-png write 8-bit (monochrome) or 24-bit (color) PNG +on2 --write-16-bit-png write 16-bit (monochrome) or 48-bit (color) PNG +oj --write-jpeg write 8-bit lossy JPEG (baseline) +ol --write-jpls write JPEG-LS