Convertire le pagine web in immagini ad alta risoluzione è una esigenza comune per la creazione di report, miniature e la resa delle email. Il Aspose.CAD Cloud SDK for Node.js offre una soluzione robusta che semplifica la conversione di HTML in JPG direttamente sul tuo server. Questa guida ti accompagna nell’installazione dell’SDK, nella configurazione delle credenziali, nella scrittura del codice di conversione e nell’utilizzo dell’API REST con cURL, così potrai integrare la conversione da HTML a JPG in qualsiasi applicazione Node.JS.

Passaggi per convertire HTML in JPG in Node.JS

  1. Configura le credenziali di Aspose.CAD Cloud: Crea un oggetto di configurazione e imposta il tuo client ID e il segreto.
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. Crea l’istanza CAD API: Usa la configurazione per istanziare il client API.
const cadApi = new CadApi.CadApi(config);
  1. Definisci i percorsi HTML di input e JPG di output: Risolvi i percorsi assoluti per il file HTML di origine e per il file JPG di destinazione.
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. Prepara la richiesta di conversione: Allega un flusso leggibile del file HTML e specifica il formato di output come jpg.
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. Esegui la conversione e salva il JPG: chiama convert, ricevi un Buffer e scrivilo su disco. Questo completa il processo per convertire HTML in JPG in 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);
}

Per informazioni dettagliate sulla classe, fare riferimento al Riferimento API.

Esempio completo di funzionamento per la conversione da HTML a JPG

Il seguente esempio dimostra il flusso di lavoro completo dall’inizio alla fine.

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();

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Genera JPG da HTML usando cURL

È possibile ottenere la stessa conversione tramite l’API REST. Di seguito sono riportati i comandi cURL richiesti.

  1. Ottieni un token di accesso
    Sostituisci YOUR_CLIENT_ID e YOUR_CLIENT_SECRET con le tue credenziali.
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. Carica il file HTML di origine
    Usa il token di accesso dal passaggio precedente.
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. Richiedi la conversione in JPG
    Il parametro di query format specifica il formato di destinazione.
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. Scarica il JPG risultante (se hai usato un endpoint diverso per la conversione).
curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg

Per ulteriori dettagli, consulta la documentazione API ufficiale.

Installazione e configurazione di Aspose.CAD Cloud SDK for Node.JS

Installa l’SDK tramite npm:

npm install @asposecloud/aspose-cad-cloud

Il pacchetto è disponibile per il download nella pagina di rilascio.
Assicurati di avere Node.js 12 o superiore installato e di aver creato un account Aspose Cloud per ottenere il tuo clientId e clientSecret.

Aspose.CAD Cloud SDK Capabilities for Image Generation

  • HTML to JPG conversion - Renderizza direttamente le pagine HTML come immagini JPG ad alta qualità senza passaggi intermedi.
  • Stream‑based processing - Accetta l’input come stream leggibile, ideale per file di grandi dimensioni o quando si legge dalla memoria.
  • Multiple output formats - Oltre a JPG, l’SDK supporta PNG, BMP, GIF, e TIFF, consentendo una generazione flessibile di immagini.
  • Cloud‑hosted rendering engine - Sfrutta l’infrastruttura cloud di Aspose per conversioni rapide e affidabili.
  • Comprehensive API reference - Il Riferimento API online fornisce firme complete dei metodi, parametri richiesti e opzionali, flusso di autenticazione, schemi di richiesta/risposta e codici di errore, oltre a decine di snippet di codice specifici per linguaggio (C#, Java, Python, Node.js) che illustrano attività comuni come la conversione CAD‑to‑JPG, la regolazione della qualità dell’immagine e la gestione dell’input in streaming. Vedi il API Reference.

Conclusione

Ora sai come convertire HTML in JPG in Node.JS usando il potente Aspose.CAD Cloud SDK for Node.js. L’SDK gestisce la gestione delle credenziali, l’elaborazione dei flussi e la selezione del formato, fornendoti una soluzione pronta all’uso per la generazione di immagini lato server. Ricorda di ottenere una licenza temporanea dalla pagina della licenza temporanea per i test e di acquistare una licenza completa per le distribuzioni in produzione. Buona programmazione!

FAQs

Come posso convertire HTML in JPG in Node.JS usando Aspose.CAD?
Utilizza l’SDK Cloud Aspose.CAD per Node.js per creare un ConvertRequest, impostare format su 'jpg' e chiamare il metodo convert. L’esempio di codice completo in questo articolo mostra i passaggi esatti.

La conversione viene eseguita localmente o nel cloud?
L’SDK invia la richiesta ai servizi Aspose.CAD Cloud, quindi l’elaborazione avviene nel cloud mentre il tuo codice Node.JS orchestra il flusso di lavoro.

Quali formati di file sono supportati per l’input e l’output?
L’SDK supporta un’ampia gamma di formati CAD e immagine. Per la conversione da HTML a immagine, è possibile generare JPG, PNG, BMP, GIF o TIFF. Consulta la Riferimento API per l’elenco completo.

Devo acquistare una licenza per l’uso in produzione?
Una licenza temporanea è disponibile per la valutazione nella pagina della licenza temporanea. Per la produzione, è necessario ottenere una licenza commerciale da Aspose.

Leggi di più