2.1 透かし(共通)

『PDF Tool API』で透かしとして指定できるのは、テキスト、画像、PDF文書、色の4種類あります。この4種類の透かしに共通の機能は次のとおりです。

1. 透かしを配置するページ番号の範囲を指定し、その範囲に透かしを繰り返して配置できる（※１）
2. 各ページ内で同じ場所に透かしの配置領域を設定できる（※２）
3. 透かしのZオーダー（前景か背景か）を指定できる
4. 配置領域内に透かしをタイリング（上下・左右に並べて繰り返し）配置ができる（※３）
5. 透かしの不透明度を指定できる
6. 透かしを画面に表示するかどうか指定できる
7. 透かしを印刷するかどうか指定できる
8. 透かしには名前を付け、指定した名前にあてはまる透かしを削除できる
9. 挿入する透かしに角度を指定できる（※４）

(以下の場合では透かしにAcrobat®互換の指定をすることができなくなります。 * ※１ 連続しないページ指定をした場合 * ※２ 余白や配置矩形を指定した場合 * ※３ タイリング設定をした場合透かしのAcrobat®互換の詳細に関しては「『PDF CookBook』（第5巻）第8章 透かしのAcrobat®互換対応と機能追加」を参照してください。)

以下はV7.0以降で加わった機能です * ※４ 透かしの角度指定 ))

透かしの配置領域の指定方法は、①配置矩形をsetRect()で指定、②表示矩形(PDFリーダーなどで表示される範囲。ISO 32000-1の用語ではMediaBoxとCropBoxの交わり。)の内側に余白をsetMargin()で指定、の2つあります。両方指定したときは2つの矩形の共通領域が配置領域となります。

setRect()による方法を2.1.1 透かしの配置の設定―その1で、setMargin()による方法を2.1.2 透かしの配置の設定―その2で紹介します。