OS Manuals

/usr/bin/dcmpsprt

DCMTK is a collection of libraries and applications implementing large parts the DICOM standard.

From dcmtk 3.7.1-r0 (os), captured 2026-11-05 by running dcmpsprt --help (exit 0). permalink

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

dcmpsprt: Read DICOM images and presentation states and render print job
usage: dcmpsprt [options] dcmfile-in...

parameters:
  dcmfile-in                   DICOM image file(s) to be printed ("-" for stdin)

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
processing options:
  +p    --pstate               [p]state file: string
                               render the following image with pres. state p
                               (this option can be specified multiple times)
  -c    --config               [f]ilename: string
                               process using settings from configuration file f
  -p    --printer              [n]ame: string (default: 1st printer in cfg file)
                               select printer with identifier n from cfg file
spooling options:
  -s    --spool                spool print job to DICOM printer
        --nospool              do not spool print job to DICOM printer (default)
film orientation options:
        --portrait             set portrait orientation
        --landscape            set landscape orientation
        --default-orientation  use printer default (default)
trim (border) options:
        --trim                 set trim on
        --no-trim              set trim off
        --default-trim         use printer default (default)
requested decimate/crop behaviour options:
        --request-decimate     request decimate
        --request-crop         request crop
        --request-fail         request failure
        --default-request      use printer default (default)
print presentation LUT options:
        --default-plut         do not create presentation LUT (default)
        --identity             set IDENTITY presentation LUT shape
        --lin-od               set LIN OD presentation LUT shape
        --plut                 [l]ut identifier: string
                               add LUT [l] to print job
        --inverse-plut         render the inverse presentation LUT into the
                               bitmap of the hardcopy grayscale image
        --illumination         [v]alue: integer (0..65535)
                               set illumination to v (in cd/m^2)
        --reflection           [v]alue: integer (0..65535)
                               set reflected ambient light to v (in cd/m^2)
basic film session options (only with --spool):
        --copies               [v]alue: integer (1..100, default: 1)
                               set number of copies to v
        --medium-type          [v]alue: string
                               set medium type to v
        --destination          [v]alue: string
                               set film destination to v
        --label                [v]alue: string
                               set film session label to v
        --priority             [v]alue: string
                               set print priority to v
        --owner                [v]alue: string
                               set film session owner ID to v
annotation options:
        --no-annotation        do not create annotation (default)
  -a    --annotation           [t]ext: string
                               create annotation with text t
  +pd   --print-date           prepend date/time to annotation (default)
  -pd   --print-no-date        do not prepend date/time to annotation
  +pn   --print-name           prepend printer name to annotation (default)
  -pn   --print-no-name        do not prepend printer name to annotation
  +pl   --print-lighting       prepend illumination to annotation (default)
  -pl   --print-no-lighting    do not prepend illumination to annotation
overlay options:
  +O    --overlay              [f]ilename: string, [x] [y]: integer
                               load overlay data from PBM file f and
                               display at position (x,y)
  +Og   --ovl-graylevel        [v]alue: integer (0..4095)
                               use overlay gray level v (default: 4095 = white)
other print options:
  -l    --layout               [c]olumns [r]ows: integer (default: 1 1)
                               use 'STANDARD\c,r' image display format
        --filmsize             [v]alue: string
                               set film size ID to v
        --magnification        [v]alue: string
                               set magnification type to v
        --smoothing            [v]alue: string
                               set smoothing type to v
        --configinfo           [v]alue: string
                               set configuration information to v
        --resolution           [v]alue: string
                               set requested resolution ID to v
        --border               [v]alue: string
                               set border density to v
        --empty-image          [v]alue: string
                               set empty image density to v
        --max-density          [v]alue: string
                               set max density to v
        --min-density          [v]alue: string
                               set min density to v
        --img-polarity         [v]alue: string
                               set image box polarity to v (NORMAL or REVERSE)
        --img-request-size     [v]alue: string
                               set requested image size to v (width in mm)
        --img-magnification    [v]alue: string
                               set image box magnification type to v
        --img-smoothing        [v]alue: string
                               set image box smoothing type to v
        --img-configinfo       [v]alue: string
                               set image box configuration information to v
Options (55)
OptionDescriptionSource
-h--help print this help text and exithelp
--versionprint version information and exithelp
--argumentsprint expanded command line argumentshelp
-q--quiet quiet mode, print no warnings and errorshelp
-v--verbose verbose mode, print processing detailshelp
-d--debug debug mode, print debug informationhelp
-ll--log-level [l]evel: string constant (fatal, error, warn, info, debug, trace) use level l for the loggerhelp
-lc--log-config [f]ilename: string use config file f for the loggerhelp
-c--config [f]ilename: string process using settings from configuration file fhelp
-p--printer [n]ame: string (default: 1st printer in cfg file) select printer with identifier n from cfg filehelp
-s--spool spool print job to DICOM printerhelp
--nospooldo not spool print job to DICOM printer (default)help
--portraitset portrait orientationhelp
--landscapeset landscape orientationhelp
--default-orientationuse printer default (default)help
--trimset trim onhelp
--no-trimset trim offhelp
--default-trimuse printer default (default)help
--request-decimaterequest decimatehelp
--request-croprequest crophelp
--request-failrequest failurehelp
--default-requestuse printer default (default)help
--default-plutdo not create presentation LUT (default)help
--identityset IDENTITY presentation LUT shapehelp
--lin-odset LIN OD presentation LUT shapehelp
--plut[l]ut identifier: string add LUT [l] to print jobhelp
--inverse-plutrender the inverse presentation LUT into the bitmap of the hardcopy grayscale imagehelp
--illumination[v]alue: integer (0..65535) set illumination to v (in cd/m^2)help
--reflection[v]alue: integer (0..65535) set reflected ambient light to v (in cd/m^2)help
--copies[v]alue: integer (1..100, default: 1) set number of copies to vhelp
--medium-type[v]alue: string set medium type to vhelp
--destination[v]alue: string set film destination to vhelp
--label[v]alue: string set film session label to vhelp
--priority[v]alue: string set print priority to vhelp
--owner[v]alue: string set film session owner ID to vhelp
--no-annotationdo not create annotation (default)help
-a--annotation [t]ext: string create annotation with text thelp
-pd--print-no-date do not prepend date/time to annotationhelp
-pn--print-no-name do not prepend printer name to annotationhelp
-pl--print-no-lighting do not prepend illumination to annotationhelp
-l--layout [c]olumns [r]ows: integer (default: 1 1) use 'STANDARD\c,r' image display formathelp
--filmsize[v]alue: string set film size ID to vhelp
--magnification[v]alue: string set magnification type to vhelp
--smoothing[v]alue: string set smoothing type to vhelp
--configinfo[v]alue: string set configuration information to vhelp
--resolution[v]alue: string set requested resolution ID to vhelp
--border[v]alue: string set border density to vhelp
--empty-image[v]alue: string set empty image density to vhelp
--max-density[v]alue: string set max density to vhelp
--min-density[v]alue: string set min density to vhelp
--img-polarity[v]alue: string set image box polarity to v (NORMAL or REVERSE)help
--img-request-size[v]alue: string set requested image size to v (width in mm)help
--img-magnification[v]alue: string set image box magnification type to vhelp
--img-smoothing[v]alue: string set image box smoothing type to vhelp
--img-configinfo[v]alue: string set image box configuration information to vhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.