{font name} [Bold] [Italic]
where "{font name}" is a Java compatible font name (that is, the font name that is used in java.awt.Font). The "[Bold]" and "[Italic]" are optional. The followings are some examples:
Arial Bold
Times New Roman
Courier Bold Italic
SansSerif
When using the above format, you may use all fonts that are known to the Java system. You can use the Java API GraphicsEnvironment.getAvailableFontFamilyNames to determine the fonts known to the Java system.
ChartDirector also supports using true-type fonts that are unknown to the Java system, which is useful if you would like to use private fonts in your application. This is by specifying the font using the font file name. ChartDirector will try to load the font file from the Java class path as well as from the file system. For example, if you are using ChartDirector in a JSP web application, you can put the fonts files in the WEB-INF/classes inside your web application directory. You can also include the font files in a JAR file as include the JAR file in your Java applications.
Special Note for Headless Systems
Using Java fonts or private font files requires a working the Java font system.
Java running on systems with a GUI should have working font systems. However, some server side Java systems may be "headless", which are systems without GUI. In these cases, Java should be started in headless mode, such as by using the command line flag "-Djava.awt.headless=true". Otherwise, any attempt to use the Java font system may cause error. Please refer to the Java documentation for more details on "headless" mode.
If the Java font system is not working (eg. running on "headless" system but the headless mode is not enabled for Java), as a last resort, ChartDirector will switch to an internal backup font system, so the charts will still work. The internal font system only have 3 fonts - generic sans serif (Arial like font), generic serif (Times New Roman like font) and generic monospace (Courier like font). All of them have bold, italic and bold-italic styles.
Using Java fonts or private font files requires a working the Java font system.
Java running on systems with a GUI should have working font systems. However, some server side Java systems may be "headless", which are systems without GUI. In these cases, Java should be started in headless mode, such as by using the command line flag "-Djava.awt.headless=true". Otherwise, any attempt to use the Java font system may cause error. Please refer to the Java documentation for more details on "headless" mode.
If the Java font system is not working (eg. running on "headless" system but the headless mode is not enabled for Java), as a last resort, ChartDirector will switch to an internal backup font system, so the charts will still work. The internal font system only have 3 fonts - generic sans serif (Arial like font), generic serif (Times New Roman like font) and generic monospace (Courier like font). All of them have bold, italic and bold-italic styles.