W: ##########################################################################
W: #                                                                        #
W: #              pdf2dcm is deprecated, use dcmencap instead!              #
W: #                                                                        #
W: ##########################################################################

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

dcmencap: Encapsulate document into DICOM format
usage: dcmencap [options] docfile-in dcmfile-out

parameters:
  docfile-in                    input filename to be converted
  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 options:
    +fa  --filetype-auto        automatically determine file type (default)
    +fp  --filetype-pdf         expect PDF file
    +fc  --filetype-cda         expect CDA file
    +fs  --filetype-stl         expect STL file
    +fm  --filetype-mtl         expect MTL file
    +fo  --filetype-obj         expect OBJ file
DICOM document options:
  document title:
    +t   --title                [t]itle: string (default: empty)
                                document title
    +cn  --concept-name         [CSD] [CV] [CM]: string (default: empty)
                                coded representation of document title defined
                                by coding scheme designator CSD,
                                code value CV and code meaning CM
  patient data:
    +pn  --patient-name         [n]ame: string
                                patient's name in DICOM PN syntax
    +pi  --patient-id           [i]d: string
                                patient identifier
    +pb  --patient-birthdate    [d]ate: string (YYYYMMDD)
                                patient's birth date
    +ps  --patient-sex          [s]ex: string (M, F or O)
                                patient's sex
  device data:
    +mn  --manufacturer         [n]ame: string
                                manufacturer's name
    +mm  --manufacturer-model   [n]ame: string
                                manufacturer's model name
    +ds  --device-serial        [n]umber: string
                                device serial number
    +sv  --software-versions    [v]ersions: string
                                software versions
  manufacturing 3d model data (STL/MTL/OBJ only):
    +mu  --measurement-units    [CSD] [CV] [CM]: string (default: UCUM, um, um)
                                measurement units defined by coding scheme
                                designator CSD, code value CV, code meaning CM
  study and series:
    +sg  --generate             generate new study and
                                series UIDs (default)
    +st  --study-from           [f]ilename: string
                                read patient/study data from DICOM file
    +se  --series-from          [f]ilename: string
                                read patient/study/series data from DICOM file
  instance number:
    +i1  --instance-one         use instance number 1
                                (default, not with +se)
    +ii  --instance-inc         increment instance number (only with +se)
    +is  --instance-set         [i]nstance number: integer
                                use instance number i
  burned-in annotation:
    +an  --annotation-yes       document contains patient identifying data
                                (default)
    -an  --annotation-no        document does not contain patient identif. data
processing options:
  CDA processing options:
    -ov  --no-override          CDA patient and document data must match study,
                                series or manually entered information (default)
    +ov  --override             CDA's data will be overwritten by study, series
                                or manually entered information
  other processing options:
    -k   --key                  [k]ey: gggg,eeee="str", path or dict. name="str"
                                add further attribute
output options:
  output transfer syntax:
    +te  --write-xfer-little    write with explicit VR little endian (default)
    +tb  --write-xfer-big       write with explicit VR big endian TS
    +ti  --write-xfer-implicit  write with implicit VR little endian TS
  group length encoding:
    -g   --group-length-remove  write without group length elements (default)
    +g   --group-length-create  write with 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 (not with --write-dataset):
    -p=  --padding-retain       do not change padding (default)
    -p   --padding-off          no padding (implicit if --write-dataset)
    +p   --padding-create       [f]ile-pad [i]tem-pad: integer
                                align file on multiple of f bytes
                                and items on multiple of i bytes