Utilizzo delle utilità grafiche XPS | .NET

Come produrre facilmente forme semplici in XPS

La specifica XPS definisce elementi primitivi grafici che possono essere utilizzati per comporre qualsiasi forma complessa. Aspose.Page per .NET fornisce classi che incapsulano questi elementi. Tuttavia, utilizzarli può essere un po’ noioso quando si devono produrre anche forme relativamente semplici, come un settore circolare o un segmento, o un n-gono regolare inscritto o circoscritto a un cerchio. Anche disegnare un cerchio o un’ellisse non è così semplice come potrebbe e probabilmente dovrebbe essere. Per questo motivo Aspose.Page fornisce anche una serie di metodi di utilità che molto probabilmente vi faranno risparmiare tempo durante l’esecuzione di tali attività.

Nell’esempio seguente, utilizziamo tutte le utilità per le forme disponibili. Si noti che tutti restituiscono un oggetto di tipo XpsPathGeometry, che può quindi essere utilizzato per costruire percorsi XPS. Per questi percorsi è possibile specificare le proprietà di aspetto: pennelli, pattern di tratto, opacità, ecc.

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

string outputFileName = "UseShapeUtilsXPS_out.xps";

// Create new XPS Document
using (XpsDocument doc = new XpsDocument())
{
    // Set first page's size.
    doc.Page.Width = 650f;
    doc.Page.Height = 240f;

    // Draw a circle with center (120, 120) and radius 100.
    XpsPath path = doc.CreatePath(doc.Utils.CreateCircle(new PointF(120f, 120f), 100f));
    path.Fill = doc.CreateSolidColorBrush(Color.Green);
    doc.Add(path);

    // Inscribe a regular pentagon in the circle.
    path = doc.CreatePath(doc.Utils.CreateRegularInscribedNGon(5, new PointF(120f, 120f), 100f));
    path.Fill = doc.CreateSolidColorBrush(Color.Red);
    doc.Add(path);

    // Circumscribe a regular hexagon around the circle.
    path = doc.CreatePath(doc.Utils.CreateRegularCircumscribedNGon(6, new PointF(120f, 120f), 100f));
    path.Stroke = doc.CreateSolidColorBrush(Color.Magenta);
    path.StrokeThickness = 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.Utils.CreatePieSlice(new PointF(340f, 120f), 100f, -45f, 45f));
    path.Stroke = doc.CreateSolidColorBrush(Color.Red);
    path.StrokeThickness = 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.Utils.CreateCircularSegment(new PointF(340f, 120f), 100f, -45f, 45f));
    path.Fill = 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.Utils.CreateRectangle(new RectangleF(530f, 20f, 100f, 200f)));
    path.Stroke = doc.CreateSolidColorBrush(Color.Red);
    doc.Add(path);

    // Draw an ellipse with center (580, 120) and radii 50 and 100.
    path = doc.CreatePath(doc.Utils.CreateEllipse(new PointF(580f, 120f), 50f, 100f));
    path.Fill = doc.CreateSolidColorBrush(Color.Yellow);
    doc.Add(path);

    doc.Save(OutputDir + outputFileName);
}

Iniziamo con un nuovo documento XPS, modificando poi le dimensioni della prima pagina. La prima forma che posizioniamo sulla pagina è un cerchio (specificato dal suo centro e raggio) riempito di verde pieno. Successivamente, inscriviamo un pentagono regolare rosso vuoto in quel cerchio. Segue poi un esagono regolare circoscritto con un contorno magenta.

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

L’ultima parte del disegno consiste in un rettangolo rosso (specificato dal vertice in alto a sinistra e dalle dimensioni) e un’ellisse gialla (specificata dal centro e dai raggi), inscritti nel rettangolo. Qui, controlliamo l’iscrizione “a mano”.

Ecco cosa dovremmo vedere nel file XPS salvato:

Come aggiungere facilmente un’immagine a una pagina XPS

Con le primitive definite dalla specifica XPS, l’aggiunta di un’immagine a una pagina consiste in due passaggi:

• Aggiunta di un tracciato rettangolare che si desidera riempire con l’immagine;
• Impostazione di un pennello immagine per il tracciato, 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 i primi due parametri.

Fortunatamente, esiste un metodo pratico tra le utilità grafiche XPS dell’API Aspose.Page per .NET che può svolgere (quasi) tutto il lavoro per voi. Offre anche diverse modalità di adattamento. Diamo un’occhiata all’esempio seguente:

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

string outputFileName = "UseImageUtilsXPS_out.xps";

// Create new XPS Document
using (XpsDocument doc = new XpsDocument())
{
    // Set first page's size.
    doc.Page.Width = 540f;
    doc.Page.Height = 220f;

    // Draw the image box.
    RectangleF imageBox = new RectangleF(10f, 10f, 200f, 200f);
    XpsPath path = doc.AddPath(doc.Utils.CreateRectangle(imageBox));
    path.Stroke = doc.CreateSolidColorBrush(Color.Black);
    // Add an image to fit width.
    path = doc.Utils.CreateImage(DataDir + "R08LN_NN.jpg", imageBox, ImageMode.FitToWidth);
    // Prevent tiling.
    ((XpsImageBrush)path.Fill).TileMode = XpsTileMode.None;
    doc.Add(path);

    // Add an image to fit width.
    doc.Add(doc.Utils.CreateImage(DataDir + "R08LN_NN.jpg", new RectangleF(220f, 10f, 200f, 100f), ImageMode.FitToHeight));

    // Add an image to fit width.
    doc.Add(doc.Utils.CreateImage(DataDir + "R08LN_NN.jpg", new RectangleF(430f, 10f, 100f, 200f), ImageMode.FitToBox));

    // Save resultant XPS document 
    doc.Save(OutputDir + outputFileName);
}

Di nuovo, iniziamo con un nuovo documento XPS e regoliamo le dimensioni della prima pagina. È importante notare a questo punto che, per impostazione predefinita, l’immagine utilizzata come pennello verrà suddivisa in tile sull’area rettangolare, proprio come se fosse utilizzata in modalità XpsTileMode.Tile. Tuttavia, nella prima parte dell’esempio, mostriamo come impedire questo tile.

Quindi, vogliamo innanzitutto che l’immagine appaia in (10, 10) e che si adatti alla larghezza del riquadro rettangolare, che è 200 unità di larghezza e 200 unità di altezza. Per visualizzare il risultato più chiaramente, disegniamo prima il riquadro stesso. Successivamente, creiamo l’immagine (si noti che in realtà è un tracciato riempito). Infine, dopo aver ottenuto il riempimento del tracciato e averlo convertito in XpsImageBrush, impostiamo la proprietà TileMode su XpsTileMode.None.

A destra, posizioniamo la stessa immagine e la adattiamo all’altezza del riquadro immagine. Notate la piastrellatura.

Infine, posizioniamo di nuovo la stessa immagine a destra e la adattiamo sia all’altezza che alla larghezza del riquadro immagine, distorcendo l’immagine.

Ed ecco il risultato nel file XPS salvato: