DICOM PS3.18 2019a - Web Services

8.2.9 Unique Identifiers of the Presentation State Object

The parameters in this Section specify the Series and SOP Instance UIDs of a Presentation State. They are OPTIONAL; however, if either is present, both shall be present. If only one is present the origin server shall return a 400 (Bad Request) response, and may include a payload containing an appropriate error message.

If the Presentation State parameters are present, then only the Annotation, Image Quality, Viewport and Region parameters may also be present. If any of the other image rendering parameters described in Section 8.2 are present the response shall be 400 (Bad Request), and may include a payload containing an appropriate error message.

If the target resource is not a Presentation State then the response will be 400 (Bad Request), and may include a payload containing an appropriate error message.

The Presentation State parameters shall not be present if contentType is application/dicom; if either is present the origin server shall return a 400 (Bad Request) response, and may include a payload containing an appropriate error message.

8.2.9.1 Unique Identifier of the Presentation State SOP Instance

The parameter name shall be "presentationUID" for URI mode.

The value is the SOP Instance UID of the Presentation State storage object to be applied to the images.

The value shall be encoded as a unique identifier (UID) string, as specified in PS3.5, except that it shall not be padded to an even length with a NULL character.

If this parameter is present, then the Region of the Image parameter shall not be present. See Section 8.2.4.

If the Presentation Size Mode in the presentation state is SCALE TO FIT or TRUE SIZE, then the displayed area specified in the presentation shall be scaled to fit the size specified by the rows and columns parameters if present, otherwise the displayed area selected in the presentation state will be returned without scaling.

Note

  1. The intent of the TRUE SIZE mode in the presentation state cannot be satisfied, since the physical size of the pixels displayed by the web browser is unlikely to be known. If the Presentation Size Mode in the presentation state is MAGNIFY, then the displayed area specified in the presentation shall be magnified (scaled) as specified in the presentation state. It will then be cropped to fit the size specified by the rows and columns parameters, if present.

  2. Any Displayed Area relative annotations specified in the presentation state are rendered relative to the Specified Displayed Area within the presentation state, not the size of the returned image.

Though the output of the presentation state is defined in DICOM to be in P-Values (grayscale values intended for display on a device calibrated to the DICOM Grayscale Standard Display Function PS3.14), the grayscale or color space for the images returned by the request is not defined by this Standard.

DICOM PS3.18 2019a - Web Services