웹 페이지를 고해상도 이미지로 변환하는 것은 보고서 작성, 썸네일 생성 및 이메일 렌더링에 흔히 필요한 작업입니다.
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 이상이 설치되어 있고, clientId와 clientSecret을 얻기 위해 Aspose Cloud 계정을 생성했는지 확인하십시오.
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는 자격 증명 관리, 스트림 처리 및 형식 선택을 처리하여 서버‑side 이미지 생성을 위한 즉시 실행 가능한 솔루션을 제공합니다. 테스트를 위해 temporary license page에서 임시 라이선스를 얻고, 프로덕션 배포를 위해 정식 라이선스를 구매하십시오. 즐거운 코딩 되세요!
FAQs
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 참조를 확인하세요.
프로덕션 사용을 위해 라이선스를 구매해야 하나요?
평가용으로 임시 라이선스를 임시 라이선스 페이지에서 사용할 수 있습니다. 프로덕션에서는 Aspose에서 상업용 라이선스를 구매해야 합니다.