Полный рабочий пример конвертации SVG в PNG в Node.JS

В этом примере демонстрируется, как преобразовать файл SVG, хранящийся в хранилище GroupDocs Cloud, в изображение PNG с использованием GroupDocs.Conversion Cloud SDK for Node.JS.

const { Configuration, ConvertApi, ConvertDocumentRequest, ConvertSettings, PngOptions, StorageApi, DownloadFileRequest } = require("@groupdocs/conversion-cloud");
const fs = require('fs');
const path = require('path');

// -----------------------------------------------------------------------------
// Configuration – replace with your own credentials
// -----------------------------------------------------------------------------
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

const convertApi = new ConvertApi(config);
const storageApi = new StorageApi(config);

// -----------------------------------------------------------------------------
// Define source SVG and target PNG locations inside GroupDocs Cloud storage
// -----------------------------------------------------------------------------
const inputSvgPath = "input/sample.svg";          // SVG stored in cloud storage
const outputPngPath = "output/sample.png";       // Desired PNG location

// -----------------------------------------------------------------------------
// PNG conversion options – set dimensions to control memory/CPU usage
// -----------------------------------------------------------------------------
const pngOptions = new PngOptions({
    width: 1024,               // Resize width (optional)
    height: 768,               // Resize height (optional)
    backgroundColor: "#FFFFFF" // Ensure opaque background
});

// -----------------------------------------------------------------------------
// Build conversion settings object
// -----------------------------------------------------------------------------
const convertSettings = new ConvertSettings({
    filePath: inputSvgPath,
    format: "png",
    outputPath: outputPngPath,
    options: pngOptions
});

const convertRequest = new ConvertDocumentRequest(convertSettings);

// -----------------------------------------------------------------------------
// Execute conversion, then download the PNG locally
// -----------------------------------------------------------------------------
convertApi.convertDocument(convertRequest)
    .then(convResult => {
        console.log("Conversion succeeded. Cloud file:", convResult.path);
        const downloadReq = new DownloadFileRequest({ path: convResult.path });
        return storageApi.downloadFile(downloadReq);
    })
    .then(fileBuffer => {
        const localFile = path.resolve(__dirname, "sample.png");
        fs.writeFileSync(localFile, fileBuffer);
        console.log("PNG downloaded to:", localFile);
    })
    .catch(err => {
        console.error("Error during SVG → PNG conversion:", err);
    })
    .finally(() => {
        // Clean up HTTP client resources if the SDK exposes a close method
        if (config && config.httpClient && typeof config.httpClient.close === "function") {
            config.httpClient.close();
        }
    });

Примечание: Этот пример кода демонстрирует основную функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили пути к файлам (input/sample.svg, output/sample.png и т.д.), чтобы они соответствовали фактическим расположениям, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Преобразование SVG в PNG через REST API с использованием cURL

Если вы предпочитаете чистый REST‑подход, то то же преобразование можно выполнить с помощью команд cURL. Ниже приведены шаги, показывающие, как получить токен доступа, загрузить SVG, запустить преобразование и скачать PNG.

Аутентификация и получение токена доступа

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

Ответ содержит access_token, который вы будете использовать в последующих вызовах.

Загрузите исходный SVG-файл

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input/sample.svg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/local/sample.svg"

Выполнить преобразование SVG в PNG

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "input/sample.svg",
           "format": "png",
           "outputPath": "output/sample.png",
           "options": {
               "width": 1024,
               "height": 768,
               "backgroundColor": "#FFFFFF"
           }
         }'

API возвращает путь к только что созданному PNG‑файлу в облачном хранилище.

Скачать полученный PNG-файл

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

Эти команды cURL предоставляют вам полный контроль над процессом конвертации без написания кода. Для получения дополнительных сведений см. официальную документацию API.

Как работает преобразование SVG в PNG в Node.JS

1. Импорт классов SDK - Оператор require("@groupdocs/conversion-cloud") загружает необходимые классы, такие как ConvertApi, ConvertSettings и PngOptions (Ссылка на API).

const { ConvertApi, ConvertSettings, PngOptions } = require("@groupdocs/conversion-cloud");

2. Настройка аутентификации - Объект Configuration хранит ваш clientId и clientSecret. Этот объект передаётся как в ConvertApi, так и в StorageApi для авторизации всех последующих вызовов.

const config = new Configuration({ clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET" });

3. Определите пути ввода и вывода - inputSvgPath указывает на SVG в облачном хранилище, а outputPngPath задает, где следует сохранить PNG.

const inputSvgPath = "input/sample.svg";
const outputPngPath = "output/sample.png";

4. Установить параметры PNG - PngOptions позволяет управлять размерами и цветом фона, что полезно для больших или прозрачных SVG.

   const pngOptions = new PngOptions({ width: 1024, height: 768, backgroundColor: "#FFFFFF" });
   

5. Создать параметры конвертации и выполнить - ConvertSettings объединяет путь к файлу, целевой формат, место вывода и параметры. Метод convertDocument выполняет конвертацию, а результат содержит облачный путь к PNG.

const convertSettings = new ConvertSettings({ filePath: inputSvgPath, format: "png", outputPath: outputPngPath, options: pngOptions });
const convertRequest = new ConvertDocumentRequest(convertSettings);
convertApi.convertDocument(convertRequest);

6. Download the PNG - После конвертации StorageApi.downloadFile получает двоичные данные, которые вы можете записать в локальную файловую систему.

Понимание каждого шага помогает вам настраивать процесс, обрабатывать ошибки и интегрировать конвертацию в более крупные рабочие процессы.

Установка и настройка GroupDocs.Conversion Cloud SDK for Node.JS

npm install groupdocs-conversion-cloud

SDK требует Node.js 12 или новее. После установки создайте объект конфигурации с вашими clientId и clientSecret (доступными из вашей учетной записи GroupDocs Cloud). См. страница загрузки для получения последней версии пакета.

const { Configuration } = require("@groupdocs/conversion-cloud");
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Убедитесь, что учетные данные имеют разрешение на доступ к службам хранилища и конвертации. После настройки вы можете создать экземпляры ConvertApi и StorageApi, как показано в примере кода.

Тонкая настройка параметров конвертации PNG

Класс PngOptions предлагает несколько свойств, которые вы можете настроить:

• width / height - Определяет разрешение вывода. Более крупные значения повышают качество, но требуют больше памяти.

const pngOptions = new PngOptions({ width: 1920, height: 1080 });

• backgroundColor - Устанавливает сплошной фон для SVG, содержащих прозрачность.

const pngOptions = new PngOptions({ backgroundColor: "#000000" });

• compressionLevel - (Если поддерживается) Выберите уровень сжатия от 0 (без сжатия) до 9 (максимальное сжатие) для уменьшения размера файла.

const pngOptions = new PngOptions({ compressionLevel: 6 });

Эти параметры передаются через свойство options объекта ConvertSettings. Обратитесь к Справка API для полного списка доступных настроек.

Лучшие практики эффективного преобразования SVG в PNG

• Проверка содержимого SVG – Убедитесь, что SVG не содержит внешних скриптов или вредоносных полезных нагрузок перед загрузкой. GroupDocs.Conversion очищает ввод, но предварительная проверка добавляет дополнительный уровень безопасности.
• Повторное использование объекта Configuration – Создайте один экземпляр Configuration и используйте его в нескольких вызовах ConvertApi, чтобы снизить накладные расходы.
• Установите разумные размеры – Ограничьте ширину и высоту до действительно необходимого размера. Слишком большие изображения увеличивают время обработки и потребление памяти.
• Потоковая передача больших файлов – Для очень больших SVG-файлов рассмотрите возможность потоковой загрузки вместо загрузки всего буфера в память.
• Отслеживание использования API – Следите за своей квотой конвертации и корректно обрабатывайте ответы с ограничением скорости.

Заключение

GroupDocs.Conversion Cloud SDK for Node.JS делает серверную конвертацию SVG в PNG простой, масштабируемой и безопасной. Следуя полному примеру кода, эквивалентному cURL‑рабочему процессу и приведённым выше советам по конфигурации, вы сможете интегрировать высокопроизводительное преобразование изображений в любой бэкенд‑сервис. Не забудьте ознакомиться с вариантами лицензирования: для продакшн‑развёртываний требуется платная подписка, а временную лицензию для тестирования можно получить на странице временной лицензии. Начните конвертировать уже сегодня и предоставляйте пользователям чёткие PNG‑активы с уверенностью.

Часто задаваемые вопросы

Как выполнить преобразование SVG в PNG в Node.JS с использованием GroupDocs?
Используйте GroupDocs.Conversion Cloud SDK for Node.JS. Загрузите SVG в облачное хранилище, настройте PngOptions, вызовите convertDocument и загрузите PNG. Полный пример кода в этой статье показывает каждый шаг.

Могу ли я пакетно конвертировать множество SVG‑файлов одновременно?
Да. Пройдитесь по списку путей к SVG‑файлам и вызовите тот же запрос конвертации для каждого файла. SDK обрабатывает каждый запрос независимо, позволяя сохранять все результаты PNG в одну папку вывода.

Что мне делать, если конверсия завершается с ошибкой?
Проверьте сообщение об ошибке, возвращаемое в блоке catch. Распространённые проблемы включают недействительные учётные данные, отсутствующие пути к файлам или неподдерживаемые функции SVG. Обратитесь к официальной документации для получения подробных кодов ошибок и шагов по устранению неполадок.

Где я могу найти дополнительную информацию о параметрах PNG?
Все настраиваемые свойства перечислены в справочнике API для PngOptions. Посетите справочник API, чтобы изучить дополнительные настройки, такие как уровень сжатия и глубина цвета.

Читать дальше

• Пошаговое руководство по конвертации HTML в DOCX в Node.JS
• Пошаговый пример конвертации CSV в PDF в Node.JS
• Конвертация PDF в DOCX в Node.JS

Конвертация CSV в JPG в Node.JS - Полный пример кода

В этом примере демонстрируется, как с помощью асинхронного API библиотеки преобразовать CSV‑файл, хранящийся в хранилище GroupDocs Cloud, в изображения JPG.

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

// Replace with your actual GroupDocs Cloud credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

async function convertCsvToJpg() {
    // Initialize the Conversion API
    const convertApi = new ConvertApi(clientId, clientSecret);

// Source CSV file stored in GroupDocs Cloud storage
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.csv";

// Conversion options: CSV -> JPG
    const convertOptions = new ConvertOptions();
    convertOptions.fileInfo = fileInfo;
    convertOptions.format = "jpg";

// Conversion settings (output folder in storage)
    const convertSettings = new ConvertSettings();
    convertSettings.outputPath = "output_images";
    convertSettings.convertOptions = [convertOptions];

try {
        const result = await convertApi.convertDocument(convertSettings);
        console.log("Conversion completed. Generated files:");
        result.forEach(file => console.log(file.path));
    } catch (err) {
        console.error("Conversion failed:", err);
    }
}

convertCsvToJpg();

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили пути к файлам (input.csv, output_images и т.д.), чтобы они соответствовали фактическим расположениям, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Конвертация CSV в JPG с использованием cURL и REST API

Если вы предпочитаете чистый REST‑подход, то то же преобразование можно выполнить с помощью серии команд cURL.

1. Получить токен доступа - аутентифицируйтесь, используя учетные данные клиента.

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. Загрузите исходный CSV - разместите файл в вашем хранилище GroupDocs Cloud.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/your/input.csv"

3. Запросить конвертацию - укажите целевой формат как JPG.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo":{"filePath":"input.csv"}}'

4. Скачайте сгенерированные изображения - получите файлы из выходной папки.

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output_images/your_image.jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o your_image.jpg

Эти команды демонстрируют полный процесс преобразования CSV‑to‑JPG без написания кода. Для получения дополнительной информации см. официальную документацию API.

Понимание процесса преобразования CSV в JPG в Node.JS

Ниже приведён пошаговый разбор кода, показанного ранее:

1. Инициализировать клиент API - new ConvertApi(clientId, clientSecret) создаёт аутентифицированную сессию.

const convertApi = new ConvertApi(clientId, clientSecret);

2. Определите исходный файл - объект FileInfo указывает на input.csv, хранящийся в GroupDocs Cloud.

const fileInfo = new FileInfo();
fileInfo.filePath = "input.csv";

3. Установить параметры конвертации - ConvertOptions.format = "jpg" сообщает сервису, что нужно вывести JPG.

const convertOptions = new ConvertOptions();
convertOptions.fileInfo = fileInfo;
convertOptions.format = "jpg";

4. Настройте параметры вывода - ConvertSettings.outputPath определяет, где будут сохранены изображения.

   const convertSettings = new ConvertSettings();
   convertSettings.outputPath = "output_images";
   convertSettings.convertOptions = [convertOptions];
   

5. Выполнить конвертацию - convertApi.convertDocument(convertSettings) отправляет запрос и возвращает массив путей к сгенерированным файлам.

   const result = await convertApi.convertDocument(convertSettings);
   

Для полного списка классов и свойств обратитесь к справочнику API.

Требования и настройка

1. Node.js runtime - требуется версия 12 или выше.
2. GroupDocs Cloud account - получите clientId и clientSecret из портала GroupDocs.
3. Установите SDK - выполните следующую команду (скачайте пакет с официальной страницы релизов):

npm install groupdocs-conversion-cloud

4. Импортировать SDK в ваш проект:

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

Для получения более подробной информации об установке см. страницу загрузки.

Настройки конвертации: параметры и опции

SDK предоставляет несколько свойств, которые вы можете настроить:

• Путь вывода - управляет папкой, в которой хранятся файлы JPG.

convertSettings.outputPath = "output_images";

• Целевой формат - измените "jpg" на "jpeg", если вам нужен вариант JPEG.

convertOptions.format = "jpeg";

• Пользовательские размеры - вы можете указать ширину и высоту (если поддерживается), чтобы генерировать изображения точного размера.

convertOptions.width = 800;   // example width in pixels
convertOptions.height = 600;  // example height in pixels

• Асинхронное выполнение - методы SDK возвращают promises, позволяя вам интегрировать конвертацию в асинхронные рабочие процессы без блокировки цикла событий.

await convertApi.convertDocument(convertSettings);

Эти параметры позволяют настроить процесс CSV‑to‑JPG в соответствии с вашими конкретными потребностями в автоматизации или интеграции.

Заключение

Преобразование CSV в JPG в Node.JS простое с помощью GroupDocs.Conversion Cloud SDK for Node.js. Библиотека выполняет большую часть работы в облаке, позволяя вам сосредоточиться на бизнес‑логике и интеграции. Не забудьте защитить свои облачные учетные данные, выбрать подходящий формат вывода (JPG или JPEG) и настроить параметры, такие как размеры или пути вывода, в соответствии с вашим рабочим процессом. Для развертывания в продакшене вам понадобится платная лицензия; вы можете изучить детали ценообразования и получить временную лицензию на странице страница временной лицензии. С предоставленными примерами кода и cURL вы готовы добавить автоматизацию преобразования CSV‑в‑JPG в любой бэкенд‑сервис.

Часто задаваемые вопросы

• Как конвертировать CSV в JPG в Node.JS без написания собственного кода парсинга?
  SDK читает CSV напрямую из хранилища GroupDocs Cloud и отображает каждую строку как изображение, поэтому вам не нужны внешние инструменты. Просто следуйте примеру кода или рабочему процессу cURL.

• Можно ли конвертировать CSV в JPEG вместо JPG на сервере?
  Да. Установите convertOptions.format = "jpeg" в коде или используйте format=jpeg в REST‑запросе. Оба формата поддерживаются для серверного преобразования в Node.JS.

• Могу ли я выполнять конвертацию асинхронно, чтобы не блокировать сервер?
  Абсолютно. Все методы SDK возвращают промисы, поэтому вы можете использовать await или добавить обработчики .then(). Это обеспечивает неблокирующую, масштабируемую автоматизацию преобразования CSV‑в‑JPG.

• Где я могу найти больше примеров преобразования CSV в изображения?
  Официальная документация содержит дополнительные образцы, а сообщественный форум на GroupDocs Conversion Forum — хорошее место для вопросов.

Читать дальше

• Конвертировать PDF в JPG с помощью Node.js | Извлечь изображения из PDF
• Конвертировать CSV в JSON в Node.js | CSV в JSON онлайн с использованием REST API
• Конвертировать JSON в CSV с использованием Node.js REST API | Преобразовать JSON в CSV онлайн