Convert SVG to JPG in C#

To convert SVG to JPG in C#, load the SVG document or open the SVG file as a stream, create ImageSaveOptions with ImageFormat.Jpeg, and call Converter.ConvertSVG() with the source, options, and output path or stream provider.

JPG is a compact raster image format commonly used for previews, thumbnails, and shareable image snapshots. SVG to JPG conversion is useful when vector graphics must be rendered as broadly supported image files and transparency is not required.

Before running the examples, install and configure Aspose.HTML for .NET in your project. The complete C# example project is available in the Aspose.HTML for .NET GitHub repository.

Convert SVG to JPG with One Line of C#

The static Converter class provides a compact way to render SVG content to JPG. The example below converts SVG to JPG with ImageSaveOptions configured for JPEG output.

// Convert SVG to JPG using C#

// Invoke the ConvertSVG() method for SVG to JPG conversion
Converter.ConvertSVG(Path.Combine(DataDir, "shapes.svg"), new ImageSaveOptions(ImageFormat.Jpeg), Path.Combine(OutputDir, "convert-with-single-line.jpg"));

Convert an SVG File to JPG in C#

Use this workflow when the SVG source exists on disk and the JPG should be saved to a file path.

The workflow is:

1. Prepare the SVG source file or load it as an SVGDocument.
2. Create an ImageSaveOptions instance with ImageFormat.Jpeg. The default Format value is PNG, so the format must be set for JPG output.
3. Call Converter.ConvertSVG(source, options, savePath).
4. Save the generated JPG file to the target output path.

// Convert SVG to JPG in C#

// Prepare SVG code
string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
              "<circle cx ='100' cy ='100' r ='55' fill='green' stroke='red' stroke-width='10' />" +
              "</svg>";

// Prepare a path for converted file saving
string savePath = Path.Combine(OutputDir, "circle.jpg");

// Create an instance of the ImageSaveOptions class
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg);

// Convert SVG to JPG
Converter.ConvertSVG(code, ".", options, savePath);

When to Use SVG to JPG Conversion

Use JPG output when you need compact previews, thumbnails, or image snapshots and file size matters more than transparency or lossless edges. JPG is usually not the best choice for SVG icons, diagrams, UI graphics, or transparent artwork. For crisp lossless rendering, use SVG to PNG. If the output must remain a document, use SVG to PDF.

Customize SVG to JPG with ImageSaveOptions

Use ImageSaveOptions when the generated JPG needs custom rendering settings. To customize SVG to JPG conversion:

1. Load the SVG source.
2. Create ImageSaveOptions with ImageFormat.Jpeg.
3. Configure only the settings required by the output, such as PageSetup, BackgroundColor, resolution, or UseAntialiasing.
4. Pass the SVG source, options, and output path to Converter.ConvertSVG().

Option	Use it to control
Format	The output image format. The default value is PNG; use ImageFormat.Jpeg for JPG output.
BackgroundColor	The color used to fill the image background. The default value is transparent.
PageSetup	Page size, margins, and page layout settings.
HorizontalResolution and VerticalResolution	Output resolution values used by the rendering process. The default value is 300 dpi for each property.
UseAntialiasing	Image rendering quality. Antialiasing is enabled by default.
Text	Text rendering configuration through TextOptions.

// Convert SVG to JPG in C# with custom background, resolution, and antialiasing settings

// Prepare a path to a source SVG file
string documentPath = Path.Combine(DataDir, "flower.svg");

// Prepare a path for converted file saving
string savePath = Path.Combine(OutputDir, "flower-options.jpg");

// Initialize an SVG document from the file
using SVGDocument document = new SVGDocument(documentPath);

// Create an instance of the ImageSaveOptions class. Set up the resolutions, SmoothingMode and change the background color to AliceBlue
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Jpeg)
{
    UseAntialiasing = true,
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue
};

// Convert SVG to JPG
Converter.ConvertSVG(document, options, savePath);

Related Image Workflows

• Resize HTML Output in C# – Set Page Size and Scale Content
• Set Font Folder to Render HTML
• Fine-Tuning Converters
• Rendering Options

Save SVG to JPG with an Output Stream Provider

Use ICreateStreamProvider when the conversion output should be written through streams instead of only to a file path. This is useful for memory-based workflows, remote storage, databases, and services that decide where rendered image output is stored.

// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (MemoryStream stream in Streams)
            stream.Dispose();
    }
}

The following example converts SVG to JPG with MemoryStreamProvider.

// Convert SVG to JPG in C# using memory stream

// Create an instance of MemoryStreamProvider
using MemoryStreamProvider streamProvider = new MemoryStreamProvider();

// Prepare SVG code
string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
              "<circle cx='50' cy='50' r='40' stroke='black' stroke-width='3' fill='red' />" +
              "</svg>";

// Convert SVG to JPG using the MemoryStreamProvider
Converter.ConvertSVG(code, ".", new ImageSaveOptions(ImageFormat.Jpeg), streamProvider);

// Get access to the memory stream that contains the result data
MemoryStream memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.jpg")))
{
    memory.CopyTo(fs);
}

Related SVG Conversion Guides

• Convert SVG to PDF – render SVG as a PDF document.
• Convert SVG to PNG – render SVG as lossless raster output.
• Convert SVG to BMP – render SVG as bitmap output.
• Convert SVG to TIFF – render SVG as TIFF output.

Other Platforms

• Convert SVG to JPG in Java
• Convert SVG to JPG in Python via .NET

Try Online SVG to JPG Conversion

Use the online SVG to JPG Converter for quick manual conversion. Use Aspose.HTML for .NET when SVG to JPG conversion must run inside a C# application, service, or document pipeline.

FAQ

Can I convert SVG to JPG for free?

You can evaluate Aspose.HTML for .NET before purchasing a license, but converted documents created in evaluation mode contain watermarks and are limited to four pages. For unrestricted testing, request a free 30-day Temporary License. For occasional manual conversions, use the free online SVG to JPG Converter.

See Licensing Aspose.HTML for .NET for evaluation limitations and license setup.

What happens to transparent SVG areas in JPG output?

JPG does not support transparency. Set ImageSaveOptions.BackgroundColor explicitly so transparent areas are filled with the intended color instead of relying on a default background. Use PNG when the output must retain transparency.