将网页转换为高分辨率图像是报告、缩略图创建和电子邮件渲染的常见需求。 Aspose.CAD Cloud SDK for Node.js 提供了强大的解决方案，可简化在服务器上直接将 HTML 转换为 JPG 的过程。本指南将带您完成 SDK 的安装、凭证配置、编写转换代码以及使用 cURL 调用 REST API，让您能够在任何 Node.JS 应用程序中嵌入 HTML‑to‑JPG 转换功能。

Steps to Convert HTML to JPG in Node.JS

  1. 配置 Aspose.CAD Cloud 凭证: 创建一个配置对象并设置您的客户端 ID 和密钥。
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. 创建 CAD API 实例：使用配置实例化 API 客户端。
const cadApi = new CadApi.CadApi(config);
  1. 定义输入 HTML 和输出 JPG 路径：解析源 HTML 文件和目标 JPG 文件的绝对路径。
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. 准备转换请求：附加 HTML 文件的可读流，并将输出格式指定为 jpg。
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. 执行转换并保存 JPG：调用 convert，接收一个 Buffer，并将其写入磁盘。这完成了在 Node.JS 中将 HTML 转换为 JPG 的过程。
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();

注意: 此代码示例演示了核心功能。在将其用于项目之前，请确保更新所有文件路径和配置值以匹配实际环境，验证已正确安装所有必需的依赖项，并在开发环境中彻底测试。如果遇到任何问题，请参考官方文档或联系支持团队获取帮助。

使用 cURL 从 HTML 生成 JPG

您可以通过 REST API 实现相同的转换。以下是所需的 cURL 命令。

  1. 获取访问令牌
    将 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"
  1. 上传源 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"
  1. 请求转换为 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
  1. 下载生成的 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

通过 npm 安装 SDK：

npm install @asposecloud/aspose-cad-cloud

该软件包可在Release page下载。
确保已安装 Node.js 12 或更高版本，并且已创建 Aspose Cloud 账户以获取您的 clientId 和 clientSecret。

Aspose.CAD 云 SDK 的图像生成能力

  • HTML 到 JPG 转换 - 直接将 HTML 页面渲染为高质量的 JPG 图像，无需中间步骤。
  • 基于流的处理 - 接受可读取的流作为输入，非常适合处理大文件或从内存读取。
  • 多种输出格式 - 除了 JPG，SDK 还支持 PNG、BMP、GIF、和 TIFF，实现灵活的图像生成。
  • 云托管渲染引擎 - 利用 Aspose 的云基础设施，实现快速且可靠的转换。
  • 全面的 API 参考 - 在线 API 参考提供完整的方法签名、必需和可选参数、身份验证流程、请求/响应模式以及错误代码，还包含数十个特定语言的代码片段（C#、Java、Python、Node.js），演示常见任务，如 CAD 转 JPG 转换、图像质量调节和流式输入处理。请参阅 API Reference。

结论

您现在已经了解如何在 Node.JS 中使用强大的 Aspose.CAD Cloud SDK for Node.js 将 HTML 转换为 JPG。该 SDK 负责凭证管理、流处理和格式选择，为您提供一个可直接运行的服务器端图像生成解决方案。请记得从临时许可证页面获取临时许可证用于测试，并在生产部署时购买完整许可证。祝编码愉快！

常见问题

如何在 Node.JS 中使用 Aspose.CAD 将 HTML 转换为 JPG？
使用 Aspose.CAD Cloud SDK for Node.js 创建 ConvertRequest，将 format 设置为 'jpg'，并调用 convert 方法。本文中的完整代码示例展示了具体步骤。

转换是在本地执行还是在云端执行？
SDK 将请求发送到 Aspose.CAD Cloud 服务，因此处理在云端进行，而您的 Node.JS 代码负责协调工作流。

支持哪些文件格式作为输入和输出？
SDK 支持广泛的 CAD 和图像格式。对于 HTML 转图像转换，您可以输出 JPG、PNG、BMP、GIF 或 TIFF。请参阅 API Reference 获取完整列表。

我需要为生产使用购买许可证吗？
临时许可证可用于评估，访问临时许可证页面。在生产环境中，您必须从 Aspose 获取商业许可证。

Read More