تبدیل صفحات وب به تصاویر با وضوح بالا یک نیاز رایج برای گزارشگیری، ایجاد تصویر بندانگشتی و رندر ایمیل است. Aspose.CAD Cloud SDK for Node.js یک راهحل قوی ارائه میدهد که تبدیل HTML به JPG را بهصورت مستقیم بر روی سرور شما ساده میکند. این راهنما شما را در نصب SDK، پیکربندی اعتبارها، نوشتن کد تبدیل و استفاده از REST API با cURL راهنمایی میکند تا بتوانید تبدیل HTML‑to‑JPG را در هر برنامه Node.JS جاسازی کنید.
مراحل تبدیل HTML به JPG در 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 مراجعه کنید.
مثال کامل کارآمد برای تبدیل 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 for 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 مراجعه کنید.
آیا برای استفاده در تولید نیاز به خرید لایسنس دارم؟
یک لایسنس موقت برای ارزیابی در صفحه لایسنس موقت موجود است. برای تولید، باید یک لایسنس تجاری از Aspose دریافت کنید.