DICOM PS3.18 2019a - Web Services

8.2.2 Viewport Dimensions

The viewport parameters specify the dimensions of the user agent's viewport. The Viewport Rows and Columns parameters specify the height and width, in pixels, of the returned image.

If these parameters specify viewport dimensions that are either ill-defined or not supported, then the response shall be a 400 (Bad Request), and may include a payload containing an appropriate error message.

8.2.2.1 Number of Pixel Rows

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

The value shall be expressed as an integer, representing the image height to be returned. It is OPTIONAL for the URI mode. 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 images 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 images (or selected region) are sent in their original size (or the size of the presentation state applied on the images), resulting as one pixel of screen image for each value in the images data matrix.

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

DICOM PS3.18 2019a - Web Services