XPS グラフィックユーティリティの使用 | Java

XPS で基本的な図形を 簡単に 作成する方法

XPS 仕様では、複雑な図形を作成するために使用できるグラフィックの基本要素が定義されています。Aspose.Page for Java は、これらの要素をカプセル化するクラスを提供しています。しかし、扇形や円弧、円に内接または外接する正 n 角形など、比較的単純な図形の作成でさえ、少々面倒な場合があります。円や楕円を描画することさえ、簡単ではありません。そのため、Aspose.Page では、これらの作業にかかる時間を節約するためのユーティリティ メソッドも提供しています。

以下の例では、利用可能なすべての図形ユーティリティを使用しています。これらのユーティリティメソッドはそれぞれ、 XpsPathGeometryオブジェクトを返す点に注意してください。このオブジェクトは XPSパスの作成に使用できます。また、これらのパスには、ブラシ、ストロークパターン、不透明度などの外観プロパティを指定できます。

// Using shape utilities for adding shapes to XPS document.

String outputFileName = "UseShapeUtilsXPS_out.xps";

// Create new XPS Document
XpsDocument doc = new XpsDocument();
try {
    // Set first page's size.
    doc.getPage().setWidth(650f);
    doc.getPage().setHeight(240f);

    // Draw a circle with center (120, 120) and radius 100.
    XpsPath path = doc.createPath(doc.getUtils().createCircle(new java.awt.geom.Point2D.Float(120f, 120f), 100f));
    path.setFill(doc.createSolidColorBrush(doc.createColor(0, 255, 0)));
    doc.add(path);

    // Inscribe a regular pentagon in the circle.
    path = doc.createPath(doc.getUtils().createRegularInscribedNGon(5, new java.awt.geom.Point2D.Float(120f, 120f), 100f));
    path.setFill(doc.createSolidColorBrush(doc.createColor(255, 0, 0)));
    doc.add(path);

    // Circumscribe a regular hexagon around the circle.
    path = doc.createPath(doc.getUtils().createRegularCircumscribedNGon(6, new java.awt.geom.Point2D.Float(120f, 120f), 100f));
    path.setStroke(doc.createSolidColorBrush(doc.createColor(255, 0, 255)));
    path.setStrokeThickness(3f);
    doc.add(path);

    // Draw a sector of the circle centered at (340, 120), starting at -45 degrees and ending at +45 degrees.
    path = doc.createPath(doc.getUtils().createPieSlice(new java.awt.geom.Point2D.Float(340f, 120f), 100f, -45f, 45f));
    path.setStroke(doc.createSolidColorBrush(doc.createColor(255, 0, 0)));
    path.setStrokeThickness(5f);
    doc.add(path);

    // Draw a segment of the circle centered at (340, 120), starting at -45 degrees and ending at +45 degrees.
    path = doc.createPath(doc.getUtils().createCircularSegment(new java.awt.geom.Point2D.Float(340f, 120f), 100f, -45f, 45f));
    path.setFill(doc.createSolidColorBrush(doc.createColor(0, 0, 0)));
    doc.add(path);

    // Draw a rectangle with the top left vertex (530, 20), width 100 units and height 200 units.
    path = doc.createPath(doc.getUtils().createRectangle(new Rectangle2D.Float(530f, 20f, 100f, 200f)));
    path.setStroke(doc.createSolidColorBrush(doc.createColor(255, 0, 0)));
    doc.add(path);

    // Draw an ellipse with center (580, 120) and radii 50 and 100.
    path = doc.createPath(doc.getUtils().createEllipse(new java.awt.geom.Point2D.Float(580f, 120f), 50f, 100f));
    path.setFill(doc.createSolidColorBrush(doc.createColor(255, 255, 0)));
    doc.add(path);

    doc.save(getOutputDir() + outputFileName);
} finally {
    // nothing to dispose explicitly
}

まず、新しいXPSドキュメントを作成し、最初のページのサイズを調整します。ページに追加する最初の図形は、中心と半径で指定された緑色の円です。次に、その円に内接する塗りつぶされていない赤色の正五角形を描きます。次に、マゼンタで線を引いた正六角形を描き、円に外接します。

右側には、-45度から+45度までの赤色の扇形（または「パイスライス」）を描き、その扇形の上に同じパラメータを持つ黒い円を描きます。

描画の最後の部分には、赤色の四角形（左上隅と寸法で指定）と、その四角形に内接する黄色の楕円（中心と半径で指定）が含まれます。この場合、内接は「手作業」で行います。

保存されたXPSファイルの意図された出力は次のとおりです。

XPS ページに画像を 簡単に 配置する方法

XPS 仕様で定義されたプリミティブを使用する場合、ページへの画像配置は次の 2 つの手順で行います。

• 画像で塗りつぶすための長方形のパス（画像ボックス）を追加します。
• 画像ボックスに画像ブラシを適用します。この際に、ビューボックスとビューポートを指定する必要があります。通常、これらのパラメーターを正確に指定するには、画像の解像度とピクセル単位のサイズを知っておく必要があります。

しかし幸いなことに、Aspose.Page API for Java の XPS グラフィック ユーティリティの中に、これらの作業のほとんどを自動で処理できる便利なメソッドがあります。また、一般的なフィットモードも提供されています。次の例をご覧ください。

// Using image utilities for adding images to XPS document.

String outputFileName = "UseImageUtilsXPS_out.xps";

// Create new XPS Document
XpsDocument doc = new XpsDocument();
try {
    // Set first page's size.
    doc.getPage().setWidth(540f);
    doc.getPage().setHeight(220f);

    // Draw the image box.
    java.awt.geom.Rectangle2D.Float imageBox = new java.awt.geom.Rectangle2D.Float(10f, 10f, 200f, 200f);
    XpsPath path = doc.addPath(doc.getUtils().createRectangle(imageBox));
    path.setStroke(doc.createSolidColorBrush(doc.createColor(0, 0, 0)));
    // Add an image to fit width.
    path = doc.getUtils().createImage(getDataDir() + "R08LN_NN.jpg", imageBox, com.aspose.xps.ImageMode.FitToWidth);
    // Prevent tiling.
    ((XpsImageBrush)path.getFill()).setTileMode(com.aspose.xps.XpsTileMode.None);
    doc.add(path);

    // Add other images using utils
    doc.add(doc.getUtils().createImage(getDataDir() + "R08LN_NN.jpg", new Rectangle2D.Float(220f, 10f, 200f, 100f), com.aspose.xps.ImageMode.FitToHeight));
    doc.add(doc.getUtils().createImage(getDataDir() + "R08LN_NN.jpg", new Rectangle2D.Float(430f, 10f, 100f, 200f), com.aspose.xps.ImageMode.FitToBox));

    // Save resultant XPS document 
    doc.save(getOutputDir() + outputFileName);
} finally {
    // nothing to dispose explicitly here
}

ここでも、新しい XPS ドキュメントを作成し、最初のページのサイズを変更します。ここで注目すべき点は、ブラシとして使用されている画像は、既定では XpsTileMode.Tile モードで使用された場合と同じように、画像ボックス全体に並べて表示されることです。ただし、例の最初の部分では、この並べて表示されないようにする方法を示します。

まず、画像を座標 (10, 10) に表示し、幅 200 単位、高さ 200 単位の長方形ボックスの幅に合わせる必要があります。結果をより視覚的に確認するために、まずボックス自体を描画します。次に、画像 (基本的には塗りつぶされたパス) を作成します。最後に、パスの塗りつぶしを取得して XpsImageBrushにキャストした後、TileModeプロパティをXpsTileMode.Noneに設定します。

右側には、同じ画像を画像ボックスの高さに合わせて配置しています。タイリング効果に注目してください。

最後に、同じ画像をもう一度右側に配置し、画像ボックスの高さと幅に合わせて調整します。その結果、画像が若干歪んでしまいます。

保存したXPSファイルは以下のようになります。