Gap Length Attribute
| Tag | (0070,0261) |
|---|---|
| Type | Conditionally Required (1C) |
| Keyword | GapLength |
| Value Multiplicity | 1 |
| Value Representation | Single (FL) |
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.
Section C.10.5.1.3
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).
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).
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).
Figure C.10.5-4. INFINITELINE
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).
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.
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.
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.
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).
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:
Required if Font Name (0070,0227) is present. NoteThis 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:
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:
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:
|
|
>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:
|
|
>Bold |
(0070,0249) |
1 |
Specifies whether or not the text shall be rendered in bold. Enumerated Values:
|
|
>Italic |
(0070,0250) |
1 |
Specifies whether or not the text shall be rendered italicized. Enumerated Values:
|
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:
|
|
>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. NoteFor 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:
|
|
>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.
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.
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:
|
|
>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.