Verwenden von XPS-Grafikdienstprogrammen | Java

So erstellen Sie einfach Grundformen in XPS

Die XPS-Spezifikation definiert grafische Grundelemente, die zum Zusammenstellen komplexer Formen verwendet werden können. Aspose.Page für Java stellt Klassen bereit, die diese Elemente kapseln. Allerdings kann es etwas mühsam sein, selbst relativ einfache Formen zu erstellen, etwa einen Kreissektor oder ein Kreissegment oder ein regelmäßiges N-Eck, das in einen Kreis eingeschrieben oder um diesen herum umschrieben ist. Selbst das Zeichnen eines Kreises oder einer Ellipse ist nicht so einfach, wie es sein könnte. Aus diesem Grund bietet Aspose.Page auch eine Reihe von Hilfsmethoden, um bei der Arbeit an diesen Aufgaben Zeit zu sparen.

Im folgenden Beispiel verwenden wir alle verfügbaren Formdienstprogramme. Es ist wichtig zu beachten, dass jede dieser Dienstprogrammmethoden ein Objekt von XpsPathGeometry zurückgibt, das dann zum Erstellen von XPS-Pfaden verwendet werden kann. Und für diese Pfade können Sie Aussehenseigenschaften festlegen – Pinsel, Strichmuster, Deckkraft usw.

// For complete examples and data files, please go to https://github.com/aspose-page/Aspose.Page-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir();
// Create new XPS Document
final 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 Point2D.Float(120f, 120f), 100f));
    path.setFill(doc.createSolidColorBrush(Color.GREEN));
    doc.add(path);

    // Inscribe a regular pentagon in the circle.
    path = doc.createPath(doc.getUtils().createRegularInscribedNGon(5, new Point2D.Float(120f, 120f), 100f));
    path.setFill(doc.createSolidColorBrush(Color.RED));
    doc.add(path);

    // Circumscribe a regular hexagon around the circle.
    path = doc.createPath(doc.getUtils().createRegularCircumscribedNGon(6, new Point2D.Float(120f, 120f), 100f));
    path.setStroke(doc.createSolidColorBrush(Color.MAGENTA));
    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 Point2D.Float(340f, 120f), 100f, -45f, 45f));
    path.setStroke(doc.createSolidColorBrush(Color.RED));
    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 Point2D.Float(340f, 120f), 100f, -45f, 45f));
    path.setFill(doc.createSolidColorBrush(Color.BLACK));
    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(Color.RED));
    doc.add(path);

    // Draw an ellipse with center (580, 120) and radii 50 and 100.
    path = doc.createPath(doc.getUtils().createEllipse(new Point2D.Float(580f, 120f), 50f, 100f));
    path.setFill(doc.createSolidColorBrush(Color.YELLOW));
    doc.add(path);

    doc.save(dataDir + "UseShapeUtilsXPS_out.xps");
} finally {
  if (doc != null)
    doc.close();
}

Wir beginnen mit der Erstellung eines neuen XPS-Dokuments und passen dann die Größe der ersten Seite an. Die erste Form, die wir der Seite hinzufügen, ist ein durchgezogener grüner Kreis, der durch seinen Mittelpunkt und seinen Radius angegeben wird. Als nächstes zeichnen wir ein ungefülltes rotes regelmäßiges Fünfeck, das in diesen Kreis eingeschrieben ist. Dann kommt ein regelmäßiges Sechseck, das mit Magenta überstrichen ist und den Kreis umschreibt.

Rechts zeichnen wir einen roten kreisförmigen Sektor (oder ein „Kuchenstück“) zwischen -45 und +45 Grad, gefolgt von einem schwarzen kreisförmigen Segment mit denselben Parametern über dem Sektor.

Der letzte Teil der Zeichnung enthält ein rotes Rechteck (bestimmt durch seine obere linke Ecke und seine Abmessungen) und eine gelbe Ellipse (bestimmt durch seinen Mittelpunkt und seine Radien), die in das Rechteck eingeschrieben ist. In diesem Fall übernehmen wir die Beschriftung „von Hand“.

Hier ist die beabsichtigte Ausgabe in der gespeicherten XPS-Datei:

So platzieren Sie einfach ein Bild auf einer XPS-Seite

Bei Verwendung von durch die XPS-Spezifikation definierten Grundelementen umfasst das Platzieren eines Bildes auf einer Seite zwei Schritte:

• Hinzufügen eines rechteckigen Pfads (Bildfelds), der mit dem Bild gefüllt wird;
• Anwenden eines Bildpinsels auf das Bildfeld, wo Sie ein Ansichtsfeld und ein Ansichtsfenster angeben müssen. Normalerweise müssen Sie die Auflösung und die Größe Ihres Bildes in Pixel kennen, um diese Parameter genau angeben zu können.

Aber glücklicherweise gibt es unter den XPS-Grafikdienstprogrammen in der Aspose.Page-API für Java eine praktische Methode, die den Großteil der Arbeit für Sie erledigt. Es bietet Ihnen auch gängige Anpassungsmodi. Schauen wir uns das folgende Beispiel an:

// For complete examples and data files, please go to https://github.com/aspose-page/Aspose.Page-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir();
// Create new XPS Document
final XpsDocument doc = new XpsDocument();
try {
    // Set first page's size.
    doc.getPage().setWidth(540f);
    doc.getPage().setHeight(220f);

    // Draw the image box.
    Rectangle2D imageBox = new Rectangle2D.Float(10f, 10f, 200f, 200f);
    XpsPath path = doc.addPath(doc.getUtils().createRectangle(imageBox));
    path.setStroke(doc.createSolidColorBrush(Color.BLACK));
    // Add an image to fit width.
    path = doc.getUtils().createImage(dataDir + "R08LN_NN.jpg", imageBox, ImageMode.FitToWidth);
    // Prevent tiling.
    ((XpsImageBrush)path.getFill()).setTileMode(XpsTileMode.None);
    doc.add(path);

    // Add an image to fit width.
    doc.add(doc.getUtils().createImage(
        dataDir + "R08LN_NN.jpg", new Rectangle2D.Float(220f, 10f, 200f, 100f), ImageMode.FitToHeight));

    // Add an image to fit width.
    doc.add(doc.getUtils().createImage(
        dataDir + "R08LN_NN.jpg", new Rectangle2D.Float(430f, 10f, 100f, 200f), ImageMode.FitToBox));

    // Save resultant XPS document 
    doc.save(dataDir + "UseImageUtilsXPS_out.xps");
} finally {
  if (doc != null)
    doc.close();
}

Auch hier beginnen wir mit einem neuen XPS-Dokument und ändern die Größe der ersten Seite. Es ist hier erwähnenswert, dass Ihr Bild, wenn es als Pinsel verwendet wird, standardmäßig auf die gleiche Weise über die Bildbox gekachelt wird, als ob es im Modus XpsTileMode.Tile verwendet würde. Im ersten Teil des Beispiels zeigen wir jedoch, wie man diese Kachelung verhindern kann.

Wir möchten also zunächst, dass das Bild an den Koordinaten (10, 10) angezeigt wird und in die Breite des rechteckigen Kastens passt, der 200 Einheiten breit und 200 Einheiten hoch ist. Um das Ergebnis besser zu visualisieren, zeichnen wir zunächst die Box selbst. Anschließend erstellen wir das Bild (bei dem es sich im Wesentlichen um einen gefüllten Pfad handelt). Nachdem wir schließlich die Füllung des Pfads erhalten und in XpsImageBrush umgewandelt haben, setzen wir die Eigenschaft „TileMode“ auf „XpsTileMode.None“.

Rechts platzieren wir dasselbe Bild passend zur Höhe des Bildfelds. Beachten Sie den Kacheleffekt.

Schließlich platzieren wir dasselbe Bild noch einmal rechts und passen es an die Höhe und Breite des Bildfelds an, was zu einer gewissen Verzerrung des Bildes führt.

Und hier ist das Ergebnis in der gespeicherten XPS-Datei: