画像

Copper PDFがサポートする画像

Copper PDFはJPEG, GIF, PNG, SVG形式の画像を標準でサポートしています。 各画像は通常のブラウザ同様にimg要素によってドキュメント中に含めることができます。 また、object, embed要素の使用もサポートされています。

CSSのbackground-imageプロパティ、 あるいはcontentプロパティによっても画像の表示が可能です。

他の画像形式の利用

より多種多様な画像フォーマットを使用する場合はサンマイクロシステムズ社により配布されている Java Advanced Imaging Image I/O Tools(JAI) をCopper PDFを動作させるJava環境に管理者がインストールする必要があります。 JAIをインストールすることにより、BMP, JPEG 2000, PNM, TIFF, WBMPの各画像フォーマットが利用可能になります。 また、JAI以外にもJava Image I/Oに対応した拡張ライブラリをインストールすることで利用可能な画像を追加することができます。

ラスター(ビットマップ/ピクセルマップ)画像

GIF / PNG画像

GIFおよびPNG画像の透明化効果はPDF内でも有効です。 ただし、PDF 1.3以前のバージョンのPDFを出力する場合、 PNG画像の半透明化効果が正確に表現されず、透明・不透明だけとなります。

アニメーションGIFの場合、最初のコマだけが使われ、アニメーションしません。

JPEG / JPEG 2000画像

JPEG画像は処理を加えずに、そのままPDFに含めることができます。 入出力プロパティoutput.pdf.jpeg-image にto-flateを設定することで画像を展開してからPDFに含むこともできますが、PDFのサイズは大きくなります。

JAIがインストールされている場合は、JPEG 2000にも同様の処理が適用されます。 JAIがない場合はJPEG 2000は全く利用できませんのでご注意ください。

その他の画像

JAI等のライブラリで他の画像形式が利用可能な場合、それらの扱いはGIF /PNG画像に準じます。 半透明効果をサポートする画像形式の場合はPDF内でも再現され、アニメーションする画像では最初のコマだけが使われます。

SVG画像

SVG画像ファイルの参照

Copper PDFはSVG画像ファイル(.svg)またはGZIPで圧縮されたSVG画像ファイル(.svgz)をサポートしています。 ただし、グラデーション塗りとSVG埋め込みフォントには対応していません。

一般的なブラウザではobject要素によりSVG画像サポートされていますので、 Copper PDFでも同様の方法を推奨します。


SVGをサポートしないブラウザで表示されるテキスト。

]]>

Copper PDFでは、SVG画像を他の画像と同様に扱うことができます。 img要素を利用することができ、background-imageプロパティにより背景に設定することもできます。

インラインSVG

SVGを別ファイルに分けずに、文章中に直接記述することができます。 グラフ等、動的に変化する画像をドキュメントに含める場合に適しています。 インラインSVGは、ドキュメント中でhttp://www.w3.org/2000/svgと名前空間宣言したSVGを記述するだけです。



  インラインSVGを含むドキュメント


すぐ下に○が表示されます。

]]>

画像を読み込めない場合

画像ファイルが存在しない、データの破損、Copper PDFがサポートしない画像形式といった原因で 画像を読み込めない場合は、通常はalt属性で指定された代替テキストが表示されます。 入出力プロパティoutput.broken-image の設定により、画像の形に×印を表示するか、空白を空けることができます。