はじめに (対象読者・この記事でわかること)

本記事は、JavaでAspose.Cellsを利用し PDF を出力する開発者を対象としています。特に、生成した PDF にフォントを埋め込まず、ファイルサイズを抑えたい、あるいはライセンス上の制約でフォント埋め込みが禁止されているケースに悩んでいる方に最適です。この記事を読むことで、以下のことができるようになります。

  • Aspose.Cells の PdfSaveOptions を用いたフォント埋め込み無効化の設定方法
  • 環境ごとの注意点（OS、フォントパス、ライセンス）とベストプラクティス
  • 実装例と、よくあるエラー（フォント欠損、文字化け）への対処法

背景として、PDF がメール添付や Web 配信でサイズ上限に引っかかりやすく、また埋め込みフォントが原因で法的リスクが発生するケースが増えていることが挙げられます。そこで、最小限の情報だけを PDF に保持しつつ、表示品質を確保する手法をまとめました。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。

  • Java の基本的な開発環境（JDK、IDE、Maven など）
  • Aspose.Cells の基本的な API（Workbook の生成・操作）
  • PDF の概念とフォント埋め込みの意味

背景と概要：PDF 生成におけるフォント埋め込みの必要性と問題点

PDF は「What You See Is What You Get（見たとおりに印刷できる）」を実現するために、文書に使用したフォントを埋め込むことが一般的です。埋め込みにより、閲覧環境に依存せず同一のレイアウトが保証されます。しかし、埋め込むフォントが複数ある場合や、ライセンスが埋め込みを許可しないフォントを使用している場合、PDF のファイルサイズは急激に膨らみます。特に Aspose.Cells で大量のセルデータや多種多様なフォントを扱うと、数十 MB の PDF が生成され、配布や保存に支障をきたすことがあります。

そこで、フォント埋め込みを抑制し、必要最小限の情報だけを PDF に残す設定が求められます。Aspose.Cells では PdfSaveOptions クラスの setEmbedStandardFonts や setFontEmbeddingMode などのプロパティでこれを制御できますが、用途に応じた正しい組み合わせと実装が必要です。以下では、実際に Java コードでどのように設定するかを段階的に解説し、典型的な落とし穴とその回避策も併せて紹介します。

Aspose.Cells でフォント埋め込みを無効化する具体的手順

ステップ1：基本的なプロジェクト構成と依存関係の設定

まずは Maven（または Gradle）で Aspose.Cells のライブラリをプロジェクトに追加します。最新版の aspose-cells を取得し、pom.xml に以下を記述します。

Xml

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cells</artifactId>
    <version>23.12</version>
</dependency>

ポイント
無償評価版でも同様の API が利用できますが、評価版は PDF の生成に透かしが入ります。商用利用の場合は正式ライセンスを取得してください。

次に、Workbook オブジェクトを作成し、サンプルデータをシートに書き込みます。ここまでが通常の Aspose.Cells の使用手順です。

Java

Workbook wb = new Workbook();
Worksheet sheet = wb.getWorksheets().get(0);
Cells cells = sheet.getCells();

cells.get("A1").setValue("フォント埋め込みなしの PDF テスト");
cells.get("A1").getStyle().getFont().setName("Arial");
cells.get("A1").getStyle().getFont().setSize(14);

ステップ2：PdfSaveOptions の設定でフォント埋め込みを抑制

PdfSaveOptions は PDF 出力時のオプションを細かく制御できるクラスです。フォント埋め込みを無効化する主なプロパティは以下の通りです。

プロパティ 目的 推奨設定
setEmbedStandardFonts(boolean) 標準フォント（Helvetica、Times、Courier など）を埋め込むか false
setFontEmbeddingMode(FontEmbeddingModes) フォント埋め込みのモードを指定 FontEmbeddingModes.NoEmbedding
setUseUnicodeEncoding(boolean) Unicode エンコーディングを使用するか true（文字化け防止）
setCompressionLevel(CompressionLevel) PDF 圧縮レベル CompressionLevel.Max（サイズ削減）

実装例は次の通りです。

Java

PdfSaveOptions saveOptions = new PdfSaveOptions();

// フォント埋め込みを完全に無効化
saveOptions.setFontEmbeddingMode(PdfSaveOptions.FontEmbeddingMode.NoEmbedding);

// 標準フォントも埋め込まない
saveOptions.setEmbedStandardFonts(false);

// 文字化け防止のため Unicode エンコーディングを有効化
saveOptions.setUseUnicodeEncoding(true);

// 圧縮レベルを最大に設定し、サイズをさらに削減
saveOptions.setCompressionLevel(CompressionLevel.Max);

これだけで、Aspose.Cells は PDF を生成する際にフォント情報を埋め込みません。代わりに、閲覧側の環境にインストールされた同名フォントを参照します。

ステップ3：PDF の生成と保存

設定が整ったら、Workbook.save メソッドにオプションを渡して PDF を出力します。

Java

String outputPath = "output/no-embed-font.pdf";
wb.save(outputPath, saveOptions);
System.out.println("PDF が生成されました: " + outputPath);

生成された PDF のサイズを確認すると、同じ内容でもフォント埋め込みありの PDF（例：5.2 MB）に比べ、約1.8 MB にまで削減できることが多いです。

ハマった点やエラー解決

1. 文字化けが発生するケース

症状
日本語や特殊文字が「□」や「?」に置き換わる。

原因
setUseUnicodeEncoding(true) を設定し忘れるか、使用しているフォントが Unicode 対応でない。

対策
* PdfSaveOptions の setUseUnicodeEncoding(true) を必ず指定。 * 日本語が必須の場合は、Unicode 対応の「ＭＳ Ｐゴシック」や「Noto Sans CJK JP」など、閲覧環境に必ずインストールされているフォントを使用する。

2. PDF が空白になる、もしくはレイアウトが崩れる

症状
テキストは表示されるが、フォントサイズや太さがデフォルトに戻り、セルの高さが極端に狭くなる。

原因
setEmbedStandardFonts(false) のみ設定し、FontEmbeddingMode を NoEmbedding にし忘れた場合、一部フォント情報が欠損し、Aspose.Cells が代替フォントで描画し直すため。

対策
* 必ず setFontEmbeddingMode(FontEmbeddingMode.NoEmbedding) を併用。 * カスタムフォントを使用している場合は、setCustomFontsPath でフォントディレクトリを明示し、PDF 生成時にそのパスを認識させる。

Java

saveOptions.setCustomFontsPath("C:/Windows/Fonts");

3. ライセンスエラー

症状
「License is not set」や評価版の透かしが表示される。

原因
Aspose.Cells のライセンス設定が不足している。

対策
プロジェクト開始時に以下のコードでライセンスをロードする。

Java

License license = new License();
license.setLicense("Aspose.Total.lic");   // ライセンスファイルへのパス

解決策まとめ

問題 原因 解決策
文字化け Unicode エンコーディング未設定 setUseUnicodeEncoding(true) を付与
レイアウト崩れ フォント埋め込みモード未設定 setFontEmbeddingMode(NoEmbedding) と setEmbedStandardFonts(false) を併用
PDF が空になる カスタムフォントの参照ミス setCustomFontsPath でフォントディレクトリを指定
透かし表示 ライセンス未設定 License クラスで正式ライセンスをロード

まとめ

本記事では、Aspose.Cells を使用して PDF を生成する際にフォント埋め込みを抑制する方法 を解説しました。

  • PdfSaveOptions の正しい設定（NoEmbedding、setEmbedStandardFonts(false)、setUseUnicodeEncoding(true)）でフォント埋め込みを完全に無効化できる。
  • 文字化け防止のために Unicode エンコーディングを必ず有効化し、閲覧環境に存在するフォントを選択すれば、レイアウト崩れも回避できる。
  • トラブルシューティングとして、文字化け・レイアウト崩れ・ライセンスエラーの具体的対策を提示した。

これらを実践すれば、PDF のサイズ削減とライセンス遵守が同時に達成でき、メール添付や Web 配信での扱いが格段に楽になります。次回は、PDF/A 形式でのフォント制御や、セキュリティ設定（暗号化・パスワード保護）についても掘り下げていく予定です。

参考資料