Previous Topic  Next Topic

Applying True Type Fonts in Reports

You might find that well-designed reports in Designer become truncated when you run the reports on Server on a different platform. The reason is that various platforms use different font systems, and when JDK maps the fonts to a different platform, the reports appear with a discrepancy. To solve this problem, Report adopts the True Type Font (TTF) administrative system of Java. You can design reports in any fonts in Designer. Then, when you publish the reports into the runtime environment, you can publish the fonts together with the reports, which are independent of the platform fonts. Report also provides the PDF embedded fonts solution, meaning Report can embed the fonts in the PDF output, so users do not need to install the fonts on their local machines. This topic describes how you can design reports with TTF, apply the Bold and Italic properties to TTF, deliver TTF to the runtime environment, and export reports with TTF in different formats.

The following sections describe how to use TTF in your reports:

• Designing Reports with TTF
• Applying Bold and Italic Properties to TTF
• Publishing TTF to the Runtime Environment
• Delivering TTF in Excel/RTF/HTML/TXT
• Delivering TTF in PDF
  • Using -D Options to Configure TTF in PDF Output

Designing Reports with TTF

When you design reports that you want to run on a platform different from where you design them, it is best to use TTF fonts.

To design reports with TTF

1. Copy the True Type Font files *.ttf to the <designer_install_root>\font directory of Designer. You can find the TTF fonts in your system's Font directory or from the Internet.
2. In Designer, open a report and select the text you want to apply the TTF font.
3. On the Home menu bar, select the drop-down arrow of the font list and scroll down to the bottom of the list. You can then find the fonts with an * before their name. These are the TTF fonts you have copied. Select the TTF font you want to apply.
4. Preview the report and save the report until you are satisfied with the result.

Report uses the JDK TTF, however JDK has a problem in printing reports with rs_song.ttf (some characters are incorrect). You should therefore use other Chinese TTF fonts such as SimSun.ttf, PMingLiu.ttf, and LF_FangSong.ttf.

Back to top

Applying Bold and Italic Properties to TTF

Designer supports the Bold and Italic properties for TTF. When you select a TTF font and set the Bold/Italic property to "true", Designer first searches the <designer_install_root>\font directory automatically to check all the TTF files related with the TTF font you have selected previously. If there is such a TTF file holding the Bold/Italic property, Designer uses the font style defined in this file to match your setting and make the Bold/Italic property take effect; if not, Designer finds the specified font in your platform fonts and applys the Bold/Italic property directly.

Back to top

Publishing TTF to the Runtime Environment

When you publish reports from Designer to Server, if the reports use TTF fonts, Designer prompts you the Publish Additional Resources dialog box to publish the font files at the same time. After Designer finishes the publishing task, you can find the corresponding font files in the <server_install_root>\font directory of Server.

Back to top

Delivering TTF in Excel/HTML/TXT/RTF

For report outputs in Excel, HTML, TXT, and RTF, they can automatically find the TTF fonts from the system's Font directory to display the fonts correctly. However, to avoid any discrepancy in the report outputs, if you want to deliver the report in these formats, you should choose the TTF fonts that are common on the Windows systems. When you have to use fonts that do not exist in the client's system, you can choose the embedded TTF font solution as shown in the following section.

Back to top

Delivering TTF in PDF

To view PDF outputs with other character sets, for example, Chinese fonts, you need to install special language packages. Also, if you design reports with fonts that are not within Acrobat's internal fonts, Acrobat maps them differently. The two cases cause trouble to users when they view or print a report with Acrobat Reader. However, different from Excel, HTML, TXT, and RTF, PDF enables the embedding of the font description within a file. Report therefore provides the embedded TTF font solution for PDF outputs. You can 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 users with it.

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

To take advantage of the PDF Embedded TTF Font feature (this feature is not supported on library components), take the following steps:

1. Select the TTF to design reports.
2. Open the report.
3. In the Report Inspector, select the node representing the page report tab or web report and find its Embedded Fonts property. The value drop-down list of the property shows all the TTF fonts the report uses. You can select multiple fonts by holding down the Ctrl or Shift key.
4. Save the report and export it to PDF. Designer embeds the selected fonts in the PDF output.

When you select an embedded font while using TTF to design reports and set the Bold/Italic property to "true", if Designer can find the related TTF file to match your setting, Designer also embeds the matched font with the Bold/Italic property when you export the report to PDF.

Using -D Options to Customize TTF in PDF Output

You can add the following options in Designer's startup file JReport.bat/JReport.sh in <install_root>\bin to specify some TTF properties in your PDF output.

• -Dlogireport.pdf.UsePdfFontAscent
  Use this option when you want to apply the float ascent value in the PDF font for embedded TTFs in your PDF output (by default, Designer applies that of the JDK font). The value of this option can contain multiple items separated by the ";" character. Each item should be a TTF font name starting with "*" or be the AllEmbeddedTTF keyword, for example, -Dlogireport.pdf.UsePdfFontAscent="*Time-RomanBold;*SourceSansPro-Regular;AllEmbeddedTTF".
  • When one of these items is AllEmbeddedTTF, Designer applies the ascent of the PDF font for all embedded TTFs in the PDF output。
  • When none of these items is AllEmbeddedTTF, Designer only applies the ascent of the PDF font for the embedded TTFs the names of which you have included in this option.
• -Dlogireport.pdf.MapToTTF
  Use this option to map none TTF fonts to TTF fonts in the PDF output. The value of the option can contain multiple items separated by the ";" character. Each item should either be a font name that does not start with "*" in the Font Face property drop-down list, or be the keyword All, for example, -Dlogireport.pdf.MapToTTF="Arial;Times New Roman;All".
  • When one of these items is All, Designer tries to map each none TTF font in the report template to a TTF font if there is a matched TTF file in the <install_root>\font directory of Designer.
  • When none of these items is All, for each item, if it is used in the report template, Designer tries to map it to a TTF font.
• -Dlogireport.pdf.EmbeddedFonts
  Use this option to specify the TTF fonts you want to embed into the PDF output. The value of the option can contain multiple items separated by the ";" characters. Each item should either be a TTF font name that starts with "*" in the Font Face property drop-down list, or be the keyword All, for example, -Dlogireport.pdf.EmbeddedFonts="*Arial-BoldMT;*TimesNewRomanPS-BoldItalicMT;All".
  • When one of these items is All, Designer embeds every TTF in the report template into the PDF output.
  • When none of these items is All, for each item, if it is used in the report template, Designer embeds it into the PDF output.

Back to top

Previous Topic  Next Topic