Add Circle Ellipse to XPS Document with Aspose.Page for .NET

Introduction

Creating visually appealing XPS documents is a common requirement in various applications. Aspose.Page for .NET provides a powerful set of features to manipulate XPS documents efficiently. In this tutorial, we will focus on adding a circle ellipse to an XPS document using Aspose.Page for .NET. Follow the steps below to enhance your XPS documents with vibrant radial gradients.

Prerequisites

Before diving into the tutorial, make sure you have the following prerequisites in place:

• Installed Aspose.Page for .NET library. You can download it from here.
• A development environment, preferably Visual Studio or any other .NET development tool.
• Basic knowledge of C# programming.

Import Namespaces

To start, include the necessary namespaces in your C# code:

using Aspose.Page.XPS;
using Aspose.Page.XPS.XpsModel;
using System.Collections.Generic;
using System.Drawing;

Now, let’s break down the example into multiple steps:

Step 1: Set up the Document

// ExStart:1
// The path to the documents directory.
string dataDir = "Your Document Directory";
// Create new XPS Document
XpsDocument doc = new XpsDocument();

Here, we initialize a new XPS document using Aspose.Page for .NET.

Step 2: Define Radial Gradient Ellipse

// Radial gradient stroked ellipse in the lower left
List<XpsGradientStop> stops = new List<XpsGradientStop>();
stops.Add(doc.CreateGradientStop(doc.CreateColor(0, 0, 255), 0f));
stops.Add(doc.CreateGradientStop(doc.CreateColor(255, 0, 0), .25f));
stops.Add(doc.CreateGradientStop(doc.CreateColor(0, 255, 0), .5f));
stops.Add(doc.CreateGradientStop(doc.CreateColor(255, 255, 0), .75f));
stops.Add(doc.CreateGradientStop(doc.CreateColor(255, 0, 0), 1f));

XpsPath path = doc.AddPath(doc.CreatePathGeometry("M 20,250 A 100,50 0 1 1 220,250 100,50 0 1 1 20,250"));

This step involves defining a radial gradient ellipse with various color stops.

Step 3: Set Radial Gradient Brush

path.Stroke = doc.CreateRadialGradientBrush(new PointF(575f, 125f), new PointF(575f, 100f), 75f, 50f);
((XpsGradientBrush)path.Stroke).SpreadMethod = XpsSpreadMethod.Reflect;
((XpsGradientBrush)path.Stroke).GradientStops.AddRange(stops);
stops.Clear();

Here, we set the stroke of the ellipse to a radial gradient brush, providing it with the necessary parameters.

Step 4: Adjust Stroke Thickness

path.StrokeThickness = 12f;

This step involves adjusting the thickness of the stroke for better visualization.

Step 5: Save the Resultant XPS Document

// Save resultant XPS document
doc.Save(dataDir + "AddEllipse_outXPS.xps");
// ExEnd:1

Finally, save the modified XPS document to the desired location.

Conclusion

Congratulations! You’ve successfully added a circle ellipse with radial gradients to your XPS document using Aspose.Page for .NET. Experiment with different parameters and colors to achieve the desired visual effects in your documents.

FAQ’s

Q1: Can I use Aspose.Page for .NET with other document formats?

A1: Aspose.Page for .NET specifically deals with XPS document manipulation. For other formats, consider using related Aspose libraries.

Q2: Is a temporary license available for testing purposes?

A2: Yes, you can obtain a temporary license for testing by visiting this link.

Q3: Where can I find additional help and discussions?

A3: Visit the Aspose.Page forum for community support and discussions.

Q4: Are there any sample documents available for reference?

A4: Explore the documentation for comprehensive examples and guidelines.

Q5: Can I purchase Aspose.Page for .NET?

A5: Yes, you can purchase the library here.