Format conversion

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). The Wrap Document modal needs a loaded file.

  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

  1. Load the newly created DICOM. Open the .dcm file back into the app with Files on the start screen.

  2. Verify the metadata in Edit mode (Ctrl+2 / ⌘2 in the desktop app):

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

Extract the Document (Round-Trip)

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

  2. 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.