8.3.5.3 Query Parameters For Rendered MPR Volume Resources and Rendered 3D Volume Resources

8.3.5.3 Query Parameters For Rendered MPR Volume Resources and Rendered 3D Volume Resources (Current)
Prev	8.3.5 Rendering Query Parameters	Next

Query parameters defined in this section control the creation of new 3D or MPR images based on Volume Data resampled from the Target Resource.

The following rules pertain to all parameters defined in this section:

All parameters are optional for the user agent.
Not all parameters are required to be supported by the origin server.
These parameters only apply to resources that are images.

The set of transformations specified by the parameters in this section shall be applied to the images as if the parameters were a Volumetric Presentation State, that is, in the order specified by the applicable image rendering pipeline specified in Section FF.2 of PS3.4.

Table 8.3.5-3, “Retrieve Rendered Volume Query Parameters” shows the Query Parameters that may be used when requesting a Rendered Volume Representation.

Table 8.3.5-3. Retrieve Rendered Volume Query Parameters

Key	Values	Target Resource Category	Section
volumeinputreference	uid or frame	Image (single or multi-frame)	Section 8.3.5.3.1
match	; See attribute matching rules in Section 8.3.4.1	Image (single or multi-frame)	Section 8.3.5.3.2
renderingmethod	"volume_rendered", "maximum_ip", "minimum_ip" or "average_ip"	Image (single or multi-frame)	Section 8.3.5.3.3
orientation	"a", "p", "r", "l", "h" or "f"	Image (single or multi-frame) or Volumetric Presentation States	Section 8.3.5.3.4
viewpointposition	px, py, pz	Image (single or multi-frame) or Volumetric Presentation States	Section 8.3.5.3.5
viewpointlookat	lx, ly, lz	Image (single or multi-frame) or Volumetric Presentation States	Section 8.3.5.3.6
viewpointup	ux, uy, uz	Image (single or multi-frame) or Volumetric Presentation States	Section 8.3.5.3.7
mprslab	st	Image (single or multi-frame)	Section 8.3.5.3.8
swivelrange	sr	Image (single or multi-frame)	Section 8.3.5.3.9
volumetriccurvepoint	px, py, pz	Image (single or multi-frame)	Section 8.3.5.3.10
animationstepsize	ss	Image (single or multi-frame)	Section 8.3.5.3.11
animationrate	rt	Image (single or multi-frame)	Section 8.3.5.3.12
renderedvolumetricmetadata	"yes"	Image (single or multi-frame)	Section 8.3.5.3.13

Rendered MPR Volume Resources and Rendered 3D Volume Resources have two mutually exclusive options to determine the initial orientation of the resampled Volume Data:

The "orientation" parameter establishes the standard anatomic position of the patient as viewed by the camera, and
camera orientation parameters ("viewpointposition", "viewpointlookat", or "viewpointup") establish the camera position and direction as it views the patient.

When incorporating animation parameters, the initial frame is established by orientation parameters. The parameters "swivelrange", "volumetriccurvepoint" and "animationstepsize" dictate subsequent frames. When animating multiple sets of temporally related, spatially co-located Volume Data (such as a multiphase acquisition), the origin server determines the initial frame's displayed phase.

There is no parameter to control the type of projection used during rendering. The origin server shall use Orthographic projection for Rendered 3D Volume Resources. See Section C.11.30.1 in PS3.3.

There is no parameter to explicitly control Render Field of View, MPR View Height or MPR View Width (see Section C.11.30 in PS3.3 and Section C.11.26 in PS3.3). The "viewport" parameter can be used to scale the returned media. See Section 8.3.5.1.3.

8.3.5.3.1 Volume Input Reference

The "volumeinputreference" parameter identifies the Instance, or Frame within an Instance, from which the origin server shall extract characteristics and identify additional Instances or Frames in the Target Resource with the same values for those characteristics. The user agent uses this parameter to identify a desired subset when the Target Resource is a superset of the intended Volume Data. The origin server shall identify a subset that conforms to theVolume Input Requirements for Rendered MPR Volume Resources and Rendered 3D Volume Resources (see Section C.11.23.1 in PS3.3).

The syntax of this parameter for a multi-frame image is:

%s" volumeinputreference =" uid "," frame

Otherwise, it is:

%s" volumeinputreference =" uid

Where

uid	Is the Unique Identifier of the Volume Input Reference SOP Instance when the Target Resource is a series or study.
frame	Is the frame number within an Image Instance when the Volume Input Reference is an Enhanced IOD Image Instance.

Note

uid

corresponds to Referenced SOP Instance UID (0008,1155) and frame corresponds to Referenced Frame Number (0008,1160). See Section 10.3 in PS3.3.

The origin server shall create Volume Data from instances or frames having characteristics identical to the Volume Input Reference based on implementation-specific logic.

The origin server shall return a 400 (Bad Request), and may include an appropriate Status Report, if any of the following are true:

the Target Resource is a Presentation State,
valid Volume Data is not found based on the Volume Input Reference,
the UID is not found in the Target Resource,
the frame is not found in the Target Resource,
a Match Attribute/Value pair is present in another parameter in the request.

Prev	Up	Next
8.3.5.2 Query Parameters For Thumbnails	Home	8.3.5.3.2 Match