Non-DICOM → DICOM wrapping

Wrap an external image or document as a valid DICOM object.

Problem

Your workflow produces non-DICOM assets — PDF reports, STL 3D models, JPEG photos — that need to be archived alongside DICOM studies in the PACS. The DICOM Encapsulated Document SOP class allows wrapping any file format inside a DICOM envelope with proper Patient/Study/Series metadata. You need to wrap a PDF file as an Encapsulated PDF DICOM object and verify a round-trip: wrap, then extract the original file back.

Steps

Wrap a Document

1. Open any DICOM file first (⌘O) to hydrate the editor (required to open the wrap modal).

2. Open the Wrap Document modal — ⌘K → type “wrap” → select the command.

3. Fill in the metadata:

   • Patient Name: WRAPPED PATIENT
   • Patient ID: ID-WRAP-999
   • Document Title: Post-Mortem Clinical Report
   • Select a source file (e.g. dummy.pdf)

4. Click Wrap — the app generates a new DICOM file with the PDF encapsulated inside.

Verify the Wrapped File

5. Load the newly created DICOM — open the .dcm file back into the app via Open files.

6. Verify the metadata in Edit mode (⌘3):

   • Patient Name (0010,0010) → WRAPPED PATIENT
   • Document Title (0042,0010) → Post-Mortem Clinical Report

Extract the Document (Round-Trip)

7. Extract the encapsulated file — ⌘K → “Extract encapsulated document”. A download triggers.

8. Verify — the downloaded file has a .pdf extension (matching the original format).

Result

A valid DICOM is produced with the source document encapsulated and your metadata embedded in the headers. Extracting round-trips back to the original format (e.g. PDF) byte-for-byte — the wrapping is lossless.