Векторизация изображений – Aspose.HTML Cloud

В этой статье объясняется, как векторизовать растровые изображения с помощью API Aspose.HTML Cloud из URL-источников в синхронном и асинхронном режимах. Поддерживаемые форматы изображений для векторизации включают PNG, JPEG, JPG, BMP, GIF и WEBP. Векторизованные файлы всегда создаются в формате SVG.

Перед началом убедитесь, что вы получили токен авторизации. Обратитесь к Руководству по авторизации для получения подробной информации.

Методы векторизации

Aspose.HTML Cloud предоставляет два метода векторизации:

Синхронная векторизация: Идеально подходит для небольших изображений; результат напрямую возвращается в ответе.
Асинхронная векторизация: Лучше подходит для больших изображений; задача выполняется в фоновом режиме, а результат загружается по завершении.

1. Синхронная векторизация

Endpoint: POST https://api.aspose.cloud/v4.0/html/vectorization/png/sync

Авторизация: Bearer токен

Тело запроса:

1{
2    "InputPath": "https://example.com/image.png",
3    "Options": {
4        "ErrorThreshold": 30,
5        "MaxIterations": 100,
6        "ColorLimit": 16,
7        "LineWidth": 1.5
8    }
9}

Ответ: API напрямую возвращает векторизованный файл SVG.

 1using System;
 2using System.IO;
 3using System.Net.Http;
 4using System.Net.Http.Headers;
 5using System.Text;
 6using System.Threading.Tasks;
 7
 8public async Task VectorizeImageSync()
 9{
10    using (HttpClient client = new HttpClient())
11    {
12        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_ACCESS_TOKEN");
13        var requestBody = new StringContent(
14            "{\"InputPath\": \"https://example.com/image.png\", \"Options\": {\"ErrorThreshold\": 30, \"MaxIterations\": 100, \"ColorLimit\": 16, \"LineWidth\": 1.5}}",
15            Encoding.UTF8, "application/json");
16        var response = await client.PostAsync("https://api.aspose.cloud/v4.0/html/vectorization/png/sync", requestBody);
17        var fileStream = await response.Content.ReadAsStreamAsync();
18        using (FileStream fs = new FileStream("output.svg", FileMode.Create))
19        {
20            await fileStream.CopyToAsync(fs);
21        }
22    }
23}

JavaScript

 1async function vectorizeImageSync() {
 2    const url = "https://api.aspose.cloud/v4.0/html/vectorization/png/sync";
 3    const requestBody = JSON.stringify({
 4        InputPath: "https://example.com/image.png",
 5        Options: { ErrorThreshold: 30, MaxIterations: 100, ColorLimit: 16, LineWidth: 1.5 }
 6    });
 7    const response = await fetch(url, {
 8        method: 'POST',
 9        headers: {
10            'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
11            'Content-Type': 'application/json'
12        },
13        body: requestBody
14    });
15    const blob = await response.blob();
16    const a = document.createElement('a');
17    a.href = URL.createObjectURL(blob);
18    a.download = 'output.svg';
19    a.click();
20}

2. Асинхронная векторизация

Шаги:

Отправить запрос на векторизацию
Проверить статус векторизации
Загрузить векторизованный файл

1// Отправить запрос на векторизацию
2var requestBody = new StringContent(
3    "{\"InputPath\": \"https://example.com/image.png\", \"OutputFile\": \"vectorized.svg\", \"Options\": {\"ErrorThreshold\": 30}}",
4    Encoding.UTF8, "application/json");
5
6// Используйте аналогичную логику, как показано в синхронном примере, для отправки запроса, проверки статуса и загрузки файла.

JavaScript

1// Отправить запрос на векторизацию, проверить статус и загрузить векторизованный SVG
2// Аналогичная логика, как показано в синхронном примере

Объяснение параметров векторизации

Параметр	Описание
ErrorThreshold	Определяет допустимый уровень ошибки для точности векторизации (меньшее значение = более высокая точность).
MaxIterations	Устанавливает максимальное количество итераций, которые алгоритм выполняет во время векторизации (больше = потенциально более высокая точность, но более медленная обработка).
ColorLimit	Ограничивает количество цветов, используемых в результирующем векторном изображении.
LineWidth	Определяет ширину линий в векторизованном выводе.

Смотрите также

API Векторизации Векторизация из Base64