DICOM PS3.18 2019a - Web Services

8.2.4 Region of the Image (Current)
Prev | 8.2 Parameters for DICOM Images | Next

### 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 mode.

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

It shall only be present if the Acceptable Media Types are Rendered Media Types. See Section 6.1.1.3.

It shall not be present if the Unique Identifier of the Presentation Object parameter is present.

The value shall be expressed as a list of four positive decimal strings, separated by the ',' character, representing the region of the source images 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:

- the x position of the top left hand corner of the region to be retrieved, 0.0 corresponding to the first column of the image matrix.

- the y position of the top left hand corner of the region to be retrieved, 0.0 corresponding to the top row of the image matrix.

- the x position of the bottom right hand extent of the region, 1.0 corresponding to the last column of the image matrix, 0.0 being forbidden.

- the y position of the bottom right hand extent of the region, 1.0 corresponding to the last row of the image matrix, 0.0 being forbidden.

### 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 images.

If this parameter specifies an ill-defined region, the origin server shall return a 400 (Bad Request) response, and may include a payload containing an appropriate error message.

Prev | Up | Next
8.2.3 Reserved | Home | 8.2.5 Windowing

DICOM PS3.18 2019a - Web Services