ตัวอย่างการทำงานเต็มรูปแบบสำหรับการแปลง SVG เป็น PNG ใน Node.JS

ตัวอย่างนี้แสดงวิธีการแปลงไฟล์ SVG ที่จัดเก็บใน GroupDocs Cloud storage เป็นภาพ 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 Classes - คำสั่ง 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 Options - 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 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 reference เพื่อสำรวจการตั้งค่าเพิ่มเติมเช่นระดับการบีบอัดและความลึกของสี.

อ่านเพิ่มเติม

• บทแนะนำการแปลง HTML เป็น DOCX อย่างละเอียดใน Node.JS
• ตัวอย่างการแปลง CSV เป็น PDF อย่างละเอียดใน Node.JS
• การแปลง PDF เป็น DOCX ใน Node.JS