Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / Using IDL / Using TrueType Fonts

IDL

Using TrueType Fonts

Using TrueType Fonts

IDL includes the following TrueType fonts:

Regular

Italic

Bold

Bold Italic

Courier

Courier Italic

Courier Bold

Courier Bold Italic

Helvetica

Helvetica Italic

Helvetica Bold

Helvetica Bold Italic

Times

Times Italic

Times Bold

Times Bold Italic

DejaVuSans

DejaVuSans Italic

DejaVuSans Bold

DejaVuSans Bold Italic

Symbol

Monospace Symbol

DejaVuSymbol

To use the TrueType font system with IDL Direct Graphics, either set the value of the IDL system variable !P.FONT equal to 1 (one), or set the FONT keyword to on one of the Direct Graphics routines equal to 1. To use the TrueType font system with IDL Object Graphics, consult "IDLgrFont." To use the truetype fonts with IDL's Graphics functions, see the TEXT function.

For Direct Graphics, use the SET_FONT and TT_FONT keywords to the DEVICE routine to select the font to use. For example, to plot using "Helvetica Bold Italic", use the following statements:

DEVICE, SET_FONT='Helvetica Bold Italic', /TT_FONT
PLOT, RANDOMU(seed, 10), CHARSIZE=2, FONT=1, TITLE='My Plot'

For IDL's Graphics functions, the default is 11-point DejaVuSans. Use the FONT_NAME and FONT_STYLE keywords to select the font. For example:

p = PLOT(/TEST, FONT_NAME='Times', FONT_STYLE='Bold italic',
  FONT_SIZE=14, TITLE='My Plot')

For object graphics, the default TrueType font is 12-point Helvetica regular.

You can also use Embedded Formatting Commands to position text and change fonts within a single line of text.

TrueType Font Samples


The following figures show roman versions of the TrueType font families included with IDL. The character sets for the bold, italic, and bold italic versions of these fonts are the same as the roman versions.

The SHOWFONT command was used to create these figures. For example, to display the following figure on the screen, you would the command:

SHOWFONT, 'DejaVuSans', 'DejaVu Sans', /TT_FONT

Note: The DejaVu Sans font includes many more Unicode characters. The SHOWFONT command may be used to view the additional characters.

Note: To read the character number, add the column index (along the top) to the row index. For example, the capital letter "A" is 65, and the "+" symbol is 43.

Adding New TrueType Fonts


To add a your own font to the list of fonts known to IDL, use a text editor to edit the ttfont.map file, adding the FontName, FileName, DirectGraphicsScale, and ObjectGraphicsScale fields for your font.

The TrueType font system relies on a resource file named ttfont.map, located in the resource/fonts/tt subdirectory of the IDL directory. The format of the ttfont.map file is:

FontName    FileName    DirectGraphicsScale    ObjectGraphicsScale

where the fields in each column must be separated by white space (spaces and/or tabs). The fields contain the following information:

  • Fontname: the name that would be used for the SET_FONT keywords to the DEVICE routine.
  • Filename: the name of the TrueType font file. On UNIX platforms, IDL will search for the file specified in the FileName field in the current directory (that is, in the resource/fonts/tt subdirectory of the IDL directory) if a bare filename is provided, or it will look for the file in the location specified by the fully-qualified file name if a complete path is provided. Because different platforms use different path-specification syntax, we recommend that you place any TrueType font files you wish to add to the ttfont.map file in the resource/fonts/tt subdirectory of the IDL directory. On Windows platforms, this entry may be '*', in which case the font will be loaded from the operating system font list.
  • DirectGraphicsScale: the correction factor that will be applied to each character when it is rendered on a Direct Graphics device.
  • ObjectGraphicsScale: the correction factor that will be applied to each character when it is rendered on an Object Graphics device (this number is currently ignored by IDL).

You will need to restart IDL for the changes to the ttfont.map file to take effect. On Windows systems, you can use fonts that are not mentioned in the ttfont.map file, as long as they are installed in the system fonts.

Where IDL Searches for Fonts


The TrueType font files included with IDL are located in the resource/fonts/tt subdirectory of the IDL directory. When attempting to resolve a font name, IDL will look in the ttfont.map file first. If it fails to find the specified font file in the ttfont.map file, it will search for the font file in the following locations:

UNIX

No further search will be performed. If the specified font is not included in the ttfont.map file, IDL will substitute Helvetica.

Microsoft Windows

If the specified font is not included in the ttfont.map file, IDL will search the list of fonts installed in the system. If the specified font is not found, IDL will substitute Helvetica.

Note: To get the list, you can use the following command, which returns the names of all available fonts in the fnames variable:

DEVICE, GET_FONTNAMES=fnames, SET_FONT='*'        

Version History


Original

Introduced

8.6.1

Changed to new TrueType font files for Helvetica, Times, Courier, Symbol, and Monospace Symbol



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us