# True Type Fonts

Users might find that well designed reports in JReport Designer become truncated when running in a JReport Enterprise Server on a different platform. The reason being that various platforms use different font systems, and by mapping the fonts to a different platform by JDK, the report result is shown with a discrepancy. To solve this problem, Java provides a True Type Font (TTF) administrative system, which allows the fonts to be published together with a report into the runtime environment independent of the platform fonts.

In addition, in cases where end users do not have the fonts used in a report, JReport provides a PDF embedded fonts solution. That is, the fonts are embedded in the PDF file, and end users do not need to install the fonts to their local machines.

Notes:

- When you design reports that will be run on a platform different to where they have been designed, it is best to use TTF fonts.
- From JDK 1.3 onwards, Java resolved the cross-platform problem with TTF. So, JReport is now using the JDK TTF. Note that the JDK has a problem in printing reports with rs_song.ttf (some characters are incorrect). We therefore recommend that you use other Chinese TTF fonts such as SimSun.ttf, PMingLiu.ttf and LF_FangSong.ttf.

The following topics describe how to use TTF in your reports.

## Designing reports with TTF

To design reports with TTF, follow the steps below:

1. Copy True Type Font files *.ttf to the `<install_root>\font` subdirectory. You can find the TTF fonts in your system's Font directory or from the Internet.
2. Running JReport Designer. In the Design area, click on the drop-down arrow of the font, and scroll down to the bottom part of the list. You will then find the fonts with an * before their name. These are the TTF fonts you have published.
3. Click the View tab to review the report result. Save the report until you are satisfied with the report design.

## Publishing TTF to the production environment

If you want to publish report files (.cls) that use True Type Fonts to other operating systems, you will need to place the relevant font files (other files in the font path) in the `<install_root>\font` directory of the operating system of where you want to publish the report. Make sure that you copy or ftp (in binary mode) the .ttf files to the directory.

## Delivering the result in Excel/RTF/HTML/TXT

For files of HTML/RTF/Excel formats, they will find the fonts from the system font directory. If you want to deliver the report result in the above formats to end users, you should choose the TTF fonts that are commonly used on Windows systems for your reports. If you have to use fonts that do not exist in a client system, you can choose the embedded TTF font solution for a good print result in PDF format.

## Delivering the result in PDF

To view PDF reports with other character sets, for example, Chinese fonts, you will need to install special language packages. Also, if you design reports with fonts that are not within Acrobat's internal fonts, they will be mapped differently. The above two cases will cause trouble to end users when viewing or printing a report with Acrobat Reader. However, differing from HTML and RTF, PDF allows the embedding of the font description within a file. JReport therefore provides the embedded TTF font solution for a PDF result. You will find it extremely helpful in the following cases:

- When you select TTF fonts to design a report, and these fonts are not within the client's existing font systems.
- When you have used the TTF and Acrobat Reader has to be updated with the language extension package to view the result, but you do not want to trouble the end user with it.

To take advantage of the PDF embedded TTF font feature, follow the steps below:

1. Select the TTF to design reports as specified previously.
2. Open the report, go to the Report Inspector, and in the node representing the report, find a property called Embedded Fonts. The drop-down list will show all the TTF fonts used by the report. You can select multiple fonts by holding down the Ctrl or Shift key.
3. Save the report set and export it to a PDF file. The selected fonts will be embedded in the exported PDF file.

By embedding TTF fonts, the file size will increase a little. However, it is still of reasonable size to be transferred over a network.