2.2 画像描画

PDF文書のページに画像を追加ページ本文に画像を追加できます。追加可能なのは、BMP/JPEG/PNG/GIF/TIFF/マルチTIFF形式のラスター画像です。

画像を追加するには、

• 挿入先ページ
• ページ内で画像の配置基準とする矩形領域（配置矩形）
• 配置矩形内での画像の揃え方

を指定します。

指定した矩形領域よりも画像の大きさが大きいときは矩形領域に入るように縮小します。小さいときは画像の大きさを変えずに配置矩形の中で揃えるか、矩形領域に合わせて拡大するかを選択できます。矩形領域に合わせる場合は縦横比は維持されます。また、矩形の幅に合わせるか高さに合わせるかを選択できます。

画像の大きさラスター画像をPDFに追加するときの大きさ（寸法）とは、インチ(in)またはセンチ(cm)で表される印刷サイズのことです。この数値は幅と高さのピクセル（px）数とdpi（インチあたりのピクセル数）から計算します。この際、画像の寸法を計算するときのdpiとして、画像自体に設定されているdpiを使うか、それとも強制的に別のdpiを指定するかを設定できます。

画像の透明度を指定できます。

次の4種類の画像のマスク処理マスク処理ができます。

• ステンシルマスク（MASK_STENCIL）―モノクロ（１ビット）のビットマップ画像をマスク画像として使います。黒と白の領域を不透明と透明のように扱い、地の部分をマスク画像で切り抜いた効果をもたらします。不透明部分の色を指定できます。PDF1.3以前では透明が使えないため透明の代わりにステンシルマスクで表現できます。
• カラーキーマスク（MASK_COLORKEY）―マスク画像の中でマスクする（塗らない）色を指定します。指定した色の部分は地が透けて見えます。マスク画像として使えるのは色空間がRGBのBMP形式画像のみです（PDF 1.3以降）。
• 明示マスク（MASK_EXPLICIT）―イメージ画像に対してマスク画像を指定します。マスク画像として使えるのはモノクロのビットマップ画像のみです。イメージ画像とマスク画像は大きさが揃い、ステンシルマスクと似た効果をもたらします（PDF 1.3以降）。
• ソフトマスク（MASK_SOFT）―ソフトマスクでは半透明なマスク効果を指定できます。マスク画像にはグレースケール画像を推奨します（PDF 1.4以降）。

『PDF Tool API』 V7.0以降では画像を挿入する際に任意の画像の角度を指定できます。詳細は「『PDF CookBook』（第5巻）5.1.1 画像を任意の角度で描画する」を参照してください。