[Bug] Black Image Display on Load for Uncompressed DICOM When Streaming is Enabled

[igoroctaviano]

Bug: Black Image Display on Load for Uncompressed DICOM When Streaming is Enabled

Describe the Bug

When streaming is enabled for stack image retrieval, uncompressed DICOM images display as a black screen on initial load. The image may eventually render correctly once the full file has been received and decoded, but users see a blank/black viewport during the load. Streaming benefits progressive formats (e.g. HTJ2K) where partial data can be decoded; uncompressed DICOM requires the full file before decode, and the transfer syntax is not known until retrieval has started—so the client cannot reliably decide whether to enable streaming before issuing the request.

Steps to Reproduce

1. Configure a data source that returns uncompressed DICOM (e.g. acceptHeader: ['application/octet-stream']).
2. Open a study that contains uncompressed images (e.g. CR, uncompressed CT/MR).
3. Enable streaming for stack retrieval (default behavior).
4. Load the study and navigate to an image.

The current behavior

The viewport displays a black/blank image on initial load. The image may eventually appear once the full DICOM file has been retrieved and decoded.

The expected behavior

The image should display as soon as it is available, or the viewport should indicate loading until the image can be rendered—not show a black frame.

System Information

• OHIF Viewer with Cornerstone extension
• Cornerstone3D with streaming image volume loader
• Data sources that return uncompressed DICOM (e.g. application/octet-stream single-part responses)

Workaround

Disable streaming for the data source by setting stackRetrieveOptions in the data source configuration:

configuration: {
  acceptHeader: ['application/octet-stream'],
  stackRetrieveOptions: {
    retrieveOptions: { single: { streaming: false } },
  },
}

[linear]

CS-119