.. フォントの設定

Copper PDFはフォントを埋め込まないPDFと、フォントを埋め込んだPDFの両方を出力することができます。 デフォルトではフォントを埋め込みません。また、機能限定版ライセンスではフォントの埋め込みはできません。 フォントを埋め込まないPDFはサイズが小さくなりますが、表示する環境によっては全く意図しないフォントが使われてしまったり、 文字化けが生じてしまったり、まったく表示できないことがあります。 重要な文書、特に同じ表示が保障される必要がある場合は、フォントを埋め込んでください。

埋め込むフォントの指定は、Copper PDF 3.0.0 からはCSSの@font-faceルール(WebFont)を使うこともできますが、 高速に処理させるためには、あらかじめ設定しておくことを推奨します。 フォント関連の設定はprofilesディレクトリ 内のfontsディレクトリに含まれています。 まだ、デフォルトの設定では、ここにフォントファイルも置くことになります。 fontsディレクトリ内の構成は次のとおりです。

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

fonts.xml

フォント設定ファイルです。Copper PDFが使用するフォントの設定が記述されています。

truetype

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

warrays

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

cmaps

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

afms

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

encodings

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

..1. フォント設定の反映

Copper PDFはfonts.xmlを解析し、フォントへアクセスするための情報をfonts.xmlが配置されているのと同じディレクトリに、 fonts.xml.dbというファイル名で保存します。 Copper PDFはfonts.xmlの変更を自動検出するためfonts.xmlへの変更はすぐに反映されます。

ただし、OSへのフォントのインストールや、truetypeディレクトリ内におけるフォントファイルの追加・削除・置き換え等を自動検出しません。 変更を反映させるためには、touchコマンド等でfonts.xmlファイルのタイムスタンプを変更してください。

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

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

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

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

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

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

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

..4. フォントの種類

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

output.pdf.fonts.policyまたは-cssj-font-policyにcid-keyed, cid-identity, embeddedを指定することで、 それぞれCID-Keyedフォント、CID Identityフォント、埋め込みフォントを切り替えることができます。 コアフォントは常に使用されますが、"-core"を指定することで除外することができます3.0.0。 またスペース区切で複数指定することも可能です2.0.1。 "embedded cid-keyed"のようにスペース区切りで複数指定された場合は、最初に指定されたものから優先的に使用されます2.0.9。ただし、コアフォントの優先度は常に最低となります。 また、outlinesを指定すると、PDFでembeddedフォントをテキストではなくアウトライン化した状態で表示することができます3.1.1。

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

outlinesを指定すると、埋め込みフォントが使われ、なおかつ全てのフォントがアウトライン化されます。3.1.1。outlines指定はPDF/A-1でも有効です。

..5. コアフォント

コアフォントは、ほとんどのPDF表示環境が標準的にサポートしているフォントで、フォントの埋め込みをせずに表示することができます。 14種類あることから、コア14フォントとも呼ばれます。 コアフォントはさらに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進数字がある文字には、同じ文字に対して2つのコードがあります。 例えばダブルダガー(‡)を表示する場合はドキュメント中で‡または&#x2021と表記してください。

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

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

..6. CIDフォント

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

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

埋め込みフォント

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

フォントを埋め込む場合、文書中で使用されている文字のフォントだけを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など、 表示・編集・加工する環境が比較的限られ、表示や印刷の見栄えに厳密さが求められない文書には有効です。 PDFのファイルサイズは最も小さくなります。

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
略 ...

参考情報

https://monotype.github.io/panose/pan1.htm

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

https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6OS2.html

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

http://download.microsoft.com/download/f/f/a/ffae9ec6-3bf6-488a-843d-b96d552fd815/FontTools.exe

Microsoft社のFontToolsのダウンロードURLです。ここでダウンロードした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/*.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

..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)をサポートしています。

..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フォントを定義するものです。

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は、この一般フォントファミリ名と実際のフォントとの対応付けをするものです。

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

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

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

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

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

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