DICOM PS3.3 2024d - Information Object Definitions

C.10.5 Graphic Annotation Module

This Module defines Attributes of vector graphics and text annotation that shall be made available by a display device to be applied to an image. The graphics and text are defined in position and size relative to the image pixel coordinates or the Specified Displayed Area space (defined in Section C.10.4); in the context of a Volumetric Presentation State IOD, the annotation is relative to the Volumetric Presentation View (e.g., the MPR view defined in Section C.11.26). A Graphic Annotation shall be related to an Image.

Note

See Section A.80.1.4.3 for constraints on Attributes in this Module when used in the Planar MPR Volumetric Presentation State IOD.

Table C.10-5. Graphic Annotation Module Attributes

Attribute Name

Tag

Type

Attribute Description

Graphic Annotation Sequence

(0070,0001)

1

A Sequence of Items each of which represents a group of annotations composed of graphics or text or both.

One or more Items shall be included in this Sequence.

>Referenced Image Sequence

(0008,1140)

1C

The subset of images and frames listed in the Presentation State Relationship Module, to which this graphic annotation applies.

One or more Items shall be included in this Sequence.

Required if graphic annotations in this Item do not apply to all the images and frames listed in the Presentation State Relationship Module.

>>Include Table 10-3 “Image SOP Instance Reference Macro Attributes”

>Graphic Layer

(0070,0002)

1

The layer defined in the Graphic Layer Module in which the graphics or text is to be rendered.

>Text Object Sequence

(0070,0008)

1C

Sequence that describes a text annotation.

One or more Items shall be included in this Sequence.

Either one or both of Text Object Sequence (0070,0008) or Graphic Object Sequence (0070,0009) are required.

>>Bounding Box Annotation Units

(0070,0003)

1C

Units of measure for the axes of the text bounding box.

Defines whether or not the annotation is Image or Displayed Area relative. Both dimensions shall have the same units.

Enumerated Values:

PIXEL

Image relative position specified with sub-pixel resolution such that the origin, which is at the Top Left Hand Corner (TLHC) of the TLHC pixel is 0.0\0.0, the Bottom Right Hand Corner (BRHC) of the TLHC pixel is 1.0\1.0, and the BRHC of the BRHC pixel is Columns\Rows (see Figure C.10.5-1). The values must be within the range 0\0 to Columns\Rows.

DISPLAY

Fraction of Specified Displayed Area where 0.0\0.0 is the TLHC and 1.0\1.0 is the BRHC. The values must be within the range 0.0 to 1.0.

MATRIX

Image relative position specified with sub-pixel resolution such that the origin, which is at the Top Left Hand Corner (TLHC) of the TLHC pixel of the Total Pixel Matrix, is 0.0\0.0, the Bottom Right Hand Corner (BRHC) of the TLHC pixel is 1.0\1.0, and the BRHC of the BRHC pixel of the Total Pixel Matrix is Total Pixel Matrix Columns\Total Pixel Matrix Rows (see Section C.8.12.4.1.3 and Figure C.10.5-1b). The values must be within the range 0.0\0.0 to Total Pixel Matrix Columns\Total Pixel Matrix Rows. MATRIX may be used only if the instance referenced by Referenced Image Sequence (0008,1140) is tiled (i.e., contains Total Pixel Matrix Columns (0048,0006) and Total Pixel Matrix Rows (0048,0007)).

Required if Bounding Box Top Left Hand Corner (0070,0010) or Bounding Box Bottom Right Hand Corner (0070,0011) is present.

>>Anchor Point Annotation Units

(0070,0004)

1C

Units of measure for the axes of the text anchor point annotation.

Enumerated Values for Anchor Point Annotation Units (0070,0004) are the same as for Bounding Box Annotation Units (0070,0003).

Required if Anchor Point (0070,0014) is present.

>>Unformatted Text Value

(0070,0006)

1

Text data that is unformatted and whose manner of display within the defined bounding box or relative to the specified anchor point is implementation dependent. See Section C.10.5.1.1.

The text value may contain spaces, as well as multiple lines separated by CR LF, but otherwise no format control characters (such as horizontal or vertical tab and form feed) shall be present, even if permitted by the Value Representation of ST.

The text shall be interpreted as specified by Specific Character Set (0008,0005) if present in the SOP Common Module.

Note

The text may contain single or multi-byte characters and use code extension techniques as described in PS3.5 if permitted by the values of Specific Character Set (0008,0005).

>>Include Table C.10-5a “Text Style Sequence Macro Attributes”

See Section C.10.5.1.3.12.

>>Bounding Box Top Left Hand Corner

(0070,0010)

1C

Location of the Top Left Hand Corner (TLHC) of the bounding box in which Unformatted Text Value (0070,0006) is to be displayed, in Bounding Box Annotation Units (0070,0003), given as column\row. Column is the horizontal offset and row is the vertical offset.

Required if Anchor Point (0070,0014) is not present. May be present otherwise.

Required if Bounding Box Bottom Right Hand Corner (0070,0011) is present.

>>Bounding Box Bottom Right Hand Corner

(0070,0011)

1C

Location of the Bottom Right Hand Corner (BRHC) of the bounding box in which Unformatted Text Value (0070,0006) is to be displayed, in Bounding Box Annotation Units (0070,0003), given as column\row. Column is the horizontal offset and row is the vertical offset.

Required if Anchor Point (0070,0014) is not present. May be present otherwise.

Required if Bounding Box Top Left Hand Corner (0070,0010) is present.

>>Bounding Box Text Horizontal Justification

(0070,0012)

1C

Location of the text relative to the vertical edges of the bounding box.

Enumerated Values:

LEFT

closest to left edge

RIGHT

closest to right edge

CENTER

centered

Required if Bounding Box Top Left Hand Corner (0070,0010) is present.

>>Anchor Point

(0070,0014)

1C

Location of a point in the image or Specified Displayed Area to which the Unformatted Text Value (0070,0006) is related, in Anchor Point Annotation Units (0070,0004), given as column\row. Column is the horizontal offset and row is the vertical offset.

Required if Bounding Box Top Left Hand Corner (0070,0010) and Bounding Box Bottom Right Hand Corner (0070,0011) are not present. May be present otherwise.

>>Anchor Point Visibility

(0070,0015)

1C

Flag to indicate whether or not a visible indication (such as a line or arrow) of the relationship between the text and the anchor point is to be displayed.

Enumerated Values:

Y

yes

N

no

Required if Anchor Point (0070,0014) is present.

>>Compound Graphic Instance ID

(0070,0226)

3

The identifier of the Compound Graphic represented, in part, by this Item.

The value of this Attribute shall be equal to the value of Compound Graphic Instance ID (0070,0226) of the corresponding Item in the Compound Graphic Sequence (0070,0209).

See Section C.10.5.1.3.1.

>>Graphic Group ID

(0070,0295)

3

A number identifying the group from the Graphic Group Sequence (0070,0234) to which this Item belongs. If this Attribute is not present, this Item does not belong to a group.

If Compound Graphic Instance ID (0070,0226) is present in this Item, the value of Graphic Group ID (0070,0295) shall be the same as the value of Graphic Group ID (0070,0295) of the corresponding Item in the Compound Graphic Sequence (0070,0209) with the same Compound Graphic Instance ID (0070,0226).

>>Tracking ID

(0062,0020)

1C

A text label used for tracking a finding or feature, potentially across multiple reporting objects, over time. This label shall be unique within the domain in which it is used.

Required if Tracking UID (0062,0021) is present.

Note

This Attribute allows linkage to segments in Segmentation Instances with the same value of Tracking ID (0062,0020), and to Content Items in SR Instances with observation context (112039, DCM, "Tracking Identifier") having the same value.

>>Tracking UID

(0062,0021)

1C

A unique identifier used for tracking a finding or feature, potentially across multiple reporting objects, over time.

Required if Tracking ID (0062,0020) is present.

Note

This Attribute allows linkage to segments in Segmentation Instances with the same value of Tracking UID (0062,0021), and to Content Items in SR Instances with observation context (112040, DCM, "Tracking Unique Identifier") having the same value.

>Graphic Object Sequence

(0070,0009)

1C

Sequence that describes a graphic annotation.

One or more Items shall be included in this Sequence.

Either one or both of Text Object Sequence (0070,0008) or Graphic Object Sequence (0070,0009) are required.

>>Graphic Annotation Units

(0070,0005)

1

Units of measure for the axes of the graphic annotation.

Enumerated Values for Graphic Annotation Units (0070,0005) are the same as for Bounding Box Annotation Units (0070,0003).

>>Graphic Dimensions

(0070,0020)

1

Enumerated Values:

2

>>Number of Graphic Points

(0070,0021)

1

Number of data points in this graphic.

>>Graphic Data

(0070,0022)

1

Coordinates that specify this graphic annotation.

See Section C.10.5.1.2 for further explanation.

>>Graphic Type

(0070,0023)

1

The shape of graphic that is to be drawn. See Section C.10.5.1.2.

Enumerated Values:

POINT

POLYLINE

INTERPOLATED

CIRCLE

ELLIPSE

>>Include Table C.10-5b “Line Style Sequence Macro Attributes”

See Section C.10.5.1.3.13.

>>Graphic Filled

(0070,0024)

1C

Whether or not the closed graphics element is displayed as filled (in some unspecified manner that shall be distinguishable from an outline) or as an outline. See Section C.10.5.1.2.

Enumerated Values:

Y

yes

N

no

Required if Graphic Data (0070,0022) is "closed", that is Graphic Type (0070,0023) is CIRCLE or ELLIPSE, or Graphic Type (0070,0023) is POLYLINE or INTERPOLATED and the first data point is the same as the last data point.

>>Include Table C.10-5c “Fill Style Sequence Macro Attributes”

See Section C.10.5.1.3.14.

>>Compound Graphic Instance ID

(0070,0226)

3

The identifier of the Compound Graphic represented, in part, by this Item.

The value of this Attribute shall be equal to the value of Compound Graphic Instance ID (0070,0226) of the corresponding Item in the Compound Graphic Sequence (0070,0209).

See Section C.10.5.1.3.1.

>>Graphic Group ID

(0070,0295)

3

A number identifying the group from the Graphic Group Sequence (0070,0234) to which this Item belongs. If this Attribute is not present, this Item does not belong to a group.

If Compound Graphic Instance ID (0070,0226) is present in this Item, the value of Graphic Group ID (0070,0295) shall be the same as the value of Graphic Group ID (0070,0295) of the corresponding Item in the Compound Graphic Sequence (0070,0209) with the same Compound Graphic Instance ID (0070,0226).

>>Tracking ID

(0062,0020)

1C

A text label used for tracking a finding or feature, potentially across multiple reporting objects, over time. This label shall be unique within the domain in which it is used.

Required if Tracking UID (0062,0021) is present.

Note

This Attribute allows linkage to segments in Segmentation Instances with the same value of Tracking ID (0062,0020), and to Content Items in SR Instances with observation context (112039, DCM, "Tracking Identifier") having the same value.

>>Tracking UID

(0062,0021)

1C

A unique identifier used for tracking a finding or feature, potentially across multiple reporting objects, over time.

Required if Tracking ID (0062,0020) is present.

Note

This Attribute allows linkage to segments in Segmentation Instances with the same value of Tracking UID (0062,0021), and to Content Items in SR Instances with observation context (112040, DCM, "Tracking Unique Identifier") having the same value.

>Compound Graphic Sequence

(0070,0209)

3

A Sequence of Items that describe Compound Graphics.

One or more Items are permitted in this Sequence.

For each Compound Graphic there shall be an alternate rendering encoded as Items in the Text Object Sequence (0070,0008) and Graphic Object Sequence (0070,0009) linked by the Compound Graphic Instance ID (0070,0226).

See Section C.10.5.1.3.1.

>>Compound Graphic Instance ID

(0070,0226)

1

A number that identifies the Compound Graphic described in this Item. The value shall be unique within this SOP Instance.

See Section C.10.5.1.3.1.

>>Compound Graphic Units

(0070,0282)

1

Type of dimension used in Attributes for the Compound Graphic when specifying distances and locations.

Enumerated Values:

PIXEL

When an Attribute value specifies a location, it shall be an image relative position specified with sub-pixel resolution such that the origin at the Top Left Hand Corner (TLHC) of the TLHC pixel is 0.0\0.0, the Bottom Right Hand Corner (BRHC) of the TLHC pixel is 1.0\1.0, and the BRHC of the BRHC pixel is Columns\Rows (see Figure C.10.5-1). The values must be within the range 0\0 to Columns\Rows. When an Attribute value specifies a distance the distance shall be in pixels.

DISPLAY

When an Attribute value specifies a location, it shall be a fraction of Specified Displayed Area where 0.0\0.0 is the TLHC and 1.0\1.0 is the BRHC. The values must be within the range 0.0 to 1.0. When an Attribute value specifies a distance the distance shall be in fraction of Specified Displayed Area.

>>Graphic Dimensions

(0070,0020)

1

Enumerated Values:

2

>>Number of Graphic Points

(0070,0021)

1

Number of data Items, e.g., points, in this Compound Graphic.

>>Graphic Data

(0070,0022)

1

Numerical data Items that specify this Compound Graphic (points, vectors and scalars).

See Section C.10.5.1.3 for further explanation.

>>Compound Graphic Type

(0070,0294)

1

The shape of this Compound Graphic.

See Section C.10.5.1.3.

Defined Terms:

MULTILINE

INFINITELINE

CUTLINE

RANGELINE

RULER

AXIS

CROSSHAIR

ARROW

RECTANGLE

ELLIPSE

Note

Implementers may add private graphic types.

>>Include Table C.10-5a “Text Style Sequence Macro Attributes”

See Section C.10.5.1.3.12.

>>Include Table C.10-5b “Line Style Sequence Macro Attributes”

See Section C.10.5.1.3.13.

>>Rotation Angle

(0070,0230)

3

The rotation of this Compound Graphic in degrees. Value shall be in degrees, between 0 and 360.

See Section C.10.5.1.3.

>>Rotation Point

(0070,0273)

1C

The rotation point of this Compound Graphic.

See Section C.10.5.1.3.

Required if Rotation Angle (0070,0230) is present or if Compound Graphic Type (0070,0294) is CUTLINE or INFINITELINE.

>>Gap Length

(0070,0261)

1C

Diameter of the circle around Rotation Point (0070,0273) where the CUTLINE or INFINITELINE is not rendered.

Diameter of the circle around the origin, specified by Graphic Data (0070,0022) where the CROSSHAIR is not rendered.

The Compound Graphic Units (0070,0282) of Gap Length (0070,0261) shall be DISPLAY.

See Section C.10.5.1.3.

Required if Compound Graphic Type (0070,0294) equals CUTLINE, INFINITELINE or CROSSHAIR.

>>Diameter of Visibility

(0070,0262)

1C

Diameter of the circle around the CROSSHAIR origin where the CROSSHAIR is visible. The Compound Graphic Units (0070,0282) of the Diameter of Visibility (0070,0262) shall be DISPLAY.

See Section C.10.5.1.3.10

Required if Compound Graphic Type (0070,0294) equals CROSSHAIR.

>>Major Ticks Sequence

(0070,0287)

1C

The sequence of major ticks on the AXIS object.

Two or more Items shall be present.

Required if Compound Graphic Type (0070,0294) equals AXIS.

>>>Tick Position

(0070,0288)

1

The position of the tick in the range 0.0 (start point) to 1.0 (end point).

>>>Tick Label

(0070,0289)

1

The label of the tick.

>>Tick Alignment

(0070,0274)

1C

The alignment of the ticks with respect to the line.

Enumerated Values:

BOTTOM

CENTER

TOP

See Section C.10.5.1.3.

Required if Compound Graphic Type (0070,0294) equals RULER, AXIS or CROSSHAIR.

>>Tick Label Alignment

(0070,0279)

1C

The alignment of the label with respect to the tick.

Enumerated Values:

BOTTOM

TOP

See Section C.10.5.1.3.

Required if Compound Graphic Type (0070,0294) equals RULER, AXIS, or CROSSHAIR.

>>Show Tick Label

(0070,0278)

1C

Indicates whether the tick label should be initially visible.

Enumerated Values:

Y

Yes

N

No

Required if Compound Graphic Type (0070,0294) equals RULER, AXIS or CROSSHAIR.

>>Graphic Filled

(0070,0024)

1C

Indicates whether or not the Compound Graphics is displayed as filled.

Enumerated Values:

Y

yes

N

no

Required if Compound Graphic Type (0070,0294) equals RECTANGLE or ELLIPSE.

>>Include Table C.10-5c “Fill Style Sequence Macro Attributes”

In this Module, Attribute Fill Style Sequence (0070,0233) is Type 1C.

Required if Graphic Filled (0070,0024) equals Y.

See Section C.10.5.1.3.14.

>>Graphic Group ID

(0070,0295)

3

A number that defines the corresponding group object in the Graphic Group Sequence (0070,0234). If the Attribute is not present the object does not belong to a group.


C.10.5.1 Graphic Annotation Module Attribute Descriptions

C.10.5.1.1 Unformatted Text Value

The text shall be displayed if any part of the bounding box or anchor point is within the Specified Display Area.

The text need not be confined to within the bounding box, but shall be rendered in a direction from the Top Left Hand Corner (TLHC) of the bounding box to the Bottom Right Hand Corner (BRHC) of the bounding box, even if these coordinates have been specified in an image relative space and then transformed (rotated, flipped or scaled).

Note

  1. An implementation may render text outside the confines of the bounding box if necessary to display all the specified text.

  2. Alternatively, an implementation may choose to render the text in a scrolling box, or a link to another fixed or popup window as appropriate.

Whether the contents of the bounding box completely opacify the underlying image or whether the box is "transparent" is undefined.

Note

  1. For example, an implementation may choose an "exclusive or" style opacification to be sure that the text is discernible over light and dark portions of the image.

  2. Commonly, the region of the bounding box around the text will be rendered "transparently", i.e., the image will be visible, though some implementations may choose to opacify the bounding box behind the text to improve its readability.

An alternative to specifying a bounding box, is to specify an Anchor Point (0070,0014), i.e., some point in an image or Specified Displayed Area that is related to the text. The semantics of this relationship, and the manner of positioning or linking the text to this point, are unspecified.

Note

  1. For example, a description of a feature may be linked to a point in the image, and when that image is displayed, if it is magnified and panned, the rendered text (and any arrow or line drawn in response to Anchor Point Visibility (0070,0015)) might be repositioned as appropriate so as not to be cropped out of the Specified Displayed Area.

  2. As another example, the text could be rendered in a pop-up window when a hypertext link flagged on the displayed image at the location of Anchor Point (0070,0014) is selected.

  3. The bounding box and anchor point need not be defined with the same axis units, i.e., one can be image pixel relative, and the other displayed area relative.

The size, font and rotation of the individual rendered text characters are unspecified.

C.10.5.1.2 Graphic Data and Graphic Type

Graphic Data (0070,0022) contains the points in the graphic annotation, each dimension for the first point, followed by dimensions for second point, etc. For a two dimensional curve: X1, Y1, X2, Y2, etc. The first (X) dimension corresponds to the image or Specified Displayed Area column (horizontal offset), and the second (Y) dimension corresponds to the image or Specified Displayed Area row (vertical offset). The Value Representation of all components of the N-tuple shall be the same. The image or Specified Displayed Area relative drawing space is defined in Graphic Annotation Units (0070,0005).

If Graphic Type (0070,0023) is POINT, then two values (one point) shall be specified and the single point specified is to be drawn.

If Graphic Type (0070,0023) is POLYLINE, then the points are to be interpreted as an n-tuple list of end points between which straight lines are to be drawn.

If Graphic Type (0070,0023) is INTERPOLATED, then the points are to be interpreted as an n-tuple list of end points between which some form of implementation dependent curved lines are to be drawn. The rendered line shall pass through all the specified points.

If Graphic Type (0070,0023) is CIRCLE, then exactly two points shall be present; the first point is to be interpreted as the center and the second point as a point on the circumference of a circle, some form of implementation dependent representation of which is to be drawn.

If Graphic Type (0070,0023) is ELLIPSE, then exactly four points shall be present; the first two points are to be interpreted as the endpoints of the major axis and the second two points as the endpoints of the minor axis of an ellipse, some form of implementation dependent representation of which is to be drawn.

The notion of "open" or "closed" has no inherent meaning in the context of an arbitrary graphic, other than in the condition for the presence of Graphic Filled (0070,0024). The graphic has no semantic notion of an associated observation such as a region of interest, except that which the unformatted text in the same Item may describe.

The choice of pixel value used to represent the graphic on a display is defined in the Graphic Layer Module.

Sub-pixel Addressing Units in PIXEL Space

Figure C.10.5-1. Sub-pixel Addressing Units in PIXEL Space


Sub-pixel Addressing Units in MATRIX Space

Figure C.10.5-1b. Sub-pixel Addressing Units in MATRIX Space


C.10.5.1.3 Compound Graphic Sequence

The Attributes of the Compound Graphic Sequence (0070,0209) are described within this section.

For point encoding rules of Graphic Data (0070,0022) See Section C.10.5.1.2.

All graphics are applied after the application of the image rendering pipeline.

C.10.5.1.3.1 Compound Graphic Instance ID

Every Item in the Compound Graphic Sequence shall have a Compound Graphic Instance ID (0070,0226) with a value that is unique within this Sequence.

There shall be one or more Items in the Graphic Object Sequence or Text Object Sequence that represents an alternate rendering of the Compound Object Sequence Item. As a linkage for backward compatibility these Items share the same Compound Graphic Instance ID (0070,0226).

Note

Every Compound Graphic has an equivalent rendering encoded as a set of simple graphic objects linked by the Compound Graphic Instance ID (0070,0226). Simple graphic objects are elements such as points, polylines, interpolated lines, circles and ellipses. The equivalent rendering is a set of simple graphic objects to support an SCP that only understands the simple graphical objects.

C.10.5.1.3.2 Rotation

All Compound Graphics can be rotated by specifying a Rotation Angle (0070,0230) value and a Rotation Point (0070,0273). The convention for rotation is that positive angle values are defined as counterclockwise around Rotation Point (0070,0273).

C.10.5.1.3.3 Ellipses

For the Compound Graphic Type (0070,0294) ELLIPSE, exactly 2 points shall be present inside Graphic Data (0070,0022). The first point is the top/left hand corner (TLHC) and the second point is the bottom/right hand corner (BRHC) of the bounding rectangle (see Figure C.10.5-2).

ELLIPSE on the left and RECTANGLE object on the right

Figure C.10.5-2. ELLIPSE on the left and RECTANGLE object on the right


C.10.5.1.3.4 Rectangles

For the Compound Graphic Type (0070,0294) RECTANGLE, exactly 2 points shall be present inside Graphic Data (0070,0022). The first point is the top/left hand corner of the rectangle (TLHC) and the second point is the bottom/right hand corner (BRHC) of the rectangle (see Figure C.10.5-2).

C.10.5.1.3.5 Multi-lines

For the Compound Graphic Type (0070,0294) MULTILINE, the list of points inside Graphic Data (0070,0022) is an n-tuple list of start and end points of straight lines to be drawn (see Figure C.10.5-3).

If Rotation Angle (0070,0230) is present, all points in the MULTILINE are rotated around the same Rotation Point (0070,0273).

Example for MULTILINE Object

Figure C.10.5-3. Example for MULTILINE Object


C.10.5.1.3.6 Cut and Infinite-lines

For the Compound Graphic Type (0070,0294) CUTLINE or INFINITELINE, exactly two points shall be present inside Graphic Data (0070,0022). The rendering of these lines always extends to the borders of the render area of a view(see Figure C.10.5-4).

INFINITELINE

Figure C.10.5-4. INFINITELINE


CUTLINE on the Left and CUTLINE with gap on the Right

Figure C.10.5-5. CUTLINE on the Left and CUTLINE with gap on the Right


In case of a CUTLINE, two arrows shall be drawn perpendicular to the cutline. The arrows ends shall be positioned at the midpoints of each half of the cutline. The arrow heads shall point toward the cutline and shall be drawn in the positive right half-plane of the cutline before rotation. Typically, the arrows indicate the viewing direction for MPR renderings that are referenced by these lines.

Gap Length (0070,0261) defines the diameter of the circular area where the CUTLINE or INFINITELINE is not rendered. Center of the circular area is Rotation Point (0070,0273). Since the dimension units of the Gap Length is DISPLAY, independent of the value of Compound Graphic Units (0070,0282), the length of the gap is not changed by zoom operations on the image performed by the application.

C.10.5.1.3.7 Range Lines

For the Compound Graphic Type (0070,0294) RANGELINE exactly two points shall be present inside Graphic Data (0070,0022).

RANGELINE Example

Figure C.10.5-6. RANGELINE Example


C.10.5.1.3.8 Ruler

For the Compound Graphic Type (0070,0294) RULER, exactly two points shall be present inside Graphic Data (0070,0022) defining the ruler line.

Tick Alignment (0070,0274) defines the alignment of the ticks.

BOTTOM - ticks are aligned to the lower part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

CENTER - ticks are centered on the line.

TOP - ticks are aligned to the upper part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

Tick Label Alignment (0070,0279) defines the alignment of the tick labels.

BOTTOM - labels are aligned to the lower part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

TOP - labels are aligned to the upper part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

The presence, labeling and units of the ticks on the line is application dependent(see Figure C.10.5-7). If present as numerical values, the labels of the ticks shall increase toward the second point.

C.10.5.1.3.9 Axis

For the Compound Graphic Type (0070,0294) AXIS, exactly two points shall be present inside Graphic Data (0070,0022) defining the axis line.

RULER / AXIS Example Showing TOP Tick Alignment and TOP Tick Label Alignment

Figure C.10.5-7. RULER / AXIS Example Showing TOP Tick Alignment and TOP Tick Label Alignment


The Major Ticks Sequence (0070,0287) specifies the placement and label of the ticks. The rendering of the minor ticks is left to the application.

Tick Alignment (0070,0274) defines the alignment of the ticks.

BOTTOM - ticks are aligned to the lower part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

CENTER - ticks are centered on the line.

TOP - ticks are aligned to the upper part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

Tick Label Alignment (0070,0279) defines the alignment of the tick labels.

BOTTOM - labels are aligned to the lower part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

TOP - labels are aligned to the upper part of the line, where the first point of the line is on the left and the line extends horizontally to the right.

C.10.5.1.3.10 Crosshairs

For Compound Graphic Type (0070,0294) CROSSHAIR, exactly one point shall be present inside Graphic Data (0070,0022). This point is the origin of the CROSSHAIR (see Figure C.10.5-8).

Tick Alignment (0070,0274) and Tick Label Alignment (0070,0279) are also valid for the CROSSHAIR. Tick rendering is application dependent.

CROSSHAIR Example Showing BOTTOM Tick Labels Alignment

Figure C.10.5-8. CROSSHAIR Example Showing BOTTOM Tick Labels Alignment


Gap Length (0070,0261) defines the diameter of the circular area around the origin where the CROSSHAIR is not rendered. Since the dimension units of the Gap Length is DISPLAY, independent of the value of Compound Graphics Units (0070,0282), the length of the gap is not changed by zoom operations on the image performed by the application.

Diameter of Visibility (0070,0262) defines the diameter of the circular area around the origin where the CROSSHAIR is rendered. Since the dimension units of the Diameter of Visibility is DISPLAY, independent of the value of Compound Graphic Units (0070,0282), the size of the crosshair is not changed by zoom operations on the image performed by the application.

The value of Tick Alignment (0070,0274) shall be CENTER.

C.10.5.1.3.11 Arrows

For the Compound Graphic Type (0070,0294) ARROW, two points shall be present inside Graphic Data (0070,0022). The first point is the anchor point, the second point is the foot point of the arrow(see Figure C.10.5-9). The arrow head style at the anchor point is not specified.

ARROW Example

Figure C.10.5-9. ARROW Example


C.10.5.1.3.12 Text Style Sequence

Text Style Sequence (0070,0231) contains the text style for each text object. This Attribute gives recommendations on how the annotation text should be rendered at the display.

C.10.5.1.3.12.1 Text Alignment

Horizontal Alignment (0070,0242) and Vertical Alignment (0070,0243) define the position of the text relative to the bounding box of the text object (see Figure C.10.5-10).

Example of Horizontal and Vertical CENTER Alignment

Figure C.10.5-10. Example of Horizontal and Vertical CENTER Alignment


C.10.5.1.3.12.2 Text Style Sequence Macro

Table C.10-5a specifies the Attributes of the Text Style Sequence Macro.

Table C.10-5a. Text Style Sequence Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Text Style Sequence

(0070,0231)

3

Sequence that describes the text style.

Only a single Item shall be included in this Sequence.

>Font Name

(0070,0227)

3

Font name in a standard type.

>Font Name Type

(0070,0228)

1C

Defined Terms:

ISO_32000

Required if Font Name (0070,0227) is present.

Note

This is the font naming system used by Adobe PDF and defined in ISO/IEC 14496-22.

>CSS Font Name

(0070,0229)

1

Generic font name as defined within CSS (Cascading Style Sheets). Default fontname, if the font specified in Font Name (0070,0227) is not present or can not be rendered.

>Text Color CIELab Value

(0070,0241)

1

A default color triplet value used to specify the text color in which it is recommended that the text be rendered on a color display. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

This value shall override the Graphic Layer Recommended Display CIELab Value (0070,0401).

>Horizontal Alignment

(0070,0242)

1C

Specifies the horizontal position of the text relative to the vertical edges of the bounding box. Horizontal Alignment shall override the Bounding Box Text Horizontal Justification (0070,0012) of the Text Object Sequence (0070,0008) Item. See Section C.10.5.1.3.12.1

Enumerated Values:

LEFT

CENTER

RIGHT

Required if Bounding Box Top Left Hand Corner (0070,0010) is present.

>Vertical Alignment

(0070,0243)

1C

Specifies the vertical position of the text relative to the horizontal edges of the bounding box. See Section C.10.5.1.3.12.1

Enumerated Values:

TOP

CENTER

BOTTOM

Required if Bounding Box Top Left Hand Corner (0070,0010) is present.

>Shadow Style

(0070,0244)

1

The shadow style of the text to be displayed.

Enumerated Values:

NORMAL

the shadow is drawn on 1 side of the contour of the text object

OUTLINED

the shadow is drawn around the contour of the text object

OFF

no shadow

See Section C.10.5.1.3.13.1

>Shadow Offset X

(0070,0245)

1C

Floating point value that defines the shadow offset in X direction in Anchor Point Annotation Units (0070,0004) if used in Text Object Sequence (0070,0008) Item or in Graphic Annotation Units (0070,0005) if used in Graphic Object Sequence (0070,0009) Item. See Section C.10.5.1.3.13.1

Required if Shadow Style (0070,0244) value is not OFF.

>Shadow Offset Y

(0070,0246)

1C

Floating point value that defines the shadow offset in Y direction in Anchor Point Annotation Units (0070,0004) if used in Text Object Sequence (0070,0008) Item or in Graphic Annotation Units (0070,0005) if used in Graphic Object Sequence (0070,0009) Item. See Section C.10.5.1.3.13.1

Required if Shadow Style (0070,0244) value is not OFF.

>Shadow Color CIELab Value

(0070,0247)

1C

A color triplet value used to encode the Shadow Color. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

Required if Shadow Style (0070,0244) value is not OFF.

>Shadow Opacity

(0070,0258)

1C

Encodes the shadow opacity. The value is encoded as floating point alpha value (0.0-1.0).

Required if Shadow Style (0070,0244) value is not OFF.

>Underlined

(0070,0248)

1

Specifies whether or not the text shall be rendered underlined.

Enumerated Values:

Y

yes

N

no

>Bold

(0070,0249)

1

Specifies whether or not the text shall be rendered in bold.

Enumerated Values:

Y

yes

N

no

>Italic

(0070,0250)

1

Specifies whether or not the text shall be rendered italicized.

Enumerated Values:

Y

yes

N

no


C.10.5.1.3.13 Line Style Sequence

Table C.10-5b specifies the Attributes of the Line Style Sequence.

Table C.10-5b. Line Style Sequence Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Line Style Sequence

(0070,0232)

3

Sequence that describes the line style.

Only a single Item shall be included in this Sequence.

>Pattern On Color CIELab Value

(0070,0251)

1

A color triplet value used to encode the foreground. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

This value shall override the Graphic Layer Recommended Display CIELab Value (0070,0401).

>Pattern Off Color CIELab Value

(0070,0252)

3

A color triplet value used to encode the color of parts of the line that are off, i.e., the background. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

>Pattern On Opacity

(0070,0284)

1

Encodes the foreground opacity. The value is encoded as floating point alpha value (0.0-1.0).

>Pattern Off Opacity

(0070,0285)

3

Encodes the background opacity. The value is encoded as floating point alpha value (0.0-1.0).

>Line Thickness

(0070,0253)

1

Specifies the line thickness. The dimension for this Attribute is defined by Graphic Annotation Units (0070,0005) or Compound Graphic Units (0070,0282).

>Line Dashing Style

(0070,0254)

1

The dashing style of the line to be displayed.

Enumerated Values:

SOLID

DASHED

Draws one part of the line with the Pattern On Color CIELab Value (0070,0251) and the other part with the Pattern Off Color CIELab Value (0070,0252).

See Section C.10.5.1.3.13.1.

>Line Pattern

(0070,0255)

1C

Pattern that defines the line dashing style. The Line Pattern is a 32 bit value. If the bit inside the pattern is set to 1 the foreground color is drawn, else the background color is drawn.

Note

For example, 00FFH defines the dashes with an equal size.

Required if Line Dashing Style (0070,0254) has a value of DASHED.

>Shadow Style

(0070,0244)

1

The shadow style of the line to be displayed.

Enumerated Values:

NORMAL

the shadow is drawn on 1 side of the contour of the text object

OUTLINED

the shadow is drawn around the contour of the text object

OFF

no shadow

See Section C.10.5.1.3.13.2

>Shadow Offset X

(0070,0245)

1

Floating point value that defines the shadow offset in X direction in Graphic Annotation Units (0070,0005). See Section C.10.5.1.3.13.2.

>Shadow Offset Y

(0070,0246)

1

Floating point value that defines the shadow offset in Y direction in Graphic Annotation Units (0070,0005). See Section C.10.5.1.3.13.2.

>Shadow Color CIELab Value

(0070,0247)

1

A color triplet value used to encode the Shadow Color. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

>Shadow Opacity

(0070,0258)

1

Encodes the shadow opacity. The value is encoded as floating point alpha value (0.0-1.0).


C.10.5.1.3.13.1 Line Dashing Style

The Line Dashing Style (0070,0254) value SOLID indicates the line to be drawn with the foreground color, which is specified by Pattern On Color CIELab Value (0070,0251).

The Line Dashing Style (0070,0254) Attribute does not apply to shadows, which shall always be rendered in SOLID background color.

C.10.5.1.3.13.2 Shadows

Shadow Style (0070,0244) contains one of the values OFF, NORMAL or OUTLINED (see Figure C.10.5-11 and Figure C.10.5-12). Shadow shall be applied after rotation. The coordinate system of the shadow is relative to the line. Shadow Offset X (0070,0245) extends to the right and Shadow Offset Y (0070,0246) extends downward.

Example for Shadow Style (0070,0244) NORMAL

Figure C.10.5-11. Example for Shadow Style (0070,0244) NORMAL


The OUTLINED shadow defines a filled outline shadow. The length of the vector given by Shadow Offset X (0070,0245) and Shadow Offset Y (0070,0246) defines the radius of the shadow.

Example for Shadow Style (0070,0244) OUTLINED

Figure C.10.5-12. Example for Shadow Style (0070,0244) OUTLINED


C.10.5.1.3.14 Fill Style Sequence Macro

Table C.10-5c specifies the Attributes of the Fill Style Sequence Macro.

Table C.10-5c. Fill Style Sequence Macro Attributes

Attribute Name

Tag

Type

Attribute Description

Fill Style Sequence

(0070,0233)

3

Sequence that describes the fill style.

Only a single Item is permitted in this Sequence.

>Pattern On Color CIELab Value

(0070,0251)

1

A color triplet value used to encode the foreground color. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

This value shall override the Graphic Layer Recommended Display CIELab Value (0070,0401).

>Pattern Off Color CIELab Value

(0070,0252)

3

A color triplet value used to encode the background color. The units are specified in PCS-Values, and the value is encoded as CIELab. See Section C.10.7.1.1.

>Pattern On Opacity

(0070,0284)

1

Encodes the foreground opacity. The value is encoded as floating point alpha value (0.0-1.0).

>Pattern Off Opacity

(0070,0285)

1

Encodes the background opacity. The value is encoded as floating point alpha value (0.0-1.0).

>Fill Mode

(0070,0257)

1

The texture of the closed object to be displayed.

Enumerated Values:

SOLID

STIPPELED

See Section C.10.5.1.3.14.1.

>Fill Pattern

(0070,0256)

1C

A binary fill pattern. A set bit corresponds to foreground. An unset bit corresponds to background.

A 128 byte value defining a 32x32 1 bit matrix. This fill pattern is replicated in tiles inside the boundaries of the graphic type.

The most significant bit corresponds to the leftmost pixel in the row.

The fill pattern relates to display pixels where one bit value corresponds to one display pixel.

Required if Fill Mode (0070,0257) equals STIPPELED.


C.10.5.1.3.14.1 Fill Mode

Fill Mode (0070,0257) value SOLID indicates that the graphic object is filled with the foreground.

Fill Mode (0070,0257) Attribute does not interfere with (line) shadows, which shall always be rendered in SOLID background color.

DICOM PS3.3 2024d - Information Object Definitions