PDFファイルの結合
v2025.05
JPedalは、複数のPDFを簡単に1つのファイルに結合するいくつかの方法を提供します。このツールは、指定されたファイルのすべてのページを含む1つのファイルを作成します。元のファイルはこのプロセスで変更されません。
PdfMergeは、コマンドラインから複数のファイルのページを新しい1つのファイルに結合するために使用できます。引数には、入力ファイル、オプション、出力ファイルが含まれます。 入力ファイルとオプションは任意の順序で指定でき、ファイルは引数に表示される順序で結合されます。 最後の引数は常にすべての結合されたページの出力ファイルでなければなりません。
java -cp jpedal.jar org.jpedal.tools.PdfMerge [mergeOptions] inputFile1.pdf inputFile2.pdf... outputFile.pdf
PdfMergeには、結合を実行するための一連の静的な便利メソッドがあります。 これらのメソッドは、ツールの使用を迅速かつ簡単にするPdfMergeの一般的なユースケースをカバーしています。
2つのファイルの結合 これらのメソッドは2つのFileオブジェクトを受け取り、それらのPDFのページを1つのファイルに結合します。一部のメソッドではパスワードを指定したり、結合の異なる側面を制御するオプションを指定したりできます。
//2つのファイルを1つのファイルに結合
PdfMerge.mergeFiles(new File("inputFile1.pdf"), new File("inputFile2.pdf"), new File("outputFile.pdf"));
//パスワード付きの2つのファイルを1つのファイルに結合
PdfMerge.mergeFiles(new File("inputFile1.pdf"), "inputFile1_Password", new File("inputFile2.pdf"), "inputFile2_Password", new File("outputFile.pdf"));
//マージオプションの配列を作成
final ArrayList<MergeOption> options = new ArrayList<>();
//options.add(MergeOption.INTERLEAVE); //インターリーブオプションの使用例
//追加オプション付きで2つのファイルを1つのファイルに結合
PdfMerge.mergeFiles(new File("inputFile1.pdf"), new File("inputFile2.pdf"), new File("outputFile.pdf"), options);
//追加オプション付きでパスワード付きの2つのファイルを1つのファイルに結合
PdfMerge.mergeFiles(new File("inputFile1.pdf"), "inputFile1_Password", new File("inputFile2.pdf"), "inputFile2_Password", new File("outputFile.pdf"), options);
ファイル配列の結合 これらのメソッドは、ファイル配列を受け取り、それらのPDFのページを1つのファイルに結合します。一部のメソッドでは、入力ファイル配列の長さと一致する文字列配列としてパスワードを指定できます。また、マージオプションを提供し、結合の異なる側面を制御できるメソッドもあります。
//PDF配列を1つのファイルに結合
PdfMerge.mergeFiles(new File[]{new File("inputFile.pdf"), ...}, new File("outputFile.pdf"));
//パスワード付きのPDF配列を1つのファイルに結合
//入力ファイル配列とパスワード配列は同じ長さである必要があります
PdfMerge.mergeFiles(new File[]{new File("inputFile.pdf"), ...}, new String[]{"inputFile_password", ...}, new File("outputFile.pdf"));
//マージオプションの配列を作成
final ArrayList<MergeOption> options = new ArrayList<>();
//options.add(MergeOption.INTERLEAVE); //インターリーブオプションの使用例
//PDF配列を1つのファイルに結合
PdfMerge.mergeFiles(new File[]{new File("inputFile.pdf"), ...}, new File("outputFile.pdf"), options);
//パスワード付きのPDF配列を1つのファイルに結合
//入力ファイル配列とパスワード配列は同じ長さである必要があります
PdfMerge.mergeFiles(new File[]{new File("inputFile.pdf"), ...}, new String[]{"inputFile_password", ...}, new File("outputFile.pdf"), options);
PdfMergeには、結合の異なる側面を制御できるいくつかのオプションがあります。これらは、マージメソッドに渡すか、コマンドラインで次のように設定できます。
PdfMergeは、最後の入力ドキュメント以外の各入力ドキュメントのページの後に空白ページを追加します。新しい空白ページは、その前のページのサイズと一致します。このオプションは、インターリーブと互換性がなく、インターリーブが選択された場合は何も行いません。
コマンドライン引数
--add_dividing_page
マージオプションの値
MergeOption.ADD_DIVIDING_PAGE
PdfMergeは、元のページのコンテンツの下に拡張するフッターを追加します。このフッターには、元のファイル名とそのページのページ番号が表示され、PdfMergeAttributesを使用してカスタマイズできます。
コマンドライン引数
--add_footer
マージオプションの値
MergeOption.ADD_FOOTER
デフォルトでは、PdfMergeは最初のファイルからページを追加し、その後に続く各ファイルのすべてのページを追加します。インターリーブオプションを使用すると、ページは各ファイルから1ページずつ追加されます。 これにより、各ファイルの最初のページが順番に追加され、その後2ページ目が追加されます。結合するページがなくなったファイルがある場合、残りのファイルは同じルールに従って続けて結合されます。
コマンドライン引数
--interleave
マージオプションの値
MergeOption.INTERLEAVE
PdfMergeは、結合されるすべてのページのサイズを最初のドキュメントの最初のページに合わせて調整します。
コマンドライン引数
--normalise_page_size_to_match_first
マージオプションの値
MergeOption.NORMALISE_PAGE_SIZE_TO_MATCH_FIRST
PdfMergeは、結合されるすべてのページの回転を最初のドキュメントの最初のページに合わせて調整します。
コマンドライン引数
--normalise_rotation_to_match_first
マージオプションの値
MergeOption.NORMALISE_ROTATION_TO_MATCH_FIRST
PdfMergeには、結果のファイルに新しいコンテンツを作成するオプションがあります。出力の外観をより詳細に制御するために、マージ時に使用する属性を設定できます。これらの属性は、以下に詳述するキーと値のペアをコマンドラインに含めるか、PdfMergeAttributesオブジェクトをPdfMergeのインスタンスに渡すことで定義できます。
java -cp jpedal.jar org.jpedal.tools.PdfMerge [mergeOptions] [attributeKey aatributeValue...] inputFile1.pdf inputFile2.pdf... outputFile.pdf
#例：新しいテキストコンテンツに使用するフォントを設定
java -cp jpedal.jar org.jpedal.tools.PdfMerge [mergeOptions] --font_name Helevetica inputFile1.pdf inputFile2.pdf... outputFile.pdf
final File[] inputFiles = //ここで入力ファイル配列を作成
final byte[][] passwords = //ここで入力ファイルパスワード配列を作成
final File outputFile = //ここで出力ファイルオブジェクトを作成
final PdfMergeAttributes attributes = new PdfMergeAttributes();
attributes.setFontName("Helvetica");
attributes.setFontSize(16);
final PdfMerge pdfMerger = new PdfMerge();
pdfMerger.setPdfMergeAttributes(attributes);
pdfMerger.merge(inputFiles, outputFile, passwords);
以下は、PdfMergeによって生成される新しいコンテンツをカスタマイズするために使用できる属性のリストです。このリストの各エントリには、属性の使用法、コマンドライン引数、およびPdfMergeAttributesオブジェクトで値を設定するメソッドが詳述されています。
フォント名は、マージ時に生成される新しいテキストコンテンツで使用されるフォントを指定します。この属性の値は、14のPDF基本フォントのいずれかに限定されます。
コマンドライン引数 キー: –font_name 値: [Courier, Courier-Bold, Courier-Oblique, Courier-BoldOblique, Helvetica, Helvetica-Bold, Helvetica-Oblique, Helvetica-BoldOblique, Times-Roman, Times-Bold, Times-Italic, Times-BoldItalic, Symbol, ZapfDingbats] コマンドライン例:
--font_name Helvetica
PdfMergeAttribute メソッド
PdfMergeAttributes.setFontName(String fontname);
フォントサイズは、マージ時に生成される新しいテキストコンテンツのテキストサイズを指定します。この属性の値は、正の整数である必要があります。
コマンドライン例 キー: –font_size 値: テキストフォントサイズの正の整数 コマンドライン引数:
--font_size 16
PdfMergeAttribute メソッド
PdfMergeAttributes.setFontSize(int fontsize);
フッターの高さは、フッターを追加する際にページの下部に追加される追加スペースを制御します。高さはPDF座標系で指定され、既存のページコンテンツの下に表示されます。
コマンドライン例 キー: –footer_height 値: フッターの高さの正の整数 コマンドライン引数:
--footer_height 30
PdfMergeAttribute メソッド
PdfMergeAttributes.setFooterHeight(int fontsize);
フッターテンプレートは、add_footerオプションを使用する際に追加されるテキストコンテンツを制御します。この属性の値には、ドキュメントおよびページ固有の値に置き換えられる2つの動的変数があります。%FILENAME - 元のファイル名に置き換えられます。%PAGENUMBER - 元のファイル内のこのページの元のページ番号に置き換えられます。
コマンドライン例 キー: –footer_template 値: add_footerオプションを使用する場合に各ページのフッターに追加される文字列。コマンドライン引数:
--footer_template "%FILENAME, Page %PAGENUMBER"
PdfMergeAttribute メソッド
PdfMergeAttributes.setFooterTemplate(String template);
テキストの色は、マージ用に生成されるテキストコンテンツの色を設定します。
コマンドライン例 キー: –text_color 値: RGBカラーを表す3つの浮動小数点値。各値は0から1の間で、赤、緑、青の順 コマンドライン引数:
--text_color 0.0 0.0 0.0
PdfMergeAttribute メソッド
PdfMergeAttributes.setTextColor(float[] color);