DICOM Text Display



Parameters from DICOM files may be placed on the image. The user may customize the selection and placement of specific parameters.  The font size and color may also be specified.

Statements are placed in an ASCII text file and are compiled at run time.  To include your own custom DICOM annotation configuration,  enter the filename of your file in the configuration file preceded by the  DICOM  keyword.

Example:  DICOM C:\FPIMAGE\BIN\GEN_ZEUS.FMT

Up to 50 custom formats may be specified at one time.  Each format is searched for matches in the order that specified by the  DICOM  statements in the configuration file. As a rule of thumb,  place the most frequently encountered image files at the top of the list.
 

Format Statements:

Image files are identified by searching fields of  DICOM tags  using the SEARCH  statement.  The following example searches the modality (hex tags 08, 60),  manufacturer and model fields.

Example:

Name "GE Genesis Zeus"
Search 0x00080060 "CT"
Search 0x00080070 "GE MEDICAL SYSTEMS"
Search 0x00081090 "GENESIS_ZEUS"

If the image file matches the above then this file will be used for parameter formatting.


The text font and color parameters are specified as:

FONT  “facename”  size  boldness  red  green  blue

Example:  Font "Arial" 22 500 0 255 0


The text background color parameters are specified as:

TEXTBKND   red   green   blue
or
TEXTBKND   none

Examples:

TextBknd  0 0 0 # Black
TextBknd  255 255 255 # White
TextBknd  none # Transparent


The  ALIGN  parameter specifies the alignment of the text.

Right will right justify the text.  Left will left justify the text. The default is Left.

Example:   ALIGN Right


The  COORDS  parameter specifies how the x and y locations are orientated.

Normal indicates the 0,0 coordinates are located at the upper left corner of the image.
Right puts 0,0 and the upper right corner of the image.

Bottom starts at the lower left corner.

Example:   COORDS Normal



The  TAG  statement extracts fields from the image file and prints them on the image.
It is specified  as:   TAG   type   x   y   tagnum
 
type
Description
AN Alpha-Numeric (can be any text)
DA (used to format date fields)
TM Time (used to format time fields)
FL Floating Point (to be used with numeric values)

The  x  and  y  coordinates specifies the starting location (upper left) of the text to be printed (relative to the COORDS parameter).

The   tagnum   parameter specifies the field to extract. These are expressed as hexadecimal  numbers.

Example:

Tag AN 10 0 0x0          # The NAME of this format
Tag AN 10 25 0x00080080  # Hospital Name
Tag AN 350 0 0x00100010  # Patient Name
Tag AN 430 25 0x00100020 # Patient ID
Tag AN 460 50 0x00101010 # Patient Age
Tag DA 10 50 0x00080023  # Image Date
Tag TM 10 75 0x00080030  #       Time


It may necessary to print your own text on to the image as to identify a particular text or numeric field.
The Text statement is specified as:  TEXT   x     y   “text”
The  x  and  y  parameters are the starting location. All text must enclosed in quotes.

Example:

Text 10 400 "KV:"
Tag FL 45 400 0x00180060
Text 10 425 "MA:"
Tag FL 50 425 0x00180090
Text 10 450 "Slice: "
Tag FL 70 450 0x00180050
Text 10 475 "Loc: "
Tag FL 60 475 0x00201041


Use the  MULTIFORMAT  parameter to start a separate annotation configuration for use with viewports.

Example:   MultiFormat


Sample FMT file
 

Name "Elscint Privilege"
Search 0x00080060 "MR"
Search 0x00080070 "Elscint"
 

Font "Arial" 16 500 0 255 0
TextBknd none

ALIGN Left
COORDS Right
Tag AN 0 0 0x00080080    # Hospital Name
Tag AN 0 15 0x00100010   # Patient Name
Tag AN 0 30 0x00100020   # Patient ID
Tag DA 0 45 0x00080023   # Image Date
Tag TM 0 60 0x00080030   #       Time

Text 0 75 "SAR: "
Tag FL 35 75 0x00181316
Text 0 90 "Angle: "
Tag FL 40 90 0x00181314
Text 0 105 "Seq: "
Tag AN 33 105 0x00180024
Text 0 120 "Acq: "
Tag AN 33 120 0x00180023
Text 0 135 "TR: "
Tag FL 25 135 0x00180080
Text 0 150 "TE: "
Tag FL 25 150 0x00180081
Text 0 165 "Slice: "
Tag FL 35 165 0x00180050
Text 0 180 "Loc: "
Tag FL 28 180 0x00201041
Text 0 195 "Coil: "
Tag AN 38 195 0x00181250
Text 0 210 "Dir: "
Tag AN 33 210 0x00181312

Tag AN 0 225 0x00181030

MultiFormat
 

ALIGN Right
COORDS Right
 

Tag AN 0 0 0x00080080    # Hosptital Name
Tag AN 0 15 0x00100010   # Patient Name
Tag AN 0 30 0x00100020   # Patient ID
Tag DA 0 45 0x00080023   # Image Date
Tag TM 0 60 0x00080030   #       Time
 

COORDS Normal
COORDS Bottom
ALIGN Left

Text 2 -30 "Coil: "
Tag AN 30 -30 0x00181250

Text 2 -150 "Dir: "
Tag AN 28 -150 0x00181312
Text 2 -90 "SAR: "
Tag FL 35 -90 0x00181316
Text 2 -105 "Angle: "
Tag FL 40 -105 0x00181314
Text 2 -120 "Seq: "
Tag AN 33 -120 0x00180024
Text 2 -135 "Acq: "
Tag AN 33 -135 0x00180023
Text 2 -75 "TR: "
Tag FL 25 -75 0x00180080
Text 2 -60 "TE: "
Tag FL 25 -60 0x00180081
Text 2 -45 "MM: "
Tag FL 28 -45 0x00180050
Text 2 -165 "Loc: "
Tag FL 28 -165 0x00201041

Tag AN 2 -15 0x00181030