Webページを高解像度画像に変換することは、レポート作成、サムネイル生成、メールのレンダリングなどで一般的な要件です。
Aspose.CAD Cloud SDK for Node.js は、サーバー上で直接HTML を JPG に変換するプロセスを簡素化する堅牢なソリューションを提供します。
本ガイドでは、SDK のインストール、認証情報の設定、変換コードの作成、cURL を使用した REST API の利用手順を解説し、HTML‑to‑JPG 変換を任意の Node.JS アプリケーションに組み込む方法を示します。
Node.JS で HTML を JPG に変換する手順
- Aspose.CAD Cloud の認証情報を構成: 構成オブジェクトを作成し、クライアント ID とシークレットを設定します。
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 を受け取り、ディスクに書き込みます。これで 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 コマンドです。
- アクセストークンを取得する
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
npm を使用して SDK をインストールします:
npm install @asposecloud/aspose-cad-cloud
パッケージはRelease pageからダウンロードできます。
Node.js 12 以上がインストールされていること、そして Aspose Cloud アカウントを作成して clientId と clientSecret を取得していることを確認してください。
Aspose.CAD Cloud SDK の画像生成機能
- HTML to JPG conversion - 中間ステップなしでHTMLページを高品質なJPG画像として直接レンダリングします。
- Stream‑based processing - 入力を読み取り可能なストリームとして受け取ります。大きなファイルやメモリからの読み取りに最適です。
- Multiple output formats - JPGに加えて、SDKはPNG、BMP、GIF、TIFF をサポートし、柔軟な画像生成が可能です。
- Cloud‑hosted rendering engine - Aspose のクラウドインフラストラクチャを活用し、迅速かつ信頼性の高い変換を実現します。
- Comprehensive API reference - オンライン API リファレンスは、完全なメソッドシグネチャ、必須およびオプションのパラメータ、認証フロー、リクエスト/レスポンス スキーマ、エラーコードを提供し、さらに CAD‑to‑JPG 変換、画像品質調整、ストリーミング入力処理などの一般的なタスクを示す多数の言語別コードスニペット（C#, Java, Python, Node.js）を掲載しています。 詳細は API Reference をご覧ください。
結論
あなたは、強力な Aspose.CAD Cloud SDK for Node.js を使用して、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 から商用ライセンスを取得する必要があります。