狙い・効果

矩形に合わせて画像を拡大・縮小して描画します。

処理の概要

配置矩形と配置指定は2.2.1 ページ上に画像を描画と同じです。

画像が配置矩形より大きいとき画像を縮小して配置、画像が配置矩形よりも小さいときは画像を拡大して配置します。但し、縦横比は維持したまま、配置矩形の幅または高さと画像の幅または高さ一致するところまで拡大・縮小します。幅が一致したときは高さ方向に、高さが一致したときは幅の方向に配置指定のとおりに配置されます。

PDF Tool APIの主な機能

• APIdrawFitImage(PtlRect, PtlContent.ALIGN, PtlParamDrawImage) :画像の描画
• APIsetImageStream(PtlParamInput) :入力画像ストリームの設定
• APIsetImagePageNumber(int) :マルチTiffのページ番号の設定

プログラム例

package cookbook;

import java.io.*;
import jp.co.antenna.ptl.*;


public class AddImageFitWithRect {

    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        if (args.length < 5)
        {
            System.out.println("usage: java AddImageFitWithRect in-pdf-file out-pdf-file insert-image-file page-num image-align");
            return;
        }

        try (PtlParamInput inputFile = new PtlParamInput(args[0]);
             PtlParamOutput outputFile = new PtlParamOutput(args[1]);
             PtlPDFDocument doc = new PtlPDFDocument();
             BufferedReader br = new BufferedReader(new InputStreamReader(System.in)))
        {
            // PDFファイルをロードします。
            doc.load(inputFile);

            //コマンドライン引数の取得
            String imageURI = args[2];
            int pageToAdd = Integer.parseInt(args[3]);
            int numPages = doc.getPageCount();
            System.out.println("ページ数：" + numPages);
            if((numPages < 0)||(numPages < pageToAdd))
            {
                System.err.println("挿入したいページは全ページ数よりも小さい正の値を指定してください。");
                return;
            }
            String imageAlign = args[4];


        ...【RemovePages.javaと同じ処理のため省略
             ・doc.getPages()メソッドを用いてPtlPages pagesにページコンテナを取得
             ・ページコンテナが空だった場合にエラーを出力して終了】...


                try (PtlPage page = pages.get(pageToAdd - 1);// ページの取得(パラメータindexは0が先頭のため1を引く)
                     PtlContent content = page.getContent();// ページコンテントの取得
                     PtlRect outputRect = setOutputRect(br);// 出力矩形の設定（setOutputRectを用いて初期化）
                     PtlParamDrawImage paramDrawImage = new PtlParamDrawImage(); //画像の描画に使うパラメータクラス
                     PtlParamInput insertImage = new PtlParamInput(imageURI)) //画像指定に使うパラメータクラス
                {
                    //入力画像ストリームの設定
                    paramDrawImage.setImageStream(insertImage);
                    //マルチTiffのページ番号の設定（マルチTiffファイルにのみ有効） 
                    //数値を設定しない場合は、-1が設定されたとみなします
                    //PtlParamImagePageに設定する場合に限り、-1を設定すると全ページを挿入します。
                    paramDrawImage.setImagePageNumber(0);

                    // 画像出力
                    content.drawFitImage(outputRect, PtlContent.ALIGN.valueOf(imageAlign), paramDrawImage);
                }
                catch (IllegalArgumentException ex){//PtlContent.ALIGNの指定が誤っていた場合のエラーメッセージ
                    System.out.println(ex.getMessage());
                    System.out.println("ERROR : alignにはPtlContent.ALIGNに含まれる名前を指定してください。");
                    ex.printStackTrace();
                }
            }


        ...【AppendPages.javaと同じ処理のため省略
             ・PtlParamOutputを用いてPtlPDFDocument docの内容を出力
             ・PtlException, Exception, Error を catchするエラー処理
             ・finally文で"--完了--"と表示する処理】...

    }

    public static PtlRect setOutputRect(BufferedReader br) throws IOException, PtlException, Exception, Error{
        float top, bottom, left, right;
        boolean isValueOkay = false;
        PtlRect outputRect = new PtlRect();
        while(!isValueOkay)
        {
            System.out.println("画像の配置矩形の各数値を入力してください。");
            System.out.print("top (mm) : ");
            top = Float.parseFloat(br.readLine());
            System.out.print("bottom (mm) : ");
            bottom = Float.parseFloat(br.readLine());
            if(top < bottom) //不正矩形は再入力させる
            {
                System.out.println("topの値はbottomよりも大きい値を指定して再度入力してください。");
                continue;
            }
            System.out.print("left (mm) : ");
            left = Float.parseFloat(br.readLine());
            System.out.print("right (mm) : ");
            right = Float.parseFloat(br.readLine());
            if(right < left) //不正矩形は再入力させる
            {
                System.out.println("rightの値はleftよりも大きい値を指定して再度入力してください。");
                continue;
            }

            //矩形を正しく指定できた場合の処理
            isValueOkay = true;
            outputRect.setLeft(left);
            outputRect.setBottom(bottom);
            outputRect.setRight(right);
            outputRect.setTop(top);
        }                   
            return outputRect;
    }
}

プログラムファイル名

AddImageFitWithRect.java

入出力操作の例

追加する画像（stamp-sample.png）は、サイズが幅215px×高さ215pxで、dpi指定はありません。大きさはデフォルトの72dpiで計算しますが、配置矩形と比べて小さな画像です。AddImage（drawImage()を使用）では追加イメージは小さいままですが、AddImageFitWithRect（drawFitImage()を使用）で追加すると配置矩形の大きさまで拡大します。