Utilizzo delle utilità grafiche XPS | Java

Come produrre facilmente forme base in XPS

La specifica XPS definisce elementi grafici primitivi che possono essere utilizzati per comporre qualsiasi forma complessa. Aspose.Page per Java fornisce classi che incapsulano questi elementi. Tuttavia, creare anche forme relativamente semplici, come un settore o un segmento circolare, o un n-gono regolare inscritto o circoscritto a un cerchio, può essere un po’ noioso. Anche disegnare un cerchio o un’ellisse non è così semplice come potrebbe essere. Per questo motivo, Aspose.Page offre anche una serie di metodi di utilità per risparmiare tempo durante queste attività.

Nell’esempio seguente, utilizziamo tutte le utilità per le forme disponibili. È importante notare che ciascuno di questi metodi di utilità restituisce un oggetto di tipo XpsPathGeometry, che può quindi essere utilizzato per creare percorsi XPS. Per questi percorsi è possibile specificare proprietà di aspetto: pennelli, pattern di tratto, opacità, ecc.

// 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();
}

Iniziamo creando un nuovo documento XPS e regolando le dimensioni della prima pagina. La prima forma che aggiungiamo alla pagina è un cerchio verde pieno specificato dal suo centro e raggio. Successivamente, disegniamo un pentagono regolare rosso vuoto inscritto in quel cerchio. Segue un esagono regolare tratteggiato in magenta e circoscritto al cerchio.

A destra, disegniamo un settore circolare rosso (o una “fetta di torta”) tra -45 e +45 gradi, seguito da un segmento circolare nero con gli stessi parametri sopra il settore.

L’ultima parte del disegno include un rettangolo rosso (specificato dal suo angolo in alto a sinistra e dalle sue dimensioni) e un’ellisse gialla (specificata dal suo centro e dai suoi raggi) inscritta nel rettangolo. In questo caso, gestiamo l’iscrizione “a mano”.

Ecco l’output previsto nel file XPS salvato:

Come posizionare facilmente un’immagine su una pagina XPS

Quando si utilizzano le primitive definite dalla specifica XPS, il posizionamento di un’immagine su una pagina prevede due passaggi:

• Aggiunta di un tracciato rettangolare (riquadro immagine) da riempire con l’immagine;
• Applicazione di un pennello immagine al riquadro immagine, dove è necessario specificare un riquadro di visualizzazione e una finestra di visualizzazione. In genere, è necessario conoscere la risoluzione e le dimensioni in pixel dell’immagine per fornire con precisione questi parametri.

Fortunatamente, esiste un metodo pratico tra le utilità grafiche XPS nell’API Aspose.Page per Java che può gestire la maggior parte del lavoro. Offre anche modalità di adattamento comuni. Diamo un’occhiata al seguente esempio:

// 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();
}

Di nuovo, iniziamo con un nuovo documento XPS e ridimensioniamo la prima pagina. Vale la pena ricordare che, per impostazione predefinita, l’immagine utilizzata come pennello verrà visualizzata a mosaico nel riquadro dell’immagine, proprio come se fosse utilizzata in modalità XpsTileMode.Tile. Tuttavia, nella prima parte dell’esempio, mostriamo come impedire questo effetto di piastrellatura.

Quindi, vogliamo innanzitutto che l’immagine venga visualizzata alle coordinate (10, 10) e che si adatti alla larghezza del riquadro rettangolare, che è 200 unità di larghezza e 200 unità di altezza. Per visualizzare meglio il risultato, disegniamo prima il riquadro stesso. Quindi, procediamo a creare l’immagine (che è essenzialmente un tracciato riempito). Infine, dopo aver ottenuto il riempimento del tracciato e averlo assegnato a XpsImageBrush, impostiamo la proprietà TileMode su XpsTileMode.None.

A destra, posizioniamo la stessa immagine adattandola all’altezza del riquadro immagine. Notate l’effetto di piastrellatura.

Infine, posizioniamo nuovamente la stessa immagine a destra e la regoliamo per adattarla sia all’altezza che alla larghezza del riquadro immagine, con conseguente distorsione dell’immagine.

Ed ecco il risultato nel file XPS salvato: