DICOM PS3.3 2024d - Information Object Definitions |
---|
Table C.11.17-1 specifies the Attributes of the Structured Display Image Box Module.
Table C.11.17-1. Structured Display Image Box Module Attributes
The image display boxes defined in the display environment, together with the reference to the image to be displayed in each Image Box. |
|||
Exactly four dimensionless floating point values, in the range 0.0 to 1.0, indicating the rectangular coordinate position of the Image Box within the Display Environment. |
|||
An integer that is unique across all Items of the Structured Display Image Box Sequence (0072,0422) that identifies the Image Box. |
|||
Type of layout of the Image Box. The types are primarily distinguished by their interaction technique. Defined Terms:
|
|||
Positive integer defining the horizontal Image Box tile dimension; the number of columns. Required if the value of Image Box Layout Type (0072,0304) is TILED. |
|||
Positive integer defining the vertical Image Box tile dimension; the number of rows. Required if the value of Image Box Layout Type (0072,0304) is TILED. |
|||
If this Image Box overlaps in spatial position with others, this Attribute indicates the layer of this Image Box in relation to the others. The value shall be a positive integer in the range 1 to 100, where 1 = top and 100 = bottom. If this Attribute is not present, then the expected behavior is not defined. |
|||
Indicates direction in which to horizontally justify the image within an Image Box that is not the same shape (aspect ratio) as the image. |
|||
Indicates direction in which to vertically justify the image within an Image Box that is not the same shape (aspect ratio) as the image. |
|||
Describes the preferred playback sequencing for the Image Box. Overrides any Preferred Playback Sequencing (0018,1244) value in the image objects being displayed. Required if the value of Image Box Layout Type (0072,0304) is CINE. |
|||
Recommended rate at which the frames of a multi-frame image shall be displayed, in frames/second. Shall have a value greater than zero. Overrides any Recommended Display Frame Rate (0008,2144) value in the image objects being displayed. Required if the value of Image Box Layout Type (0072,0304) is CINE and if Cine Relative to Real-Time (0072,0330) is not present. |
|||
A positive dimensionless floating point numeric factor equal to playback rate divided by acquisition rate. Required if the value of Image Box Layout Type (0072,0304) is CINE and if Recommended Display Frame Rate (0008,2144) is not present. |
|||
Required if the value of Image Box Layout Type (0072,0304) is CINE. |
|||
The frame number of the first frame of the multi-frame image to be displayed in a CINE Image Box. Required if the value of Image Box Layout Type (0072,0304) is CINE. |
|||
The Frame Number of the last frame of the multi-frame image to be displayed in a CINE Image Box. Required if the value of Image Box Layout Type (0072,0304) is CINE. |
|||
Reference to the initial frame in a stack to be displayed in this image box. If value is not present, the first image frame to be displayed is not defined by the Standard. Zero or one Item shall be included in this Sequence. Required if the value of Image Box Layout Type (0072,0304) is STACK. |
|||
>>Include Table 10-3 “Image SOP Instance Reference Macro Attributes” |
|||
Reference to the Image SOP Instances, or frames from multi-frame Image SOP Instances, to be displayed in this Image Box. Zero or more Items shall be included in this Sequence. Required if Referenced Presentation State Sequence (0008,9237), Referenced Stereometric Instance Sequence (0008,1134), and Referenced Instance Sequence (0008,114A) are not present. See Section C.11.17.1.2. |
|||
>>Include Table 10-3 “Image SOP Instance Reference Macro Attributes” |
NoteThe order of frames identified in the Referenced Frame Number (0008,1160) Attribute affects ordering in STACK Image Box Layout. See Section C.11.17.1.2. |
||
Reference to a Softcopy Presentation State SOP Instance to be applied to the referenced image. Only a single Item shall be permitted in this sequence. Required if presentation controls are to be applied to the image or image frame before rendering in the Structured Display. |
|||
>>>Include Table 10-11 “SOP Instance Reference Macro Attributes” |
|||
Reference to a Softcopy Presentation State SOP Instance or a Volumetric Presentation State SOP Instance whose referenced images are to be displayed in the Image Box using the presentation controls of the referenced SOP Instance. One or more Items shall be included in this Sequence. Multiple items are only permitted if the Image Box Layout Type (0072,0304) has a value of VOLUME_CINE. Required if Referenced Image Sequence (0008,1140), Referenced Stereometric Instance Sequence (0008,1134), and Referenced Instance Sequence (0008,114A) are not present. See Section C.11.17.1.2. |
|||
>>Include Table 10-11 “SOP Instance Reference Macro Attributes” |
|||
Reference to a non-image SOP Instance (e.g., waveform, SR, encapsulated document) whose content is to be displayed in the Image Box. Only a single Item shall be included in this Sequence. Required if Referenced Presentation State Sequence (0008,9237), Referenced Stereometric Instance Sequence (0008,1134), and Referenced Image Sequence (0008,1140) are not present. See Section C.11.17.1.3. |
|||
>>Include Table 10-11 “SOP Instance Reference Macro Attributes” |
|||
Reference to a Stereometric SOP Instance whose referenced images are to be displayed in the Image Box. Only a single Item shall be included in this Sequence. Required if Referenced Presentation State Sequence (0008,9237), Referenced Instance Sequence (0008,114A), and Referenced Image Sequence (0008,1140) are not present. See Section C.11.17.1.4. |
|||
>>Include Table 10-11 “SOP Instance Reference Macro Attributes” |
|||
Description of synchronized display between two or more Image Boxes. Required if synchronized display is specified between Image Boxes. |
|||
Multi-valued list of two or more Image Box Number (0072,0302) values. Indicates that the display of multiple image frames within the specified Image Boxes are synchronized. Referenced Image Boxes shall be of same Image Box Layout Type (0072,0304). An Image Box Number value may appear in only one Image Box Synchronization Sequence (0072,0430) Item. |
|||
Type of synchronization between Image Boxes. See Section C.11.17.1.5. |
The Display Environment Spatial Position (0072,0108) specifies the corners of the Image Box relative to the vertical and horizontal dimensions of the Display Environment, specified as Number of Vertical Pixels (0072,0104) and Number of Horizontal Pixels (0072,0106) in the Nominal Screen Definition Sequence (0072,0102).
See also Section C.23.2.1.1.
Within the Image Box, the image (or the area of the image selected for display by the associated Presentation State SOP Instance) shall be scaled to fit the display area under the constraint that the aspect ratio of the image is maintained.
In rendering the Image Box, the Application Entity may render display controls (such as cine speed control, or stack position indication) either within or outside the specified Display Environment Spatial Position (0072,0108).
Image SOP Instances, or frames from multi-frame SOP Instances, to be displayed in an Image Box may be identified either directly by the Referenced Image Sequence (0008,1140), or indirectly through the Referenced Presentation State Sequence (0008,9237).
Referenced Image Sequence (0008,1140) is permitted to be zero length, indicating an empty Image Box.
If images are identified indirectly through the Referenced Presentation State Sequence (0008,9237), all of the image frames identified in the top level Referenced Series Sequence (0008,1115) Attribute shall be displayed. For images identified indirectly through a Blending Presentation State SOP Instance, all the image frames for which the Blending Position (0070,0405) value is UNDERLYING shall be displayed, with the relevant SUPERIMPOSED images blended as necessary.
If images are to be displayed, the number of frames referenced for display shall be consistent with the value of Image Box Layout Type (0072,0304). If the value of Image Box Layout Type is SINGLE, only a single frame shall be referenced, either directly or indirectly; if the value is CINE, only a single multi-frame SOP Instance shall be referenced.
If the value of Image Box Layout Type is STACK, more than one SOP Instance or frame may be referenced, and the frames constitute a stack to be displayed in the Image Box. For frames identified by the Referenced Image Sequence, the order of stepping through the stack shall be the order of Image SOP Instance references in that Sequence. If multiple frames are selected in Referenced Frame Number (0008,1160), those frames shall be stepped through in the order of their listing in that Attribute, within the order of display of their Image SOP Instance.
For a stack whose frames are selected indirectly through an Item of the Referenced Presentation State Sequence, the order of stepping through the stack shall be the order of SOP Instance references in the Referenced Series Sequence (0008,1115) of the referenced Presentation State. For a referenced Blending Softcopy Presentation State, this shall be the Referenced Series Sequence within the Blending Sequence (0070,0402) Item for which the Blending Position (0070,0405) value is UNDERLYING.
Display of images using Blending Softcopy Presentation State must use indirect SOP Instance reference through the Referenced Presentation State Sequence (0008,9237) at the top level of Structured Display Image Box Sequence (0072,0422) Item, and cannot use the Referenced Presentation State Sequence within an Item of the Referenced Image Sequence (0008,1140).
A Blending Presentation State that references a blending of a single underlying frame and a single superimposed frame may be associated with a SINGLE Image Box Layout.
A reference to a single display frame, either directly through Referenced Image Sequence or indirectly through Referenced Presentation State Sequence, may be associated with either a STACK or a CINE Image Box Layout as a degenerate case.
There is no requirement for the pixel matrix sizes of the images in the stack, or the image display area as selected by referenced Presentation State SOP Instances, to be identical, nor for the referenced images to be of the same SOP Class.
Referenced Presentation States are an initial presentation control. The rendering Application Entity might allow a user to interactively enable/disable graphic layers, or change the zoom, rotation, window width / window level, or other presentation controls. Any such Application Entity functionality is beyond the scope of the Standard.
The Referenced Instance Sequence (0008,114A) references a non-Image SOP Instance, e.g., a Structured Report, Waveform, or Encapsulated Document SOP Instance, to be displayed in the image box. For such object references, the value of Image Box Layout Type (0072,0304) shall be SINGLE, even if displaying the object will require scrolling or paging (e.g., a multi-page encapsulated document).
The Referenced Stereometric Instance Sequence (0008,1134) references a Stereometric SOP Instance, whose Stereo Pairs Sequence (0022,0020) references image pairs to be displayed in the Image Box. The number of image pairs referenced for display shall be consistent with the value of Image Box Layout Type (0072,0304). If the value of Image Box Layout Type is SINGLE, only a single pair of frames shall be referenced by the Stereo Pairs Sequence in the referenced Stereometric Instance; if the value is CINE, only a single pair of multi-frame SOP Instances shall be referenced; if the value is STACK, one or more pairs may be referenced constituting a stack to be displayed in the Image Box, and the order of stepping through the stack shall be the order of Items in the Stereo Pairs Sequence. The manner in which a stereo pair is rendered is unspecified.
Type of Synchronization (0072,0434) specifies the method for synchronizing the display of images in two or more Image Boxes linked through the Synchronized Image Box List (0072,0432).
Stepping of frames in one Image Box is synchronized by the stepping of an identical number of frames in the other Image Boxes.
Stepping of frames in one Image Box is synchronized by the stepping of frames in the other Image Boxes to effect an identical relative positional offset within the Patient-Based Coordinate System. This presumes that the referenced images includes Image Position (Patient) (0020,0032) and Image Orientation (Patient) (0020,0037) Attributes, and that the stacks have approximately the same orientation relative to the Patient-Based Coordinate System.
Playback of frames in one Image Box is synchronized by the playback of frames in the other Image Boxes to effect an identical temporal offset from the original displayed frame. This presumes that the referenced images include Frame Time (0018,1063), Frame Time Vector (0018,1065), or Frame Reference DateTime (0018,9151). It also presumes that if the Image Box Layout Type (0072,0304) is STACK, the frames are referenced in a monotonically increasing time order in the stack.
Playback of frames in one Image Box is synchronized by the playback of frames in the other Image Boxes to effect an identical phase offset. This presumes that the referenced frames within each referenced Image Box constitute a uniform sampling across a single "cycle", and that relative position within that cycle is synchronized across all the referenced Image Boxes. For Image Boxes with Image Box Layout Type (0072,0304) value CINE, the set of frames to be displayed as one cycle may be specified either using the Referenced Frame Number (0008,1160) Attribute within the Referenced Image Sequence (0008,1140), or if that Attribute is not present, using the values of Attributes Start Trim (0008,2142) and Stop Trim (0008,2143).
PHASE may be used, for instance, to synchronize display of images representing a single cardiac cycle.
Synchronization of Image Boxes is an initial presentation control. The rendering Application Entity might allow a user to unlink the synchronization, e.g., to navigate to cine frames before the Start Trim (0008,2142) frame or after the Stop Trim (0008,2143) frame. Any such Application Entity functionality is beyond the scope of the Standard.
DICOM PS3.3 2024d - Information Object Definitions |
---|