DICOM PS3.18 2019a - Web Services

8.2 Parameters for DICOM Images

These parameters shall only be included when a request is made for a Single Frame or Multi-frame Image or Video Objects as defined in Section 6.1.1.2.

If any of these parameters are included in a request for non-Image objects (e.g., for SR objects), then the response shall be a 400 (Bad Request), and may include a payload containing an appropriate error message.

8.2.1 Annotation on the Object

Annotation of objects retrieved and displayed as an image. This parameter is OPTIONAL for the URI mode. It shall not be present if contentType is application/dicom, or is a non-image media type (e.g., text/*). When it is not present for image objects, 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 images. 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 mode. Its value is a non-empty list of one or more of the following items, separated by a "," character:

  • "patient", for displaying patient information on the image (e.g., patient name, birth date,…)

  • "technique", for displaying technique information of the image (e.g., image number, study date, image position,…).

Note

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

The origin server may support additional values for this parameter.

The origin server shall ignore any values it does not support. If unsupported values are present, the origin server shall include a following Warning header field:

Warning: 299 {+service}: The following annotation values are not supported: <values>

and may include a payload containing an appropriate warning message.

DICOM PS3.18 2019a - Web Services