dcmcjpeg --version (return code: 0)
$dcmtk: dcmcjpeg v3.6.2 2017-07-14 $
dcmcjpeg: Encode DICOM file to JPEG transfer syntax
Host type: Debian
Character encoding: US-ASCII
External libraries used:
- ZLIB, Version 1.2.11
- IJG, Version 6b 27-Mar-1998 (modified)
dcmcjpeg --help (return code: 0)
$dcmtk: dcmcjpeg v3.6.2 2017-07-14 $
dcmcjpeg: Encode DICOM file to JPEG transfer syntax
usage: dcmcjpeg [options] dcmfile-in dcmfile-out
parameters:
dcmfile-in DICOM input filename to be converted
dcmfile-out DICOM output filename
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
standard YCbCr component subsampling (not with +tl):
+s4 --sample-444 4:4:4 sampling with YBR_FULL (default)
+s2 --sample-422 4:2:2 subsampling with YBR_FULL_422
non-standard YCbCr component subsampling (not with +tl):
+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
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