8.2 PARAMETERS FOR DICOM IMAGE PERSISTENT OBJECTS

These parameters shall only be included when a request is made for a Single Frame Image Object s or Multi-Frame Image or video Object s as defined in Section 7.2.

8.2.1 Annotation on the object

Annotation of an object s retrieved and displayed as an image. This parameter is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction. It shall not be present if contentType is application/dicom, or is a non-image MIME type (e.g., text/*). When it is not present for an image object s , no additional annotation may be burnt in.

When used in conjunction with a presentation state object, it shall be applied after the presentation on the image s . When used in conjunction with the region parameter, it shall be applied after the selection of the region.

The parameter name shall be “annotation” for URI based mode, and “Annotation” for the WS mode . Its value is a non-empty list of one or more of the following items, separated by a "," character:

Note: The exact nature and presentation of the annotation is determined by the Server. The annotation is burned into the returned image pixels.

8.2.2 Number of pixel rows

The parameter name shall be “rows” for URI based mode, and “Rows” for the WS mode .

The value shall be expressed as an integer, representing the image height to be returned. It is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction. It shall not be present for other WS mode transactions . It shall not be present if contentType is application/dicom.

If both “rows” and “columns” are specified, then each shall be interpreted as a maximum, and a size will be chosen for the image s within these constraints, maintaining the correct aspect ratio. If the number of rows is absent and the number of columns is present, the number of rows shall be chosen in order to maintain the correct aspect ratio. If both are absent, the image s (or selected region) is are sent in its their original size (or the size of the presentation state applied on the image s ), resulting as one pixel of screen image for each value in the image s data matrix.

The value shall be encoded as an integer string (IS), as specified in PS 3.5.

8.2.3 Number of pixel columns

The parameter name shall be “columns” for URI based mode, and “Columns” for the WS mode .

The value shall be expressed as an integer, representing the image width to be returned. It is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction. It shall not be present if contentType is application/dicom.

If both “rows” and “columns” are specified, then each shall be interpreted as a maximum, and a size will be chosen for the image s within these constraints, maintaining the correct aspect ratio. If the number of columns is absent and the number of rows is present, the number of columns shall be chosen in order to maintain the correct aspect ratio. If both are absent, the image s (or selected region) is are sent in its their original size (or the size of the presentation state applied on the image s ), resulting as one pixel of screen for one pixel of the image s .

The value shall be encoded as an integer string (IS), as specified in PS 3.5.

8.2.4 Region of the image

This parameter allows selection of a rectangular region of an image matrix to be retrieved. The purpose of this parameter is to allow a user to view a selected area of the image matrix, for example at higher magnification.

The parameter is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction. It shall not be present for other WS mode transactions .

The parameter name shall be “region” for URI based mode, and “Region” for the WS mode .

It shall not be present if contentType is application/dicom.

The value shall be expressed as a list of four positive decimal strings, separated by the ',' character, representing the region of the source image s to be returned. These decimal values shall be values in a normalized coordinate system relative to the size of the original image matrix measured in rows and columns, with values ranging from 0.0 to 1.0, and representing in the following order:

Note: The Server may or may not support this parameter.

If this parameter is supported, an image matrix corresponding to the specified region shall be returned with size corresponding to the specified normalized coordinate values otherwise the complete image matrix shall be returned. If the presentationUID parameter is present, the region shall be selected after the corresponding presentation state has been applied on the image s .

8.2.5 Window center of the image

The parameter name shall be “windowCenter” for URI based mode, and “WindowCenter” for the WS mode .

Controls the luminosity of the image s as defined in PS 3.3. This parameter is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction . It shall not be present for other WS mode transactions. It is REQUIRED if "windowWidth" is present. This parameter shall not be present if there is a presentationUID parameter. It shall not be present if contentType is application/dicom.

The value shall be encoded as a decimal string (DS), as specified in PS 3.5.

8.2.6 Window width of the image

The parameter name shall be “windowWidth” for URI based mode, and “WindowWidth” for the WS mode .

Controls the contrast of the image s as defined in PS 3.3. This parameter is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction. It shall not be present for other WS mode transactions . It is REQUIRED if "windowCenter" is present. This parameter shall not be present if there is a presentationUID parameter. It shall not be present if contentType is application/dicom.

The value shall be encoded as a decimal string (DS), as specified in PS 3.5.

8.2.7 Frame Number

The parameter name shall be “frameNumber" for URI based mode, and “FrameNumber” for the WS mode .

Specifies that the single frame with that number within a multi-frame image object, as defined in PS 3.3, shall be returned. It is OPTIONAL and shall be ignored in the case of all objects other than multi-frame objects.

The value shall be encoded as an integer string (IS), as specified in PS 3.5.

8.2.8 Image Quality

The parameter name shall be “imageQuality" for URI based mode, and “ImageQuality” for the WS mode . It is OPTIONAL for the URI based mode and the WS mode “DICOM requester” and “Rendered Requester” transactions. It shall not be present if contentType is application/dicom, except if the transferSyntax parameter is present and corresponds to a lossy compression.

If the requested MIME type is for a lossy compressed image (e.g. image/jpeg), this parameter indicates the required quality of the image to be returned within the range 1 to 100, 100 being the best quality.

Note: Decompression and recompression may degrade the image quality if the original image was already irreversibly compressed. In case the image has been already lossy compressed using the same format as required (e.g. jpeg), it may be sent as it is without decompressing and recompressing it.

The value shall be encoded as an integer string (IS), as specified in PS 3.5.

Note: The specific interpretation of the meaning of this parameter is left to the interpretation of the implementers of the standard.

8.2.9 Unique identifier of the presentation object

The parameter name shall be “presentationUID" for URI based mode, and “PresentationUID” for the WS mode .

SOP Instance UID of the presentation state storage object to be applied to the image s . This parameter is OPTIONAL for the URI based mode and the WS mode “Rendered Requester” transaction. It shall not be present if contentType is application/dicom.

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

If this parameter is combined with region and/or annotation parameters, the presentation state shall be applied to the image s prior to selecting a region and burning in annotations.

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.

Notes: 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 s .

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 PS 3.14), the grayscale or color space for the image s returned by the request is not defined by this standard.

8.2.10 Unique identifier of the series containing the presentation object

The parameter name shall be “presentationSeriesUID" for URI based mode, and “PresentationSeriesUID” for the WS mode .

Series Instance UID of the series containing the presentation state storage object to be applied on the image s . This parameter is REQUIRED and shall only be present if "presentationUID" is present.

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

Note: As specified in DICOM, the Presentation State will be in the same study as the image s it applies to.

8.2.11 Transfer Syntax UID

The parameter name shall be “transferSyntax" for URI based mode, and “TransferSyntaxUIDList” containing one or more “TransferSyntaxUID” elements for the WS mode .

The Transfer Syntax(es) to be used within the DICOM image object s , as specified in PS 3.6. This parameter is OPTIONAL for the URI based mode and the WS mode “DICOM Requester” transaction. It shall not be present if contentType is other than application/dicom.

By default the DICOM objects returned shall be encoded in Explicit VR Little Endian. Neither Implicit VR, nor Big Endian shall be used. The response shall be the Transfer Syntax requested if possible. If it is not possible for the response to be sent using the requested transfer syntax then the Explicit VR Little Endian Uncompressed Transfer Syntax shall be used.

Note: The transfer syntax can be chosen as one of the values of TransferSyntaxUID corresponding to JPIP, in case of which the returned objects will contain the URL of the JPIP session to launch for retrieving the corresponding image.

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

Item #10: Append PS 3.18 by the following annex.