Aspose.SVG 25.6.0

Create, Modify, & Convert SVG via .NET API

Aspose.SVG for .NET is a powerful library designed to work with SVG documents in .NET applications. It allows developers to create, manipulate, and convert SVG files into various formats like PDF, SVGZ, PNG, JPG, TIFF, and more. The library supports SVG vectorization, custom configuration, document merging, transformations, and advanced features like gradients, filters, and path building. Perfect for developers aiming to enhance graphical content and automate SVG workflows in .NET environments.

SVG Document Creation and Loading

• Create an Empty SVG Document: Use the SVGDocument() constructor to create a blank SVG document.
• Create SVG from Memory String: Create an SVG file from a memory string using SVGDocument() constructors.
• Create SVG from a Stream: Load SVG from different streams like memory or file using overloaded SVGDocument() constructors.
• Create Custom SVG with Builder API: Use SVG Builder API to programmatically construct and customize SVG documents in a streamlined manner.
• Load SVG or SVGZ from File or URL: Load existing SVG and SVGZ files using SVGDocument class.
• Read SVG with Resources Async: Asynchronously load SVG with external resources using the OnReadyStateChange event handler.

SVG Document Editing and Modification

• Add Elements to SVG: Insert new SVG elements using CreateElementNS() method and InsertBefore() to append nodes.
• Add Basic Shapes to SVG: Add geometric shapes like circles and rectangles.
• Edit Existing Elements: Modify elements in the DOM using SetAttribute(), GetAttribute(), and other methods.
• SVG Drawing on Bitmap: Draw and modify an SVG directly on a bitmap image using the rendering engine.
• Edit SVG Path: Update and customize path elements using the path API.

SVG Document Navigation and Inspection

• Navigation using DOM: Traverse and inspect SVG elements using DOM methods like DocumentElement, GetElementsByTagName(), and more.
• Inspect Specific Elements: Extract detailed information about individual elements within an SVG using DOM properties.
• Use CSS Selector for Editing: Modify and style SVG elements using CSS Selectors within the API.
• XPath Query Navigation: Use XPath queries to navigate through nodes in the SVG document.

SVG Conversion and Rendering

• Convert SVG to PDF: Use the ConvertSVG() method to export SVG to PDF.
• Convert SVG to XPS: Use ConvertSVG() method to convert SVG into XPS format.
• Convert SVG to SVGZ and vice versa: Use the SVGSaveFormat enumeration of Aspose.Svg.Saving namespace specifies the format in which the document is saved, and you can select an SVG or SVGZ format.
• Convert SVG to Image Formats: Export SVG documents to image formats like PNG, JPG, BMP, TIFF, and GIF.
• Rendering Options: Set rendering options such as background color, resolution, protection, and page size using ImageRenderingOptions, PdfRenderingOptions, and XpsRenderingOptions.

Image Vectorization and SVG Optimization

• Image Vectorization: Convert raster images like PNG, JPG, GIF, TIFF, ICO, and BMP into scalable vector graphics using the ImageVectorizer class.
• Image Stencil: Create stenciling effects from images using the process of image vectorization.
• Text Vectorization: Convert text within SVG into vectorized paths to protect against modifications and ensure high-quality rendering.
• SVG Optimization: Reduce the file size and clean up the SVG by removing unnecessary elements and attributes.

Environment Configuration

• Custom Configuration: Create and apply custom configuration settings for runtime services, web requests, and more.
• Logging and Message Handlers: Set up logging of network requests and errors using LogMessageHandler.

Advanced SVG Features

• Merge Multiple SVGs: Combine multiple SVG documents into a single file using the Render() method.
• Apply SVG Transformations: Perform transformations like rotation, scaling, and skewing on SVG elements.
• SVG Filters: Apply SVG filters like Gaussian blur, drop shadow, and color saturation through code.
• SVG Gradients: Create and apply gradients (linear, radial) within SVG files.
• SVG Text and Fonts: Manipulate text using SVG-specific tags like <text>, <tspan>, and apply glyphs and fonts.

SVG Builder API

• SVGElementBuilder: Create new SVG elements through a fluent API.
• Path Builder: Customize SVG paths programmatically for accurate rendering.
• Paint Builder: Apply stroke and fill attributes to SVG elements efficiently.

Supported File Formats

System Requirements

To build and manipulate SVG documents, the machine running Aspose.SVG for .NET does not require modeling and rendering software installed. Aspose.SVG for .NET includes a document generation engine.

Steps to Install Aspose.SVG for .NET through NuGet

1. Open Visual Studio Project

• Open your solution or project in Visual Studio.

2. Install NuGet Package Manager (if needed)

• Go to Tools > Extension Manager.
• Search for "NuGet Package Manager" in the Online Gallery.
• Download and install it.
• Restart Visual Studio.

3. Install Aspose.SVG using Package Manager Console

• Open Tools > Library Package Manager > Package Manager Console.
• Type Install-Package Aspose.SVG for the latest version or Install-Package Aspose.SVG -prerelease for the latest release with hotfixes.
• Press Enter.

4. Update Aspose.SVG via Package Manager Console

• Open the Package Manager Console again.
• Type Update-Package Aspose.SVG to update to the latest release, or use -prerelease for hotfixes.

5. Install/Update Using GUI

• Go to Tools > Library Package Manager > Manage NuGet Packages or right-click the project name in Solution Explorer.
• Search for Aspose.SVG in the online package search.
• Click Install/Update next to the latest version of Aspose.SVG for .NET.

Create SVG from Scratch Using SVG Builder

Aspose.SVG SVG Builder API employs the Fluent Builder Pattern, a design methodology that aligns perfectly with the need for simplicity, clarity, and versatility in SVG manipulation. The following example is a concise and elegant approach to creating SVG from scratch:

// Create an <svg> element with specified width, height and viewBox, and add into it other required elements
SVGSVGElement svg = new SVGSVGElementBuilder()
    .Width(700).Height(300)
    .ViewBox(0, 0, 700, 300)

    .AddG(g => g
    .AddCircle(circle => circle.Cx(130).Cy(130).R(60).Fill(Paint.None).Stroke(Color.FromArgb(200, 0, 0)).StrokeWidth(70).StrokeDashArray(2, 14))
    .AddText("I can create SVG from scratch!", x: 270, y: 140, fontSize: 30, fill: Color.Teal)
    )
    .Build(document.FirstChild as SVGSVGElement);

// Save the document
document.Save(Path.Combine(OutputDir, "svg-from-scratch.svg"));

Source – Element Builders – Create and Edit SVG Elements

Convert SVG to PNG

Quickly convert SVG files to PNG images using the Aspose.SVG for .NET library. A simple solution for rendering high-quality PNGs from SVG documents:

// Initialize an SVG document from a file
using (SVGDocument document = new SVGDocument("image.svg"))
{
    // Initialize ImageSaveOptions 
    ImageSaveOptions saveOptions = new ImageSaveOptions();

    // Convert SVG to PNG
    Converter.ConvertSVG(document, saveOptions, "image.png");
}

Source – Convert SVG to Images

Merge Multiple SVG Documents into a Single PDF

Combine multiple SVG files into a single PDF with the Aspose.SVG for .NET API. The Render() method allows you to send several documents at once to the output rendering device and merge them:

// Load multiple SVG documents from files
using (SVGDocument document1 = new SVGDocument(Path.Combine(DataDir, "circle.svg")))
using (SVGDocument document2 = new SVGDocument(Path.Combine(DataDir, "flower.svg")))
using (SVGDocument document3 = new SVGDocument(Path.Combine(DataDir, "lineto.svg")))
{
    // Initialize the SvgRenderer for rendering multiple SVGs
    using (SvgRenderer renderer = new SvgRenderer())
    {
        // Create a PdfDevice to save the output as a PDF
        using (PdfDevice device = new PdfDevice(Path.Combine(OutputDir, "result.pdf")))
        {
            // Render and merge all SVG documents into a single PDF
            renderer.Render(device, document1, document2, document3);
        }
    }
}

Source – How to Merge SVG Files

Rotate SVG Element Using SVG Builder

You can perform SVG transformations such as rotation, scaling, and translation on individual elements or the entire SVG document. The following C# code snippet demonstrates how to find the desired SVG element (the first <rect>) in an existing SVG file and rotate it around its center.

// Load an SVG document
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "shapes.svg")))
{
    // Find the first <rect> element for rotation
    SVGRectElement rect = document.GetElementsByTagName("rect").First() as SVGRectElement;

    // Rotate the first <rect> element around its center using the SVGRectElementBuilder
    new SVGRectElementBuilder()
        .Transform(t => t.Rotate(45, 100, 140))
        .Build(rect);

    // Save the document
    document.Save(Path.Combine(OutputDir, "rotate-element-using-builder.svg"));
}

Source – Rotate SVG

Vectorize Image – Convert Raster Image to Vector Graphic

Implement the image vectorization process and work with various pre-processing options for images before saving them in vector format:

// Initialize an instance of the ImageVectorizer class
ImageVectorizer vectorizer = new ImageVectorizer
{
    // Optionally set configuration
    Configuration =
    {
        // Optionally set path builder
        PathBuilder = new BezierPathBuilder {

        // Optionally set trace smoother
        TraceSmoother = new ImageTraceSmoother(2),
        },
        ColorsLimit = 10,
        LineWidth = 1
    }
};
// Vectorize image from the specified file
using SVGDocument document = vectorizer.Vectorize("flower.png");

// Save the vectorized image as an SVG file
document.Save("flower.svg");

Source – Image Vectorization

Tags

SVG Creation | SVG Conversion | SVG Manipulation | Vector Graphics | Image Vectorization | Text Vectorization | SVG Optimization | SVG to PDF | SVG to PNG | Image Conversion | Rendering Options | Custom Configuration | CSS Selector | XPath Navigation | SVG Filters | SVG Gradients | SVG Transformations | Advanced SVG Features | SVG to XPS | Document Merging | SVG Builder API | High-Quality Rendering | Bitmap Rendering | Path Builder | PDF Export | SVG Document Navigation | Logging and Message Handlers | Image Formats