Image Vectorization – Vectorize an image with Cloud SDK

Image Vectorization

Aspose.HTML Cloud supports the vectorization of the following image formats: PNG, JPEG, BMP, TIFF, and GIF. By using our image vectorization API, you can convert your raster images into scalable vector graphics, preserving their quality and making them suitable for high-resolution displays and prints. Whether you’re working with photos, logos, or illustrations, our API ensures precise and efficient vectorization, integrating seamlessly into your workflow.

Image Vectorization is the process of converting raster images, composed of pixels, into vector graphics, composed of paths defined by mathematical equations. This conversion enables images to be scaled infinitely without losing quality, making them ideal for various applications such as graphic design, printing, and digital artwork.

The article explains how to vectorize images using our API and client SDKs in a set of code examples. SDKs are available in PHP, C++, Python, C#, Ruby, Java, Android, Swift, and Node.js. We will consider various scenarios of how to vectorize an image:

Vectorizing a local raster image file and saving the result in your local file system. In this scenario, we will explore both image vectorizations with default parameters and with explicitly specified parameters.
Vectorizing raster images in cloud storage with default vectorization parameters.

Examples of Image Vectorization

A common use case for our API functions is image processing and vectorization. The API enables you to retrieve a raster image (such as PNG, JPG, JPEG, TIFF, GIF, or BMP) from storage by its name or from a local file on your drive, convert it to a vector format, and save it back to storage or your local drive. The following code examples demonstrate how to vectorize an image using various SDKs and cURL for different scenarios.

Asynchronous vs Synchronous Vectorization

There are two general approaches for vectorizing Image to SVG. The asynchronous approach involves submitting a vectorization request, receiving an operation ID, and then checking the status of the vectorization until it is completed. Once the status is completed, the resulting file can be downloaded using the provided download link. The synchronous approach, on the other hand, processes the vectorization in a single operation. The API waits for the vectorization to complete and directly returns the PDF in the response, eliminating the need to check statuses and perform separate download steps. Both methods support the same conversion options.

Asynchronous Vectorization

The asynchronous vectorization approach allows for the submission of a vectorization request, where the server processes the vectorization in the background. Once the request is submitted, an operation ID is returned, which can be used to check the status of the vectorization. Upon completion, the resulting file can be downloaded using the provided ID and download link. Below is an example of how to initiate an asynchronous conversion request.

Submit vectorization request

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/jpeg-svg" \
3    -d "{'InputPath': 'https://example.com/example.jpeg'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Result:

 1{
 2    "file": null,
 3    "code": 200,
 4    "id": "CN-a902f0ab-6d67-4847-93b3-9d90826f7ead",
 5    "status": "running",
 6    "description": null,
 7    "links": {
 8        "self": "/v4.0/html/conversion/CN-a902f0ab-6d67-4847-93b3-9d90826f7ead",
 9        "download": null
10    }
11}

Checking vectorization Status:

To check the status of the vectorization, use the id returned in the previous response:

1curl -X GET "https://api.aspose.cloud/v4.0/html/conversion/CN-a902f0ab-6d67-4847-93b3-9d90826f7ead" \
2     -H "Content-Type: application/json" \
3     -H "Authorization:Bearer <JWT_token>"

Result:

 1{
 2    "file": "76482e8b-8d2e-465b-8407-5c7f6e93e614/example.svg",
 3    "code": 200,
 4    "id": "CN-a902f0ab-6d67-4847-93b3-9d90826f7ead",
 5    "status": "completed",
 6    "links": {
 7        "self": "/v4.0/html/conversion/CN-a902f0ab-6d67-4847-93b3-9d90826f7ead",
 8        "download": "v4.0/html/file?path=76482e8b-8d2e-465b-8407-5c7f6e93e614/example.svg"
 9    }
10}

Possible Statuses:

•	completed
•	pending
•	running
•	faulted
•	canceled

Downloading the Vectorization Result:

If the status is completed, the result can be downloaded using the id:

1curl -X GET "https://api.aspose.cloud/v4.0/html/conversion/CN-662a4f3f-44a3-43ed-8c23-5c7b2a052c02/download" \
2     -H "Authorization:Bearer <JWT_token>"

The REST API will return the file as a response. This response will include the Content-Type set as application/octet-stream and the file will be sent as a binary stream for download. This is equivalent to:

1Content-Type: application/octet-stream
2Content-Disposition: attachment; filename="example.svg"

Synchronous Vectorization

For smaller files, synchronous vectorization can be used to eliminate the need to check statuses and download the result in separate calls. The entire process is handled within one call:

1curl -X POST "https://api.aspose.cloud/v4.0/html/conversion/jpeg-svg/sync" \
2     -H "Content-Type: application/json" \
3     -H "Authorization:Bearer <JWT_token>" \
4     -d '{"InputPath": "https://example.com/example.jpeg"}'

Result:

1Content-Type: application/octet-stream
2Content-Disposition: attachment; filename="example.svg"

Vectorize an Image with Default Save Options

Here’s an example of vectorizing a local raster image file and saving the result to the local file system using default vectorization options.

The following example demonstrates the simplest way to convert PNG to SVG using C#. You can download the C# SDK from the GitHub repository.

1// Initialize SDK API
2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").VectorizationApi;
3
4// Convert PNG to SVG
5var result = await api.VectorizeAsync("input.png", "output.svg");

Java

The following example demonstrates how to convert PNG to SVG using Java. You can download the java SDK from the GitHub repository.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.png")
 8                .saveToLocal("output.svg");
 9
10OperationResult result = api.convert(builder);

C++

The following example demonstrates how to convert PNG to SVG C++ language applying. Local SVG converted to PDF and saved to the local path.

 1// Get current directory
 2std::string cur_dir(argv[0]);
 3int pos = cur_dir.find_last_of("/\\");
 4cur_dir = cur_dir.substr(0, pos + 1); // Include the last slash
 5std::wstring w_cur_dir(cur_dir.begin(), cur_dir.end());
 6
 7const utility::string_t clientId = L"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
 8const utility::string_t clientSecret = L"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
 9const utility::string_t basePath = L"https://api.aspose.cloud/v4.0";
10const utility::string_t authPath = L"https://api.aspose.cloud/connect/token";
11
12// Create configuration for authorization
13std::shared_ptr<ApiConfiguration> apiConfig(new ApiConfiguration(clientId, clientSecret, basePath, authPath));
14
15// Create client from configuration
16std::shared_ptr<ApiClient> apiClient(new ApiClient(apiConfig));
17
18// Create ConversionApi
19std::shared_ptr<ConversionApi> api = std::make_shared<ConversionApi>(apiClient);
20
21// File name for conversion
22utility::string_t src = w_cur_dir + L"input.png";
23utility::string_t dst = w_cur_dir + L"result.pdf";
24
25// Conversion
26auto result = api->convertLocalToLocal(src, dst);
27
28// Check the result file
29auto re = result->getFile();
30std::ifstream f(re.c_str());
31if(!f.good())
32{
33    throw std::runtime_error("Conversion failed");
34}

Python

The following example demonstrates how to convert PNG to SVG Python language applying. You can download the Python SDK from the GitHub repository.

 1from asposehtmlcloud.configuration import Configuration
 2from asposehtmlcloud.api.html_api import HtmlApi
 3from asposehtmlcloud.api_client import ApiClient as Client
 4from asposehtmlcloud.rest import ApiException
 5
 6configuration = Configuration(apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 7                              appSid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 8                              basePath="https://api.aspose.cloud/v4.0",
 9                              authPath="https://api.aspose.cloud/connect/token",
10                              debug=True)
11client = Client(configuration)
12html_api = HtmlApi(client)
13
14try:
15    res = html_api.VectorizationApi.convert_local_to_local(input_file="input.png", output_file="output.svg")
16except ApiException as ex:
17    print("Exception")
18    print("Info: " + str(ex))
19    raise ex

PHP

The following example demonstrates how to convert PNG to SVG using PHP. You can download the PHP SDK from the GitHub repository

 1<?php
 2require_once(__DIR__ . '/vendor/autoload.php');
 3
 4$conf = array(
 5	"basePath" => "https://api.aspose.cloud/v4.0",
 6	"authPath" => "https://api.aspose.cloud/connect/token",
 7	"apiKey" => "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 8	"appSID" => "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
 9	"defaultUserAgent" => "Webkit"
10);
11
12$api_html = new Client\Invoker\Api\HtmlApi($conf);
13
14$src = 'input.png';
15$dst = 'output.svg';
16
17try {
18    // Request to server Api
19    $result = $api_html->convertLocalToLocal($src, $dst);
20    print_r($result);
21} catch (Exception $e) {
22    echo 'Exception when calling HtmlApi->convertLocalToLocal: ', $e->getMessage(), PHP_EOL;
23}
24
25?>

Ruby

The following example demonstrates how to convert PNG to SVG Ruby language applying. You can download the Ruby SDK from the GitHub repository.

 1# load the gem
 2require 'aspose_html_cloud'
 3
 4# Get keys from aspose site.
 5# There is free quota available.
 6# For more details, see https://purchase.aspose.cloud/pricing
 7
 8CONFIG = {
 9    "basePath":"https://api.aspose.cloud/v4.0",
10    "authPath":"https://api.aspose.cloud/connect/token",
11    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
12    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
13    "debug":true
14}
15
16api_instance = AsposeHtml::HtmlApi.new CONFIG
17
18src = "input.png'" # String | Full path to the input file.
19dst = "output.svg" # String | Full path to the result.
20
21begin
22  #Convert the document from the local file and save result to the local file.
23  result = api_instance.convert_local_to_local(src, dst)
24  p result
25rescue AsposeHtml::ApiError => e
26  puts "Exception when calling api_instance.convert_local_to_local: #{e}"
27end

Node.js

The following example demonstrates how to convert PNG to SVG Node.js language applying. Local SVG converted to PDF and saved to the local path.

 1// Get keys from aspose site.
 2// There is free quota available.
 3// For more details, see https://purchase.aspose.cloud/pricing
 4
 5var conf = {
 6    "basePath":"https://api.aspose.cloud/v4.0",
 7    "authPath":"https://api.aspose.cloud/connect/token",
 8    "apiKey":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
 9    "appSID":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
10    "defaultUserAgent":"NodeJsWebkit"
11};
12
13var api = require('@asposecloud/aspose-html-cloud');
14
15// Create Conversion Api object
16var conversionApi = new api.ConversionApi(conf);
17
18var src = "/path/to/src/input.png"; // {String} Source document.
19var dst = "/path/to/dst/output.svg"; // {String} Result document.
20var opts = null;
21
22var callback = function(error, data, response) {
23  if (error) {
24    console.error(error);
25  } else {
26    console.log(data);
27  }
28};
29
30conversionApi.convertLocalToLocal(src, dst, opts, callback);

Swift

The following example demonstrates how to convert PNG to SVG Swift language applying. You can download the Swift SDK from the GitHub repository.

 1import Alamofire
 2import Foundation
 3import XCTest
 4import AsposeHtmlCloud
 5
 6static let fm = FileManager.default
 7let resourceDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/Resources")
 8let resultDir = fm.homeDirectoryForCurrentUser.appendingPathComponent("Documents/Aspose.HTML.Cloud.SDK.Swift/Tests/AsposeHtmlCloudTests/TestResult")
 9
10func url(forResource fileName: String) -> URL {
11	return resourceDir.appendingPathComponent(fileName)
12}
13
14func fileExist(name: String) -> Bool {
15	return FileManager.default.fileExists(atPath: name)
16}
17
18ClientAPI.setConfig(
19	basePath: "https://api.aspose.cloud/v4.0",
20	authPath: "https://api.aspose.cloud/connect/token",
21	apiKey: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
22	appSID: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
23	debugging: true
24)
25
26let fileName = "input.png"
27let src = url(forResource: fileName).absoluteString
28
29let expectation = self.expectation(description: "testConvert to svg")
30let dst = resultDir.appendingPathComponent("Output.svg").absoluteString
31HtmlAPI.convertLocalToLocal(src: src, dst: dst, options: nil) { (data, error) in
32
33	guard error == nil else {
34		XCTFail("Error convert PNG to SVG). Error=\(error!.localizedDescription)")
35		return
36	}
37	let resultPath = data!.file!
38	XCTAssertTrue(fileExist(name: resultPath))
39	expectation.fulfill()
40}
41self.waitForExpectations(timeout: 100.0, handler: nil)

Java/Android

The following example demonstrates how to convert PNG to SVG using Java/Android. You can download the Java/Android SDK from the GitHub repository.

 1Configuration.setBasePath("https://api.aspose.cloud");
 2Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
 3
 4HtmlApi api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET");
 5
 6JobBuilder builder = new ConverterBuilder()
 7                .fromLocalFile("input.png")
 8                .saveToLocal("output.svg");
 9
10OperationResult result = api.convert(builder);

CURL

The following example demonstrates how to convert PNG to SVG using REST API. Follow a few required steps:

Upload a local file to storage using Storage API.
Call REST API to execute conversion (in the example below).
Download conversion result back from storage using Storage API.

1curl -X POST -v \
2	"https://api.aspose.cloud/v4.0/html/conversion/png-svg" \
3    -d "{'InputPath': '/test.png', 'OutputFile': 'output.svg'}" \
4    -H "Content-Type: application/json" \
5    -H "Authorization:Bearer <JWT_token>"

Vectorization Options

Our API provides several options to fine-tune the vectorization process. Below is a description of the available vectorization options:

ErrorThreshold: The acceptable error threshold for the vectorization process. This value controls the accuracy of the vectorization. A lower value results in higher accuracy but may require more processing time. Default value is 30.
MaxIterations: The maximum number of iterations allowed during the vectorization process. This setting limits the processing time and complexity. Default value is 30.
ColorLimit: The maximum number of colors allowed in the vectorized output. This option helps control the complexity and size of the resulting vector file. Default value is 25.
LineWidth: The width of the lines in the resulting vector image. This setting controls the visual appearance of the vectorized output. Default value is 1.

Convert PNG to SVG – Vectorize PNG in C#

Here is a C# example of how to use these options to vectorize PNG and save the result as an SVG file:

 1// Initialize SDK API
 2var api = new HtmlApi("CLIENT_ID", "CLIENT_SECRET").VectorizationApi;
 3var options = new VectorizationOptions
 4            {
 5                ErrorThreshold = 30,
 6                MaxIterations = 30,
 7                ColorLimit = 25,
 8                LineWidth = 1
 9            };
10
11// Convert PNG to SVG
12var result = await api.VectorizeAsync("input.png", "output.svg", options);

This example demonstrates how to initialize the API with client credentials, set the vectorization options, and convert PNG to SVG using the specified options.

Vectorize PNG with Vectorization Options – cURL Example

Below is an example of how to use cURL to vectorize an image with specified options:

 1curl -X POST -v \
 2    "https://api.aspose.cloud/v4.0/html/conversion/png-svg" \
 3    -d '{
 4          "InputPath": "/input.png",
 5          "OutputFile": "output.svg",
 6          "Options": {
 7              "error_threshold": 30,
 8              "max_iterations": 30,
 9              "colors_limit": 25,
10              "line_width": 1
11          }
12        }' \
13    -H "Content-Type: application/json" \
14    -H "Authorization: Bearer <JWT_token>"

Image Vectorization – Vectorize an image with Cloud SDK

Image Vectorization

Examples of Image Vectorization

Asynchronous vs Synchronous Vectorization

Asynchronous Vectorization

Submit vectorization request

Checking vectorization Status:

Possible Statuses:

Downloading the Vectorization Result:

Synchronous Vectorization

Vectorize an Image with Default Save Options

Vectorization Options

Convert PNG to SVG – Vectorize PNG in C#

Vectorize PNG with Vectorization Options – cURL Example

See Also