2.4. フォントの設定

Copper PDFは外部のフォントを使用するPDF、 あるいはフォント情報を埋め込んだPDFを出力することが出来ます。 フォント関連の設定はprofilesディレクトリ内のfontsディレクトリに含まれています。

fonts
|-- fonts.xml
|-- truetype
|-- warrays
|-- afms
|-- cmaps
`-- encodings

fonts.xml

フォント設定ファイルです。ドキュメント中で利用出来るフォントの設定が記述されています。

truetype

出荷時のfonts.xmlの設定では、このディレクトリ内のフォントファイルを利用出来るようになっています。 使用したいフォントをここにコピー(あるいはシンボリックリンク)して、設定を反映してください。 truetypeというディレクトリ名はCopper PDF 2.0.2までTrueTypeフォントしか使用出来なかったためで、 実際はOpenType CFF/Type2(.otf)フォントも配置することが出来ます。

warrays

実際のフォントファイルを用いずにCID-Keydフォントを使用するために、 既定のフォントの幅情報が配置されています。

afms

コアフォントのフォントメトリックス情報がAFM形式で配置されています。

cmaps

CID-KeydフォントのためのCMapファイルが配置されています。

encodings

コアフォントのための文字名と各エンコーディングとの対応表が配置されています。

2.4.1. フォント設定の反映

Copper PDFはfonts.xmlを解析し、フォントへアクセスするための情報をfonts.xmlが配置されているのと同じディレクトリに、 fonts.xml.dbというファイル名で保存します。 Copper PDFはfonts.xmlとfonts.xml.dbのタイムスタンプを比較し、異なっていればfonts.xmlを自動的に読み込むため、 fonts.xmlへの変更はすぐに反映されます。

ただし、システムへのフォントのインストールや、フォントファイルの追加・置き換え等を自動検出しません。 この場合、変更を反映させるためには、fonts.xmlファイルを再保存するか、fonts.xml.dbファイルを削除してください。

2.4.2. ドキュメント中でのフォントの利用

ドキュメント中で使用するフォントを特定するCSSプロパティは font-family(ファミリ名), font-weight(太さ), font-size(大きさ), font-style(スタイル) の４つです(fontプロパティでまとめて指定することも出来ます)。 指定されたファミリ名、太さ、スタイルから、記述された文字を表記出来る最も近いフォントが選択され、使用されます。

該当する太さのフォントが見つからない場合は、機械的に文字の輪郭を拡張して太いフォントがつくられます (逆に指定した太さより細いフォントがない場合、機械的に細いフォントをつくることはありません。 最も細いフォントが使われるだけです)。

また、font-styleにitalicまたはobliqueが指定されたとき、 斜体スタイルのフォントが見つからない場合は、フォントを機械的に傾けます。 同時にfont-weightが指定されている場合は、 以下の表のとおり、italicとobliqueの場合で選択されるフォントが異なることがあります。

2.4.3. デフォルトのフォント

ドキュメント中でフォントが指定されていない場合、あるいは指定されたフォントが見つからない場合は、 output.default-font-family により設定されたフォントが使われます。 これはデフォルトではserif(ローマンあるいは明朝体)です。

CMapに該当するコードがない、 コアフォントにも該当する文字がない、かつインストール済みのフォントにも該当する文字がないといった理由で、 どうしても表示出来ない文字がドキュメント中に記述された場合は、 代わりに16進数でユニコードを表す組文字(のような文字)が表示されます。

2.4.4. フォントの種類

Copper PDFがサポートするフォントには コアフォント、 CID-Keyedフォント CID Identityフォント、 埋め込みフォント、 の４種類があります。 コアフォントは常に利用可能ですが、埋め込みフォント、CID Identityフォント、CID-Keyedフォントのどれを利用するかは output.pdf.fonts.policy によって選択可能です。 また、Copper PDFの拡張CSSプロパティ -cssj-font-policy によってドキュメント中で指定することも出来ます。

これらの入出力プロパティまたは拡張CSSプロパティにcid-keyed, cid-identity, cid-embeddedを指定することで、 それぞれCID-Keyedフォント、CID Identityフォント、埋め込みフォントを切り替えることが出来ます。 なお、コアフォントは常に使用されます。 またスペース区切で複数指定することも可能です2.0.1。 複数指定された場合は、最初に指定されたものから優先的に使用されます。 コアフォントの優先度は常に最低となります2.0.9。

PDF/A-1を出力する場合は、上記の設定に関わらず、埋め込みフォントだけが使われます2.1.0。

2.4.5. コアフォント

コアフォントは、ほとんどのPDF表示環境が標準的にサポートしているフォントで、フォントの埋め込みをせずに表示することが出来ます。 コアフォントはさらにletter(欧文文字・記号だけで構成されるもの)、symbol(欧文文字・記号以外の文字を含むもの)の2種類に分けられます。

以下はコアフォントの一覧です。

CSSのfont-familyプロパティによるフォントの指定は、 正式名称、略称、ファミリ名のいずれでも可能です。 ファミリ名を使用した場合は、 font-style, font-weight プロパティの指定により、同じファミリ名を持つフォントのうち、スタイルと太さが最も一致するフォントが自動的に選択されます。

コアフォントのフォントメトリックス情報(文字の幅などの情報)がAFM(Adobe Font Metrics)ファイルとして、 fonts/afmsディレクトリに収められています。 これらのファイルをユーザーが変更する必要はありません。

各文字とPDF内で使用される文字コードとの対応表が fonts/encodingsディレクトリに収められています。 UNICODE.txtはletterフォントの文字名とユニコードとの対応表です。 symbol.txtとzdingbat.txtはそれぞれSymbol, ITC Zapf Dingbatsのためのユニコード対応表です。 これらのファイルをユーザーが変更する必要はありません。

以下はletterフォントで使用出来る文字セット(WinAnsiEncodingエンコーディング)の文字一覧表です。 それぞれの文字は8ビット(16進数で2桁)のユニコードに対応しており、縦が上位桁、横が下位桁です。 ただし、80から9Fまでのコードで空いている部分は対応する文字がないことを表し、 下に4桁の16進数字がある文字には別のコードがあります。 例えばダブルダガー(‡)を表示する場合はドキュメント中で‡または&#0x2021と表記してください。

以下はSymbolで使用出来る文字の一覧です。 文字の下の数字は16進ユニコードです。

以下はZapfDingbatsで使用出来る文字の一覧です。 文字の下の数字は16進ユニコードです。

2.4.6. CIDフォント

欧文以外の文字をPDFに含める場合は、CIDフォントを用います。 フォントを埋め込む方法と、フォントを埋め込まない方法があり、 フォントを埋め込まない方法には、さらにCID IdentityとCID-Keyedフォントの２種類の方法があります。 どの種類のフォントを利用するかは、入出力プロパティoutput.pdf.fonts.policyの設定によります。

埋め込みフォントまたはCID Identityを使用する場合、 Copper PDFにフォントをインストールする必要があります。 Copper PDFの出荷時の状態では、 truetypeディレクトリにフォントファイルを配置すると フォントが利用可能になるようにfonts.xmlが設定されています。

埋め込みフォント

PDFにフォントを字体のデータを埋め込む方式で、 環境に関係なく、確実に同じ字体で文字が表示されることが保証されます。

Copper PDFはフォントの埋め込みをサポートしています。 フォントを埋め込む場合、文書で使用する文字のフォントだけをPDFに含めるため、 ファイルサイズは最小限に抑えられますが、編集や加工には適しません。

表示や印刷の見栄えに厳密さが求められる場合や、 広く配布する文書、あるいは長期保存する文書に適しています。

CID Identity

フォントの埋め込みをせず、グリフID(フォントファイルに含まれる文字のインデックス)をそのままPDF内に記述する方式です。 Copper PDFの動作環境と、PDFを表示する環境に同一のフォントがインストールされている必要があります。 グリフIDは特定のフォントファイルに依存するため、 PDFを表示する環境にインストールされたフォントファイルが異なれば、 似たような書体のフォントであっても文字化けが発生するか、全く表示出来なくなります。

同一のマシン上や、同じ組織内での編集や加工、印刷を目的とする文書に適しています。 フォントの埋め込みをする場合にくらべて、出力されるPDFのサイズは小さくなります。

CID-Keyedフォント

CID Identityフォント同様にフォントの埋め込みをしませんが、 Adobe社により公開されているコード体系(CMap)を使用します。

PDFを表示する環境で利用可能な、書体の近いフォントが自動的に選ばれるので、 特定のフォントファイルに依存することはありません。 ただし、使用出来る文字はAdobe社が提供するCMapファイルで定義された文字に限られ、 全ての環境でPDFを表示出来ることが保証されるものではありません。

特定の言語環境のWindowsやMacOS、特定のバージョン以降のAdobe Readerなど、 表示・編集・加工する環境が比較的限られ、表示や印刷の見栄えに厳密さが求められない文書には有効です。

PANOSEコード

CID-Keyedフォントの場合、表示環境にインストールされた、書体の近いフォントを選ぶために、 PANOSE-1(パノーズ)という10桁のコードを使います。 PDFでは、さらのクラスID・サブクラスIDというコードが先頭に付けられるため、12桁となります。

クラスID・サブクラスIDと、PANOSE-1コードはTrueTypeまたはOpenTypeフォントから、ツールを使って取得することが出来ます。 Microsoft社が配布しているfonttools.exeに含まれるttfdump.exeというツールを利用すると便利です。

以下はmsgothic.ttcからフォントの情報を、out.txtというテキストファイルに書き出すコマンドです。 -c1は.ttcファイル(複数のTrueTypeフォントを含むファイル) の1番目のフォント情報を取得するためのオプションで、 2番目のフォント情報を取得する場合は-c2のように指定してください。 .ttfまたは.otfファイルではこのオプションは不要です。

C:\TTFDump>ttfdump.exe "C:\Windows\Fonts\msgothic.ttc" -c1 > out.txt

以下の部分(OS/2テーブル)のsFamilyClassがクラスID・サブクラスIDで、PANOSEが10桁のPANOSE-1コードです。 この場合、フォント設定ファイル中ではPANOSEコードを8 1 2 11 6 9 7 2 5 8 2 4と指定してください。

... 略
'OS/2' Table - OS/2 and Windows Metrics
---------------------------------------
Size = 96 bytes (expecting 96 bytes)
  'OS/2' version:           3
... 略 ...
  yStrikeoutSize:           13
  yStrikeoutPosition:       66
  sFamilyClass:             8    subclass = 1
  PANOSE:                   2 11  6  9  7  2  5  8  2  4
  Unicode Range 1( Bits 0 - 31 ): E00002FF
  Unicode Range 2( Bits 32- 63 ): 6AC7FDFB
略 ...

参考情報

http://www.panose.com/ProductsServices/pan1.aspx

PANOSE-1コードの仕様です。

http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6OS2.html

TrueTypeフォントのOS/2テーブルの仕様です。

http://www.microsoft.com/typography/tools/tools.aspx

Microsoft社のFontToolsのページです。ここでダウンロードしたfonttools.exeを実行すると、展開されたファイルの中にttfdump.exeがあります。

フォント幅情報ファイル

文字列をレイアウトするとき、各文字の幅や基底線の情報が必要です。 CID-Keyedフォントは、フォントそのものは含まないフォント幅情報ファイルをもとにレイアウトします。 フォント幅情報ファイルはfonts/warraysディレクトリに既定のものが用意されています。

出荷時のfonts.xmlの設定では、文書中がMincho, Gothicというフォント名で、 明朝体とゴシック体のフォントが使われるようになっています。 それぞれserif, sans-serifというCSS総称フォント名にも結び付けられており、 またMinchoはデフォルトのフォントです。 つまり、CID-Keyedフォントが利用する設定では、対応するフォントがない場合は全てMinchoとなります。 これらのフォントは、実際には多くの日本語表示環境に入っていると考えられる、 等幅の明朝体、ゴシック体フォントが使用されるようにPANOSEが設定されています。

Copper PDF 2.1.10 以降では、MS明朝、MSゴシック、MS P明朝、MS Pゴシック、MS UI Gothicの幅情報が用意されています。 出荷時のfonts.xmlの設定では、それぞれの名前で文書中から使用できるようになっています。 これらのフォントを使うと、日本語Windows環境を対象とした軽量なPDFを生成することができます。 ただし、MS系フォントが入っていない環境では、隣り合う文字が重なったり、離れすぎてしまったりという現象が発生します。

手持ちのフォントから幅情報を抽出し、新たにフォント幅情報ファイルを作成する場合は、付属のツールを使ってください。 以下のように、javaコマンドで直接jp.cssj.sakae.pdf.tools.WArrayToolを実行してください。 クラスパスとクラス名に続く引数はそれぞれ、cmapファイル、Javaエンコーディング名、フォントファイルです。 複数のフォントを含むファイル(.ttc)の場合、さらにフォントの番号を続けることができます。

java -cp lib/cssj-sakae.jar:lib/sakae-opentype.jar:lib/commons-logging.jar:lib/cti-server.jar \
	jp.cssj.sakae.pdf.tools.WArrayTool \
	conf/profiles/fonts/cmaps/UniJIS-UTF16-H \
	UTF-16BE \
	/usr/share/fonts/truetype/kochi/kochi-mincho.ttf \
	> conf/profiles/fonts/warrays/kochi-mincho.txt

2.4.7. フォントファイルの種類

埋め込みフォント、CID Identityフォントを使用する場合、 あるいはCID-Keyedフォントのためにフォントの幅情報を抽出するためには、 Copper PDFが動作する環境にフォントファイルがインストールされている必要があります。

Copper PDFがサポートするフォントファイルの種類は以下の通りです。

TrueType "OpenType(TrueType flavor)"

一般的にTrueTypeと呼ばれるフォントファイルです。 .ttfまたは.ttc(複数のフォントを含むもの)という拡張子のファイルとして配布されています。

OpenType CFF/Type2

一般的に単にOpenTypeと呼ばれる、 CFF/Type2形式のOpenTypeフォントファイルです。 .otfという拡張子のファイルとして配布されています。 Copper PDF 2.0.3からサポートされました。

またCopper PDFは上記のフォントファイル以外に、Java実行環境によりサポートされるフォントファイルを使用することが出来ます。 SunのJava実行環境(1.5.0以降)はTrueTypeに加えてType1フォント(.pfa, .pfb)、 F3フォント(.f3b)をサポートしています。

2.4.8. フォント設定ファイル

PDF出力に使用するフォントの情報はフォント設定ファイル(fonts.xml) に記述してください。 フォント設定ファイルはXML形式で、ルート要素はfontsです。 フォント設定ファイルには各種ファイルのファイルパスの情報も含まれており、 ファイルパスはフォント設定ファイルからの相対パスとなります。

fonts要素には次の要素が含まれています。

コアフォントのエンコーディング(encodings要素)

コアフォントのエンコーディング情報のファイルを設定します。 通常は編集する必要はありません。

letterフォント(SynbolとZapfDingbats以外のフォント)を使用する場合、使用出来る文字セットにはStandardEncoding、 MacRomanEncoding、WinAnsiEncodingの3種類があります。 Copper PDFの出荷時にはWinAnsiEncodingが設定されています。 core-fonts要素のencoding属性 の指定を変更することで切り替えることが出来ます。

encodingsに含まれる要素

cmapファイル(cmaps要素)

CID-Keyedフォントのエンコーディング情報のファイルを設定します。 通常は編集する必要はありません。

cmapsに含まれる要素

コアフォント(core-fonts要素)

コアフォントの設定です。 通常は編集する必要はありませんが、使用するエンコーディングを変更したり、 ドキュメントから参照する際の別名を追加することが出来ます。

core-fontsに含まれる要素

core-fonts要素にはletter-font, symbol-fontのいずれかを含むことが出来ます。

letter-font

letter-font要素は通常の欧文フォントの設定です。

symbol-font

symbol-font要素は記号フォント(SymbolまたはZapfDingbats)の設定です。

letter-fontおよびsymbol-fontに含まれる要素

letter-fontおよびsymbol-font内にalias要素を追加することで、 ドキュメント中のfont-familyで参照することが出来る別名が追加されます。

letter-fontおよびsymbol-font内のinclude, exclude要素により、 フォントが使用される文字範囲を指定出来ます2.0.3。 includeにより、フォントが使用される文字範囲を明示することが出来、 excludeにより除外する文字範囲を明示することが出来ます。 include, excludeの記述がない場合は、利用可能な全ての文字でフォントが利用されます。

unicode-rangeはU+に続く16進数によるユニコードとハイフンを用います。 例えば、日本語のかなを含める文字範囲の指定は次の通りです。

<include unicode-range="U+3030-30FF" />

また下位の桁をワイルドカードに置き換えることも出来ます。 以下の記述は U+1F00-1FFFと書くのと等価です。

<include unicode-range="U+1F??" />

複数の文字範囲はカンマで区切ってください。

<include unicode-range="U+3030-30FF,U+1F??" />

CIDフォント(cid-fonts要素)

cid-fontsに含まれる要素

cid-fonts要素にはcid-keyed-font, font-file, font-dir, system-font, all-system-fontsのいずれかを含むことが出来ます。

cid-keyed-font

cid-keyed-font要素はフォントファイルを使用する代わりに、 フォントの幅情報を記述したファイルを利用してCID-Keyedフォントを定義するものです。

フォントの幅情報のファイルはwarraysディレクトリに等幅フォント用の既定のものが用意されています。

また、手持ちのフォントから幅情報を抽出するツールが用意されています。 以下のように、javaコマンドで直接jp.cssj.sakae.pdf.tools.WArrayToolを実行してください。 クラスパスとクラス名に続く引数はそれぞれ、cmapファイル、Javaエンコーディング名、フォントファイルです。 複数のフォントを含むファイル(.ttc)の場合、さらにフォントの番号を続けることが出来ます。

java -cp lib/cssj-sakae.jar:lib/sakae-opentype.jar:lib/commons-logging.jar:lib/cti-server.jar \
	jp.cssj.sakae.pdf.tools.WArrayTool \
	conf/profiles/fonts/cmaps/UniJIS-UTF16-H \
	UTF-16BE \
	/usr/share/fonts/truetype/kochi/kochi-mincho.ttf \
	> conf/profiles/fonts/warrays/kochi-mincho.txt

font-file

font-file要素はフォントファイルを直接指定します。

font-dir

font-dir要素は指定したディレクトリに存在するフォントファイルを直接まとめて読み込みます。

system-font

system-fontはJava実行環境を利用してフォントを読み込みます。 OSやウィンドウシステムにインストールされたフォントを名前で指定出来ますが、 縦書きなどフォントの一部の機能に制約があります。

all-system-fonts

all-system-fontsはJava実行環境が利用可能なフォントを全て読み込みます。

cid-keyed-font, font-file, system-fontに含まれる要素

フォントの名前はフォントデータから取得されますが、 cid-keyed-font, font-file, system-fontにalias要素を追加することにより、さらにフォントの別名を追加出来ます。 記述方法はcore-font, symbol-fontのalias と同じです。

cid-keyed-font, font-file, system-fontにinclude, exclude要素を追加することにより、 有効な文字範囲を指定することが出来ます。 記述方法はcore-font, symbol-fontのinclude, exclude と同じです。

一般フォントファミリ(generic-fonts要素)

font-familyで指定出来るserif, sans-serif, monospace, fantasy, cursiveという 5種類の一般フォント・ファミリに対応するフォントを指定するものです。

generic-fontsに含まれる要素

generic-fontsにはCSSの一般フォントファミリ名に対応する5つの名前の要素、 serif, sans-serif, monospace, fantasy, cursiveが含まれます。

font-family等で指定するフォント名には、 実際のフォント名以外に5種類の一般フォントファミリ名を指定することが出来ます。 generic-fontsは、この一般フォントファミリ名と実際のフォントとの対応付けをするものです。

2.4.9. フォント設定ファイルの設定例

デフォルトのフォントの変更

output.pdf.fonts.policyにembeddedを指定するか、 CSSで-cssj-font-policy: embedded;をしていすると 埋め込みフォントが使用されますが、出荷時のフォント設定ファイルでは、大抵の場合は全ての文字が のような組み文字になってしまいます。 これは、デフォルトのフォントが一般フォントファミリのserifになっており、serifはCID-Keyedフォントにした対応付けてないためです。

output.default-font-familyでデフォルトのフォントを変更するか、 あるいはフォント設定ファイルを修正して、一般フォントファミリを埋め込み可能なフォントに対応させます。

例えばtruetypeディレクトリにIPAフォント (http://ossipedia.ipa.go.jp/ipafont/) を配置した場合は、 generic-fontsの部分を以下のように設定することで、 フォントの埋め込みに、デフォルトでIPAフォントが使われるようになります。

<generic-fonts>
	<serif font-family="Mincho,IPA P明朝,UniKS-Myungjo,UniCNS-Ming,UniGB-Song" />
	<sans-serif font-family="Gothic,IPA Pゴシック,UniKS-Gothic,UniCNS-Ming,UniGB-Heiti" />
	<monospace font-family="Gothic,IPA ゴシック,UniKS-Gothic,UniCNS-Ming,UniGB-Heiti" />
	<fantasy font-family="Comic-Sans-MS,Gothic,IPA Pゴシック,UniKS-Gothic,UniCNS-Ming,UniGB-Heiti" />
	<cursive font-family="Comic-Sans-MS,Mincho,IPA P明朝,UniKS-Myungjo,UniCNS-Ming,UniGB-Song" />
</generic-fonts>