DCENCAP(1)

NAME
dcencap - ACR/NEMA DICOM PS3 ... DICOM PS3 - Encapsulate compressed stream in a DICOM file

SYNOPSIS

dcencap dicomheader rawpixeldata -transfersyntax uid [ -itemsize nbytes | -singleitem ] [ -v|verbose|vv|veryverbose ]

DESCRIPTION

dcencap reads the named dicom header input file and raw pixel data bitstream input file and copies the information and pixel data into a new dicom file with the pixel data encapsulated and the specified transfer syntax.

OPTIONS
The verbose output goes to standard error.

The basic input switches are described in dcintro(1), though the input filenames must be explicitly specified, ie. they cannot be redirected from standard input. The transfer syntax must be explicitly specifed for the DICOM output file using the usual -ts option, and it obviously has to be one of the encapsulated transfer syntaxes. Options specific to this program are:

-singleitem
    Only a single encapsulated item is written, regardless of the number of frames (e.g., for MPEG).

-itemsize  nbytes
    The number of bytes to include in each encapsulated item. Defaults to number of rows times number of columns times bytes per pixel in a single frame, unless it exceeds the size of what will fit in a 32 bit length field; obviously this calculation has no meaning if the data stream is compressed.

-verbose
    Describe fragmentation process and number of bytes processed.

-veryverbose
    Display byte offset from file start and message start, in hexadecimal, and dump contents while reading, once read, during replacement, and before writing.

ENVIRONMENT

EXAMPLES

% dcencap -v -singleitem video_002.src video_002.mpg -of video_002.dcm -ts 1.2.840.10008.1.2.4.100
Using frameSize 304128
Using itemSize 136857600
Doing single item
Wrote total of 9072492

FILES

SEE ALSO
dcintro(1)

AUTHOR
Copyright (c) 1993-2022, David A. Clunie DBA PixelMed Publishing. All rights reserved.

BUGS
Cannot add further attributes after the encapsulated Pixel Data attribute.

Cannot separate concatenated multi-frame compressed data bitsream into separate fragments (e.g., to build a multi-frame JPEG encapsulated encoding).