Повний робочий приклад конвертації 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. Завантажити PNG - Після конвертації StorageApi.downloadFile отримує двійкові дані, які ви можете записати у локальну файлову систему.

Розуміння кожного кроку допомагає налаштувати процес, обробляти помилки та інтегрувати конвертацію в більш складні робочі процеси.

Встановлення та налаштування GroupDocs.Conversion Cloud SDK для 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 - Слідкуйте за вашою квотою конвертації та обробляйте відповіді про обмеження швидкості (rate‑limit) коректно.

Висновок

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 - Повний приклад коду

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

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. Install the 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 повертають обіцянки, що дозволяє інтегрувати конвертацію в асинхронні робочі процеси без блокування циклу подій.

await convertApi.convertDocument(convertSettings);

Ці параметри дозволяють налаштувати процес CSV‑to‑JPG відповідно до ваших конкретних потреб в автоматизації або інтеграції.

Висновок

Конвертування CSV у JPG у Node.JS просте за допомогою GroupDocs.Conversion Cloud SDK for Node.js. Бібліотека виконує важку роботу в хмарі, дозволяючи вам зосередитися на бізнес‑логіці та інтеграції. Не забудьте захистити ваші хмарні облікові дані, вибрати відповідний формат виводу (JPG або JPEG) та налаштувати параметри, такі як розміри або шляхи виводу, відповідно до вашого робочого процесу. Для продакшн‑розгортань вам знадобиться платна ліцензія; ви можете ознайомитися з деталями цін і отримати тимчасову ліцензію на temporary license page. Завдяки наведеному коду та прикладам cURL, ви готові додати автоматизацію перетворення CSV‑to‑JPG у будь‑який бекенд‑сервіс.

FAQs

• Як конвертувати CSV у JPG у Node.JS без написання власної логіки парсингу?
  SDK читає CSV безпосередньо з сховища GroupDocs Cloud і відображає кожен рядок як зображення, тому вам не потрібні зовнішні інструменти. Просто дотримуйтесь прикладу коду або cURL‑workflow.

• Чи можливо конвертувати CSV у JPEG замість JPG у бекенді?
  Так. Встановіть convertOptions.format = "jpeg" у коді або використайте format=jpeg у REST‑запиті. Обидва формати підтримуються для конвертації у бекенді в Node.JS.

• Чи можу я виконувати конвертацію асинхронно, щоб уникнути блокування мого сервера?
  Абсолютно. Усі методи SDK повертають проміси, тому ви можете await їх або приєднати обробники .then(). Це забезпечує неблокуючу, масштабовану автоматизацію CSV‑to‑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 онлайн