Node.JS’te SVG’den PNG’ye Dönüştürme için Tam Çalışan Örnek

Bu örnek, GroupDocs Cloud depolamasında saklanan bir SVG dosyasını, GroupDocs.Conversion Cloud SDK for Node.JS kullanarak PNG görüntüsüne dönüştürmeyi göstermektedir.

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();
        }
    });

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (input/sample.svg, output/sample.png vb.) gerçek dosya konumlarınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona başvurun veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile SVG’den PNG’ye Dönüştürme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm cURL komutlarıyla gerçekleştirilebilir. Aşağıdaki adımlar bir erişim belirteci almayı, SVG’yi yüklemeyi, dönüşümü başlatmayı ve PNG’yi indirmeyi gösterir.

Kimlik Doğrulama ve Erişim Belirteci Al

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"
         }'

Yanıt, sonraki çağrılarda kullanacağınız bir access_token içerir.

Kaynak SVG Dosyasını Yükle

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’den PNG’ye Dönüşümü Gerçekleştirin

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, bulut depolama alanında yeni oluşturulan PNG dosyasının yolunu döndürür.

Sonuç PNG Dosyasını İndir

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

Bu cURL komutları, kod yazmadan dönüşüm süreci üzerinde tam kontrol sağlar. Daha fazla ayrıntı için, resmi API belgelerine bakın.

Node.JS’de SVG’den PNG’ye Dönüşüm Nasıl Çalışır

1. SDK Sınıflarını İçe Aktar - require("@groupdocs/conversion-cloud") ifadesi, ConvertApi, ConvertSettings ve PngOptions gibi temel sınıfları yükler (API referansı).

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

2. Kimlik Doğrulamayı Yapılandır - Bir Configuration nesnesi clientId ve clientSecret değerlerinizi tutar. Bu nesne, sonraki tüm çağrıları yetkilendirmek için hem ConvertApi hem de StorageApi‘ye geçirilir.

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

3. Giriş ve Çıkış Yollarını Tanımlayın - inputSvgPath bulut depolamadaki SVG’ye işaret eder, outputPngPath ise PNG’nin kaydedileceği yeri belirtir.

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

4. PNG Seçeneklerini Ayarla - PngOptions boyutları ve arka plan rengini kontrol etmenizi sağlar; bu, büyük veya şeffaf SVG’ler için faydalıdır.

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

5. Dönüştürme Ayarlarını Oluştur ve Çalıştır - ConvertSettings dosya yolunu, hedef formatı, çıktı konumunu ve seçenekleri bir araya getirir. convertDocument yöntemi dönüşümü gerçekleştirir ve sonuç PNG’nin bulut yolunu içerir.

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

6. PNG’yi İndir - Dönüştürmeden sonra, StorageApi.downloadFile ikili veriyi alır ve bu veriyi yerel dosya sistemine yazabilirsiniz.

Her adımı anlamak, süreci özelleştirmenize, hataları yönetmenize ve dönüşümü daha büyük iş akışlarına entegre etmenize yardımcı olur.

Kurulum ve Yapılandırma GroupDocs.Conversion Cloud SDK for Node.JS

npm install groupdocs-conversion-cloud

SDK, Node.js 12 ve üzeri bir sürüm gerektirir. Kurulumdan sonra, clientId ve clientSecret (GroupDocs Cloud hesabınızdan temin edilebilir) içeren bir yapılandırma nesnesi oluşturun. En son paket sürümünü görmek için indirme sayfası adresine bakın.

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

Kimlik bilgilerinin depolama ve dönüşüm hizmetlerine erişim iznine sahip olduğundan emin olun. Yapılandırıldıktan sonra, kod örneğinde gösterildiği gibi ConvertApi ve StorageApi nesnelerini örnekleyebilirsiniz.

PNG Dönüştürme Ayarlarını İnce Ayarlama

PngOptions sınıfı, ayarlayabileceğiniz birkaç özelliği sunar:

• width / height - Çıktı çözünürlüğünü tanımlayın. Daha büyük değerler kaliteyi artırır ancak daha fazla bellek tüketir.

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

• backgroundColor - Şeffaflık içeren SVG’ler için katı bir arka plan ayarlayın.

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

• compressionLevel - (Destekleniyorsa) Dosya boyutunu azaltmak için 0 (sıkıştırma yok) ile 9 (maksimum sıkıştırma) arasında bir sıkıştırma seviyesi seçin.

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

Bu seçenekler, ConvertSettings nesnesinin options özelliği aracılığıyla iletilir. Mevcut ayarların tam listesi için API referansı bakın.

Verimli SVG’den PNG’ye Dönüşüm İçin En İyi Uygulamalar

• SVG İçeriğini Doğrulayın - SVG’nin dış betikler veya kötü amaçlı yükler içermediğinden, yüklemeden önce emin olun. GroupDocs.Conversion girişi temizler, ancak ön‑doğrulama ekstra bir güvenlik katmanı ekler.
• Yapılandırma Nesnesini Yeniden Kullanın - Configuration örneğini tek bir kez oluşturun ve birden fazla ConvertApi çağrısı arasında paylaşarak yükü azaltın.
• Mantıklı Boyutlar Belirleyin - Genişlik ve yüksekliği gerçekten ihtiyacınız olan boyuta sınırlayın. Aşırı büyük görseller işleme süresini ve bellek kullanımını artırır.
• Büyük Dosyaları Akış Olarak İşleyin - Çok büyük SVG’ler için, tüm tamponu belleğe yüklemek yerine indirmeyi akış olarak işlemeyi düşünün.
• API Kullanımını İzleyin - Dönüştürme kotanızı izleyin ve oran sınırlama yanıtlarını nazikçe yönetin.

Sonuç

GroupDocs.Conversion Cloud SDK for Node.JS sunucu‑tarafı SVG’den PNG’ye dönüşümü basit, ölçeklenebilir ve güvenli hâle getirir. Tam kod örneğini, eşdeğer cURL iş akışını ve yukarıdaki yapılandırma ipuçlarını izleyerek, yüksek performanslı görüntü dönüşümünü herhangi bir backend servisine entegre edebilirsiniz. Lisans seçeneklerini gözden geçirmeyi unutmayın; üretim dağıtımları ücretli bir abonelik gerektirir ve test için geçici bir lisans alabilirsiniz geçici lisans sayfasından. Bugün dönüştürmeye başlayın ve kullanıcılarınıza net PNG varlıkları sunun.

FAQs

Node.JS kullanarak GroupDocs ile SVG’den PNG’ye dönüşüm nasıl yapılır?
GroupDocs.Conversion Cloud SDK for Node.JS’yi kullanın. SVG’yi bulut depolamaya yükleyin, PngOptions‘ı yapılandırın, convertDocument‘ı çağırın ve PNG’yi indirin. Bu makaledeki tam kod örneği her adımı gösterir.

Bir seferde birçok SVG dosyasını toplu olarak dönüştürebilir miyim?
Evet. SVG yollarının bir listesini yineleyin ve her dosya için aynı dönüşüm isteğini çağırın. SDK, her isteği bağımsız olarak işler, böylece tüm PNG sonuçlarını tek bir çıktı klasöründe saklayabilirsiniz.

Dönüştürme bir hata ile başarısız olursa ne yapmalıyım?
Catch bloğunda döndürülen hata mesajını kontrol edin. Yaygın sorunlar arasında geçersiz kimlik bilgileri, eksik dosya yolları veya desteklenmeyen SVG özellikleri bulunur. Ayrıntılı hata kodları ve sorun giderme adımları için resmi belgeleri inceleyin.

PNG seçenekleri hakkında daha fazla bilgi nerede bulabilirim?
Tüm yapılandırılabilir özellikler PngOptions için API referansında listelenmiştir. Ek ayarları, örneğin sıkıştırma seviyesi ve renk derinliği gibi, keşfetmek için API referansı adresini ziyaret edin.

Daha Fazla Oku

• Node.JS’de Adım Adım HTML’den DOCX’e Dönüştürme Eğitimi
• Node.JS’de Adım Adım CSV’den PDF’e Dönüştürme Örneği
• Node.JS’de PDF’den DOCX’e Dönüştürme

CSV’yi Node.JS’te JPG’ye Dönüştür - Tam Kod Örneği

Bu örnek, kütüphanenin async API’si kullanılarak GroupDocs Cloud depolama alanında saklanan bir CSV dosyasının JPG görüntülerine dönüştürülmesini gösterir.

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();

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını (input.csv, output_images vb.) gerçek dosya konumlarınızla eşleşecek şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde kurulduğunu doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgelere bakın veya yardım için destek ekibi ile iletişime geçin.

CSV’den JPG’ye Dönüştürme cURL ve REST API Kullanarak

Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm bir dizi cURL komutuyla gerçekleştirilebilir.

1. Erişim belirteci alın - istemci kimlik bilgilerinizle kimlik doğrulaması yapın.

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. Kaynak CSV’yi yükleyin - dosyayı GroupDocs Cloud depolamanıza yerleştirin.

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. Dönüşümü isteyin - hedef formatı JPG olarak belirtin.

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. Oluşturulan görüntü(leri) indirin - çıktı klasöründen dosyaları alın.

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

Bu komutlar, herhangi bir kod yazmadan tam bir CSV‑to‑JPG iş akışını gösterir. Daha fazla ayrıntı için, resmi API belgelerine bakın.

Node.JS’de CSV’den JPG’ye Dönüşüm Sürecini Anlamak

Aşağıda, daha önce gösterilen kodun adım adım açıklaması bulunmaktadır:

1. API istemcisini başlat - new ConvertApi(clientId, clientSecret) kimlik doğrulamalı bir oturum oluşturur.

const convertApi = new ConvertApi(clientId, clientSecret);

2. Kaynak dosyayı tanımlayın - bir FileInfo nesnesi, GroupDocs Cloud’da depolanan input.csv dosyasına işaret eder.

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

3. Dönüşüm seçeneklerini ayarla - ConvertOptions.format = "jpg" hizmetin JPG çıktısı üretmesini sağlar.

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

4. Çıktı ayarlarını yapılandır - ConvertSettings.outputPath görüntülerin nereye kaydedileceğini belirler.

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

5. Dönüştürmeyi çalıştır - convertApi.convertDocument(convertSettings) isteği gönderir ve oluşturulan dosya yollarının bir dizisini döndürür.

   const result = await convertApi.convertDocument(convertSettings);
   

Sınıfların ve özelliklerin tam listesi için, API referansına bakın.

Önkoşullar ve Kurulum

1. Node.js runtime - version 12 veya üzeri gereklidir.
2. GroupDocs Cloud account - GroupDocs portalından clientId ve clientSecret alın.
3. Install the SDK - aşağıdaki komutu çalıştırın (paketi resmi sürüm sayfasından indirin):

npm install groupdocs-conversion-cloud

4. SDK’yı içe aktar projenizde:

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

Kurulumla ilgili daha fazla ayrıntı için, indirme sayfasına bakın.

Dönüştürme Ayarları: Seçenekler ve Parametreler

SDK, ayarlayabileceğiniz çeşitli özellikler sunar:

• Output Path - JPG dosyalarının depolandığı klasörü kontrol eder.

convertSettings.outputPath = "output_images";

• Hedef Biçim - "jpg" değerini "jpeg" olarak değiştirin, eğer JPEG varyantına ihtiyacınız varsa.

convertOptions.format = "jpeg";

• Özel Boyutlar - destekleniyorsa genişlik ve yüksekliği belirtebilir, tam boyutta görüntüler oluşturabilirsiniz.

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

• Asenkron Yürütme - SDK yöntemleri promise döndürür, böylece dönüşümü asenkron iş akışlarına bloklamadan olay döngüsünü engellemeden entegre edebilirsiniz.

await convertApi.convertDocument(convertSettings);

Bu seçenekler, CSV‑to‑JPG iş akışını belirli otomasyon veya entegrasyon ihtiyaçlarınıza göre özelleştirmenizi sağlar.

Sonuç

Node.JS’te CSV’yi JPG’ye dönüştürmek, GroupDocs.Conversion Cloud SDK for Node.js ile oldukça basittir. Kütüphane, bulutta ağır işleri halleder ve iş mantığı ile entegrasyona odaklanmanızı sağlar. Bulut kimlik bilgilerinizi güvence altına almayı, uygun çıktı formatını (JPG veya JPEG) seçmeyi ve iş akışınıza uygun olacak şekilde boyutlar veya çıktı yolları gibi ayarları düzenlemeyi unutmayın. Üretim dağıtımları için ücretli bir lisansa ihtiyacınız olacak; fiyatlandırma detaylarını inceleyebilir ve geçici bir lisans alabilirsiniz geçici lisans sayfası. Sağlanan kod ve cURL örnekleriyle, CSV‑to‑JPG otomasyonunu herhangi bir backend servisine eklemeye hazırsınız.

FAQs

• Node.JS’de özel ayrıştırma mantığı yazmadan CSV’yi JPG’ye nasıl dönüştürürüm?
  SDK, CSV’yi doğrudan GroupDocs Cloud depolamasından okur ve her satırı bir görüntü olarak render eder, bu yüzden harici araçlara ihtiyacınız yok. Sadece kod örneğini veya cURL iş akışını izleyin.

• CSV’yi arka uçta JPG yerine JPEG olarak dönüştürmek mümkün mü?
  Evet. Koddaki convertOptions.format = "jpeg" ayarını yapın veya REST isteğinde format=jpeg kullanın. Her iki format da Node.JS’te arka uç dönüşümü için desteklenir.

• Sunucumu engellemeden dönüşümü asenkron olarak çalıştırabilir miyim?
  Kesinlikle. Tüm SDK yöntemleri promise döndürür, bu yüzden await edebilir veya .then() işleyicilerini ekleyebilirsiniz. Bu, engellemeyen, ölçeklenebilir CSV‑to‑JPG otomasyonunu sağlar.

• CSV’den görüntüye dönüşümlerine dair daha fazla örnek nerede bulabilirim?
  Resmi belgeler ek örnekler içerir ve GroupDocs Conversion Forum topluluk forumu sorular sormak için iyi bir yerdir.

Read More

• Node.js kullanarak PDF’yi JPG’ye dönüştürme | PDF’den Görüntüleri Çıkarma
• Node.js’te CSV’yi JSON’a dönüştürme | REST API kullanarak Çevrimiçi CSV’den JSON’a
• Node.js REST API kullanarak JSON’ı CSV’ye dönüştürme | JSON’ı CSV formatına çevrimiçi dönüştürme