Convert Image to SVG in C# – Vectorize Raster Images

Quick Answer

To convert an image to SVG in C#, create an ImageVectorizerConfiguration object and call Converter.ConvertImageToSVG(). Aspose.SVG for .NET supports raster inputs such as PNG, JPG, BMP, TIFF, GIF, and ICO and saves the traced vector result as an SVG file.

Vectorization is the process of converting raster images into vector graphics, which use Bezier curves, splines, and lines instead of pixels. The process includes color quantization, boundary detection, shape approximation, and path-quality improvements such as smoothing or simplification. The result is saved as a vector format, such as SVG.

Aspose.SVG for .NET provides two image vectorization workflows: the Converter.ConvertImageToSVG() facade for direct image-to-file conversion, and the ImageVectorization API when your code needs to work with the generated SVGDocument.

This article focuses on direct image-to-SVG conversion with Converter.ConvertImageToSVG(). For the full algorithm workflow and ImageVectorizer.Vectorize() examples, see Image and Text Vectorization and Image Vectorization Workflow.

When Image to SVG Conversion Works Best

Image vectorization works best when the source image contains clear shapes, limited colors, and visible boundaries. It is less suitable for full-color photos where preserving every detail would create a very complex SVG.

Source image type	Recommendation
Logos, icons, symbols, clip art	Good fit for image to SVG conversion. These images usually contain clean shapes and limited colors.
Diagrams, maps, line art, technical drawings	Good fit when lines and regions are clear enough to trace.
Scanned drawings	Useful after preprocessing, such as cleaning noise and improving contrast.
Photographs	Usually not ideal for compact SVG. Vectorization may produce many paths and a large output file.
Low-resolution or noisy images	Improve the source image first, or adjust smoothing and simplification options.

Convert Image to SVG

Use Converter.ConvertImageToSVG() when you want to convert an image file or stream directly to an SVG file. Use ImageVectorizer.Vectorize() when your code needs the vectorized result as an SVGDocument before saving, editing, or inspecting it. This article focuses on the direct conversion workflow.

The following example demonstrates how to convert a raster PNG image to SVG using the ConvertImageToSVG() method:

• The conversion process begins with the creation of an ImageVectorizerConfiguration object. This configuration controls how vectorization works, including the number of colors to retain, the level of smoothing applied, methods used to trace outlines and other settings.
• The ConvertImageToSVG(configuration, imageFile, outputFile) method vectorizes the input image, converting it into a scalable SVG format and saving it to the specified output path.

Add the following namespaces:

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Converters;
using Aspose.Svg.ImageVectorization;

C# code for image to SVG conversion:

// Convert a raster image to SVG in C# using ConvertImageToSVG()

// Prepare paths for a source image file and output SVG file
string imageFile = Path.Combine(DataDir, "flower-pink.png");
string outputFile = Path.Combine(OutputDir, "flower-pink.svg");

// Create a configuration object
ImageVectorizerConfiguration configuration = new ImageVectorizerConfiguration
{
    PathBuilder =
                new BezierPathBuilder
                {
                    TraceSmoother = new ImageTraceSmoother(3),
                    ErrorThreshold = 5,
                    MaxIterations = 5
                },
    ColorsLimit = 15,
    LineWidth = 2
};

// Convert Image to SVG
Converter.ConvertImageToSVG(configuration, imageFile, outputFile);

The figure shows the result of image vectorization: a) original PNG image; b) resulting SVG:

Key Vectorization Options

Use ImageVectorizerConfiguration and path builder settings to balance visual detail, path smoothness, file size, and processing time.

Goal	Option to review	Result
Reduce SVG file size	ColorsLimit, trace simplification	Fewer colors and fewer path points.
Control traced line thickness	LineWidth	Thicker or thinner generated vector strokes.
Smooth jagged edges	TraceSmoother in BezierPathBuilder	Cleaner curves for noisy or low-resolution images.
Preserve more detail	ErrorThreshold, MaxIterations	More accurate paths, but potentially larger SVG output.
Create a stencil-like result	Stencil configuration	Simplified, high-contrast vector output.

Convert Image From Stream to SVG

Aspose.SVG for .NET supports both file-based and stream-based workflows, making it flexible for desktop, web, and service-oriented applications. The following example shows how to apply the ConvertImageToSVG(configuration, inputStream, outputFile) method for JPG to SVG conversion:

// Convert a raster JPG stream to vector SVG in C#

// Prepare input and output
string imagePath = Path.Combine(DataDir, "tulip.jpg");
string outputFile = Path.Combine(OutputDir, "tulip.svg");

// Open the image as a FileStream
using (FileStream inputStream = new FileStream(imagePath, FileMode.Open, FileAccess.Read))
{
    // Create vectorization configuration
    ImageVectorizerConfiguration configuration = new ImageVectorizerConfiguration
    {
        PathBuilder = new BezierPathBuilder
        {
            TraceSmoother = new ImageTraceSmoother(1),
            ErrorThreshold = 10,
            MaxIterations = 1
        },
        ColorsLimit = 30,
        LineWidth = 1
    };

    // Perform conversion from image stream to SVG
    Converter.ConvertImageToSVG(configuration, inputStream, outputFile);
}

Console.WriteLine("Image converted to SVG successfully.");

The figure shows the result of image vectorization: a) original JPG image; b) resulting SVG:

Common Mistakes and Fixes

Problem	Common cause	Fix
Output SVG is very large	The source image has too many colors, noise, or photographic detail	Use simpler source artwork, reduce ColorsLimit, resize the image, or apply trace simplification.
Vector edges look rough	The source image is low-resolution or noisy	Clean the image before conversion and increase smoothing with TraceSmoother.
Colors are too simplified	Color quantization is too aggressive	Increase ColorsLimit or use a cleaner source image with clearer color regions.
Text in the image is not editable SVG text	Image vectorization traces pixels into shapes	Use real SVG text when editable text is required. See SVG Text and Text Vectorization.

FAQ

Can I convert PNG to SVG in C#?
Yes. Use Converter.ConvertImageToSVG() for direct PNG to SVG conversion. For a PNG-focused workflow with ImageVectorizer, see Convert PNG to SVG in C#.

Can I convert an uploaded image stream to SVG?
Yes. Use the stream-based ConvertImageToSVG(configuration, inputStream, outputFile) overload when the input image comes from an upload, memory buffer, or cloud storage.

Should I vectorize photos to SVG?
Usually only when you intentionally want a stylized vector effect. Photos often create large SVG files with many paths, so ordinary raster formats are usually better for photographic content.

Does image to SVG conversion create editable text?
No. Raster image vectorization traces visible pixels into vector shapes. Text inside a source image does not become editable SVG <text> content.

How do I make the generated SVG smaller?
Use a cleaner source image, reduce the number of colors with ColorsLimit, resize very large inputs, and use simplification settings to reduce path complexity.

Related Resources

• Convert PNG to SVG in C# – A focused guide for PNG vectorization.
• Image Vectorization Workflow – Learn how the vectorization process works and how to use ImageVectorizer.
• Image Vectorization Examples – Compare vectorization settings and output quality.
• Image Stencil – Create Stencil Image in C# – Create stencil-style SVG output from raster images.
• Supported File Formats – See input and output format support.
• Convert SVG to Images in C# – Render SVG back to PNG, JPG, WebP, BMP, TIFF, or GIF.

Aspose.SVG offers a Free Online Image to SVG Converter that works on any platform and provides accurate and efficient conversion. Using this application, you can apply a set of options to achieve the perfect result. Save your time and check this free Image to SVG Converter to get all the benefits of vector graphics!