הפיכת דפי אינטרנט לתמונות ברזולוציה גבוהה היא דרישה נפוצה לדיווח, יצירת תמונות ממוזערות והצגת דוא"ל. ה-Aspose.CAD Cloud SDK for Node.js מציע פתרון חזק שמפשט המרה של HTML ל-JPG ישירות על השרת שלך. מדריך זה מנחה אותך דרך התקנת ה‑SDK, קונפיגורציית האישורים, כתיבת קוד ההמרה, ושימוש ב‑REST API עם cURL, כך שתוכל לשלב המרת HTML‑ל‑JPG בכל יישום Node.JS.
Steps to Convert HTML to JPG in Node.JS
- הגדרת פרטי האימות של Aspose.CAD Cloud: צור אובייקט תצורה והגדר את מזהה הלקוח והסוד שלך.
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
- צור את מופע ה‑CAD API: השתמש בתצורה כדי לאתחל את לקוח ה‑API.
const cadApi = new CadApi.CadApi(config);
- הגדר נתיבי קלט HTML ויציאת JPG: פותר נתיבים מוחלטים עבור קובץ ה‑HTML המקור וקובץ ה‑JPG היעד.
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
- הכן את בקשת ההמרה: צרף זרם קריא של קובץ ה-HTML וציין את פורמט הפלט כ-
jpg.
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
- הפעל את ההמרה ושמור את ה-JPG: קרא
convert, קבל Buffer, וכתוב אותו לדיסק. זה משלים את התהליך של המרת HTML ל-JPG ב-Node.JS.
try {
const resultBuffer = await cadApi.convert(request);
fs.writeFileSync(outputPath, resultBuffer);
console.log('Conversion completed. JPG saved to:', outputPath);
} catch (err) {
console.error('Error during conversion:', err);
}
למידע מפורט על המחלקות, עיינו ב-API Reference.
דוגמה מלאה לעבודה להמרת HTML ל‑JPG
הדוגמה הבאה מציגה את זרימת העבודה המלאה מההתחלה ועד הסוף.
const fs = require('fs');
const path = require('path');
const CadApi = require('asposecadcloud');
async function convertHtmlToJpg() {
// Configure Aspose.CAD Cloud credentials
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
// Create API instance
const cadApi = new CadApi.CadApi(config);
// Define input HTML and output JPG paths
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
// Prepare request with a readable stream and target format
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
try {
// Perform conversion; result is a Buffer containing JPG data
const resultBuffer = await cadApi.convert(request);
// Write the JPG buffer to the output file
fs.writeFileSync(outputPath, resultBuffer);
console.log('Conversion completed. JPG saved to:', outputPath);
} catch (err) {
console.error('Error during conversion:', err);
}
}
// Execute the conversion
convertHtmlToJpg();
הערה: דוגמת קוד זו מדגימה את הפונקציונליות המרכזית. לפני השימוש בפרויקט שלך, ודא שאתה מעדכן את כל נתיבי הקבצים וערכי התצורה כך שיתאימו לסביבה האמיתית שלך, מאמת שכל התלויות הנדרשות מותקנות כראוי, ובודק באופן יסודי בסביבת הפיתוח שלך. אם אתה נתקל בבעיות, אנא פנה לתיעוד הרשמי או פנה לצוות תמיכה לקבלת עזרה.
צור JPG מ-HTML באמצעות cURL
אתה יכול לבצע את אותה המרה באמצעות ה-REST API. להלן פקודות cURL הדרושות.
- קבל אסימון גישה
החלףYOUR_CLIENT_IDו-YOUR_CLIENT_SECRETבאישורים שלך.
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- העלה את קובץ ה-HTML המקורי
השתמש באסימון הגישה מהשלב הקודם.
curl -X PUT "https://api.aspose.cloud/v3.0/cad/storage/file/sample.html" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/html" \
--data-binary "@sample.html"
- בקשת המרה ל‑JPG
פרמטר השאילתהformatמציין את פורמט היעד.
curl -X POST "https://api.aspose.cloud/v3.0/cad/convert?format=jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@sample.html" \
-o sample.jpg
- הורד את קובץ ה‑JPG שנוצר (אם השתמשת בנקודת קצה אחרת להמרה).
curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg
למידע נוסף, ראו את תיעוד ה-API הרשמי.
התקנה וקונפיגורציה של Aspose.CAD Cloud SDK עבור Node.JS
התקן את ה‑SDK באמצעות npm:
npm install @asposecloud/aspose-cad-cloud
החבילה זמינה להורדה בדף השחרור.
ודא שיש לך Node.js גרסה 12 או גבוהה יותר מותקנת ושיצרת חשבון Aspose Cloud כדי לקבל את clientId ו‑clientSecret.
Aspose.CAD Cloud SDK יכולות ליצירת תמונות
- המרת HTML ל‑JPG - מממשים ישירות דפי HTML כתמונות JPG באיכות גבוהה ללא שלבים ביניים.
- עיבוד מבוסס זרם - מקבל קלט כזרם קריא, אידיאלי לקבצים גדולים או כאשר קוראים מהזיכרון.
- פורמטים מרובים של פלט - בנוסף ל‑JPG, ה‑SDK תומך ב‑PNG, ב‑BMP, ב‑GIF, וב‑TIFF, ומאפשר יצירת תמונות גמישה.
- מנוע רינדור מתארח בענן - משתמש בתשתית הענן של Aspose להמרות מהירות ואמינות.
- תיעוד API מקיף - תיעוד ה‑API המקוון מספק חתימות שיטות מלאות, פרמטרים נדרשים ואופציונליים, זרימת אימות, סכמות בקשה/תגובה וקודי שגיאה, וכן עשרות קטעי קוד ספציפיים לשפות (C#, Java, Python, Node.js) המדגימים משימות נפוצות כגון המרת CAD ל‑JPG, כיוונון איכות תמונה, וטיפול בקלט מבוסס זרם. ראה את תיעוד API.
סיכום
עכשיו אתה יודע איך להמיר HTML ל‑JPG ב‑Node.JS באמצעות ה‑Aspose.CAD Cloud SDK for Node.js החזק. ה‑SDK מטפל בניהול אישורים, עיבוד זרמים ובחירת פורמט, ומספק לך פתרון מוכן להפעלה ליצירת תמונות בצד השרת. זכור לקבל רישיון זמני מ‑דף רישיון זמני לצורך בדיקות, ולרכוש רישיון מלא לפריסות בייצור. קידוד מהנה!
שאלות נפוצות
איך ניתן להמיר HTML ל‑JPG ב‑Node.JS באמצעות Aspose.CAD?
השתמש ב‑Aspose.CAD Cloud SDK עבור Node.js כדי ליצור ConvertRequest, להגדיר format ל‑‘jpg’, ולקרוא לשיטת convert. הדוגמה המלאה בקוד במאמר זה מציגה את השלבים המדויקים.
האם ההמרה מתבצעת מקומית או בענן?
ה‑SDK שולח את הבקשה לשירותי Aspose.CAD Cloud, ולכן העיבוד מתרחש בענן בעוד קוד ה‑Node.JS שלך מתאם את זרימת העבודה.
אילו פורמטים של קבצים נתמכים לקלט ולפלט?
ה‑SDK תומך במגוון רחב של פורמטים של CAD ותמונות. עבור המרת HTML לתמונה, ניתן לייצא JPG, PNG, BMP, GIF או TIFF. ראה את API Reference עבור הרשימה המלאה.
האם עלי לרכוש רישיון לשימוש בייצור?
רישיון זמני זמין להערכה בדף רישיון זמני. בייצור, עליך לרכוש רישיון מסחרי מ‑Aspose.