dcml2pnm --version (return code: 0)
$dcmtk: dcml2pnm v3.6.2 2017-07-14 $
dcml2pnm: Convert DICOM images to PGM/PPM, PNG, TIFF or BMP
Host type: Debian
Character encoding: US-ASCII
External libraries used:
- ZLIB, Version 1.2.11
- CharLS, Version 1.0 (modified)
- LIBTIFF, Version 4.0.8
with LZW compression support
- LIBPNG, Version 1.6.32
dcml2pnm --help (return code: 0)
$dcmtk: dcml2pnm v3.6.2 2017-07-14 $
dcml2pnm: Convert DICOM images to PGM/PPM, PNG, TIFF or BMP
usage: dcml2pnm [options] dcmfile-in [bitmap-out]
parameters:
dcmfile-in DICOM input filename to be converted
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 (default)
-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
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
other transformations:
+G --grayscale convert to grayscale if necessary
+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:
+op --write-raw-pnm write 8-bit binary PGM/PPM (default for files)
+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