StandardCJKFont (Big Faceless Report Generator 1.1.39)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.faceless.pdf2
Class StandardCJKFont

java.lang.Object
  org.faceless.pdf2.PDFFont
      org.faceless.pdf2.StandardCJKFont

All Implemented Interfaces:: Cloneable

public final class StandardCJKFont
extends PDFFont
extends PDFFont

A subclass of PDFFont representing the "standard" Chinese, Japanese and Korean fonts which are available as part of the Acrobat Reader for those countries, or as optional "language packs" for other locales. Without the language pack installed, Acrobat will throw an error message when trying to display a page containing one of these fonts. They can be can be downloaded from http://www.adobe.com/products/acrobat/acrrasianfontpack.html if they were not installed with Acrobat.

The following fonts are available:

Simplified Chinese: STSong Light
Traditional Chinese: MSung Light, MHei Medium
Japanese: Heisei Mincho W3, Heisei Kaku Gothic W5
Korean: HY Gothic Medium, HYS Myeongjo Medium

Each of these fonts may be used as is, or in italic or bold.

Versions of Acrobat 5.0 used UCS2 encoding, and so was limited to displaying only characters from U+0000 to U+FFFF. Acrobat 6.0 added support for UTF16, which is required to display characters outside this range. For reasons far too complicated to go into here, UTF16 encoding is also required to display some additional characters outside this range - specifically characters added in the HKSCS-2001 and JISX0213:2004 ranges. So, to sum up:

If you need to support HKSCS-1999, you will need version 1.2.1 or later of the PDF library and either Acrobat 5 (or better), or Acrobat 4 with a recent language pack
If you need to support HKSCS-2001, you will need version 2.2.6 or later of the PDF library and Acrobat 6 or better. Documents using these characters will not display at all in earlier versions of Acrobat. If you need to display your documents in Acrobat 5, set the appropriate OutputProfile and embed a font containing the glyphs added in HKSCS-2001.
If you need to support JISX0213:2004, you will need version 2.2.6 or later of the PDF library and Acrobat 6 or better. Documents using characters added in this standard will not display at all in earlier versions of Acrobat. If you need to display your documents in Acrobat 5, set the appropriate OutputProfile and embed a font containing the glyphs added in that standard. Note that many of the character added here are in the range U+0100 to U+0400 and U+1E00 to U+2E7F (extended latin, symbols, diacritics etc.)

Although Java 1.5 is the first version to support Unicode characters above U+FFFF, you can still get by quite happily with Java 1.4 by using the appropriate surrogates from the U+D800 to U+DFFF range (which is what Java 1.5 does anyway). Since version 2.2.6 the library is aware of Unicode 4.0 characters and handles them correctly regardless of which version of Java you're running.

Since:: 1.1

Field Summary
`static int`	`BOLD` A "style" parameter to the constructor requesting a bold font
`static int`	`HEISEIKAKUGO` Represents the Heisei Kaku Gothic W5 font, a Japanese font with fixed width strokes
`static int`	`HEISEIMIN` Represents the Heisei Mincho W3 font, a Japanese font with variable width strokes
`static int`	`HYGOTHIC` Represents the HY Gothic Medium font, a Korean font with fixed width strokes
`static int`	`HYSMYEONGJO` Represents the HYS Myeongjo Medium font, a Korean font with variable width strokes
`static int`	`ITALIC` A "style" parameter to the constructor requesting an italic font
`static int`	`MHEI` Represents the MHei Medium font, a Traditional Chinese font with fixed width strokes
`static int`	`MSUNG` Represents the MSung Light font, a Traditional Chinese font with variable width strokes
`static int`	`REGULAR` A "style" parameter to the constructor requesting a regular font - ie.
`static int`	`STSONG` Represents the ST Song Light font, a Simplified Chinese font with variable width strokes

Constructor Summary
`StandardCJKFont(int font, int style)` Create a new CJK Font.

Method Summary
`boolean`	`equals(Object o)`
`float`	`getAscender()` Get the Ascender for the font (the maximum height above the baseline the font extends), as a proportion of the point size.
`float`	`getDefaultLeading()` Get the default leading for this font - the preferred distance between two successive baselines of text.
`float`	`getDescender()` Get the Descender for the font (the maximum height below the baseline the font extends), as a proportion of the point size.
`float`	`getStrikeoutPosition()` Get the strikeout position, as a proportion of the font size.
`float`	`getStrikeoutThickness()` Get the strikeout thickness, as a proportion of the font size.
`float`	`getSubscriptPosition()` Get the recommended position of a sub-script version of this font, as a proportion of the sub-scripted font size.
`float`	`getSubscriptSize()` Get the recommended size of a super/sub script version of this font, as a proportion of the normal font size.
`float`	`getSuperscriptPosition()` Get the recommended position of a super-script version of this font, as a proportion of the sub-scripted font size.
`float`	`getUnderlinePosition()` Get the underline position, as a proportion of the font size.
`float`	`getUnderlineThickness()` Get the underline thickness, as a proportion of the font size.
`boolean`	`isMonospace()` Return true if every character has the same width (like Courier), false if every character is potentially a different width (like Times-Roman)
`String`	`toString()`

Methods inherited from class org.faceless.pdf2.PDFFont
`getBaseName, getBottom, getCharWidth, getCharWidth, getKerning, getKerning, getLeft, getRight, getTop, isDefined, isDefined, isHorizontal, ligaturize, ligaturize, requote, requote`

Methods inherited from class java.lang.Object
`getClass, hashCode, notify, notifyAll, wait, wait, wait`

Field Detail

STSONG

public static final int STSONG

Represents the ST Song Light font, a Simplified Chinese font with variable width strokes

See Also:: Constant Field Values

MSUNG

public static final int MSUNG

Represents the MSung Light font, a Traditional Chinese font with variable width strokes

See Also:: Constant Field Values

MHEI

public static final int MHEI

Represents the MHei Medium font, a Traditional Chinese font with fixed width strokes

See Also:: Constant Field Values

HEISEIMIN

public static final int HEISEIMIN

Represents the Heisei Mincho W3 font, a Japanese font with variable width strokes

See Also:: Constant Field Values

HEISEIKAKUGO

public static final int HEISEIKAKUGO

Represents the Heisei Kaku Gothic W5 font, a Japanese font with fixed width strokes

See Also:: Constant Field Values

HYGOTHIC

public static final int HYGOTHIC

Represents the HY Gothic Medium font, a Korean font with fixed width strokes

See Also:: Constant Field Values

HYSMYEONGJO

public static final int HYSMYEONGJO

Represents the HYS Myeongjo Medium font, a Korean font with variable width strokes

See Also:: Constant Field Values

REGULAR

public static final int REGULAR

A "style" parameter to the constructor requesting a regular font - ie. not bold or italic.

See Also:: Constant Field Values

BOLD

public static final int BOLD

A "style" parameter to the constructor requesting a bold font

See Also:: Constant Field Values

ITALIC

public static final int ITALIC

A "style" parameter to the constructor requesting an italic font

See Also:: Constant Field Values

Constructor Detail

StandardCJKFont

public StandardCJKFont(int font,
                       int style)

Create a new CJK Font.

Parameters:: font - The font to create. Can be one of STSONG, MHEI, MSUNG, HEISEIMIN, HEISEIKAKUGO, HYGOTHIC, or HYSMYEONGJO.; style - a logical-OR of any of BOLD, ITALIC or REGULAR

Method Detail