La conversione di modelli 3D complessi in un formato visualizzabile universalmente è una necessità frequente per le pipeline di ingegneria e visualizzazione. Aspose.Slides Cloud SDK for Node.js offre una libreria potente che consente di convertire programmaticamente file 3D in PDF in Node.JS. Questa guida ti accompagna attraverso i prerequisiti, i passaggi di installazione, una dettagliata analisi del codice, un esempio completo, i comandi REST cURL e le principali opzioni di configurazione, così da poter integrare rapidamente la conversione da 3D a PDF nelle tue applicazioni.

Configurazione di Aspose.Slides Cloud SDK for Node.js

Prima di iniziare, assicurati di avere quanto segue:

  • Node.js 14 o versioni successive installate sulla tua macchina di sviluppo.
  • Un account Aspose Cloud. Creane uno sul portale Aspose e annota il tuo Client Id e Client Secret.
  • Connettività Internet per l’SDK per chiamare il servizio Aspose Slides Cloud.

Installa l’SDK tramite npm:

npm install asposeslidescloud

Puoi anche scaricare l’ultimo pacchetto dalla pagina di rilascio. Dopo l’installazione, importa l’SDK e configura le tue credenziali come mostrato nella guida qui sotto. Con l’SDK pronto, sei pronto per iniziare a convertire file 3D.

Costruirlo passo dopo passo: Convertire 3D in PDF in Node.JS

Passo 1: Inizializzare il client Slides API

Crea un oggetto di configurazione con le credenziali del client e istanzia la classe SlidesApi.

let configuration = new SlidesApi.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
let api = new SlidesApi.SlidesApi(configuration);

Riferimento della classe SlidesApi spiega tutti i metodi disponibili.

Passo 2: Specificare il file 3D di origine

Fornisci il nome del file 3D che desideri convertire. L’SDK supporta formati come OBJ, STL, e FBX.

let name = "sample.pptx";

Passo 3: Definisci il formato di destinazione e il percorso di output

Imposta il formato di output desiderato su pdf e scegli dove verrà salvato il file convertito.

let format = "pdf";
let outPath = "output.pdf";

Passo 4: Esegui la conversione

Chiama convertAndSave e gestisci la promise per confermare il successo o catturare gli errori.

api.convertAndSave(name, format, outPath, null, null, null, null, null)
    .then(() => console.log("Converted"))
    .catch(err => console.error(err));

Questo snippet dimostra il nucleo di come convertire 3D in PDF in Node.JS utilizzando la libreria Aspose.Slides Cloud.

Esempio di Codice Completo: Converti 3D in PDF in modo efficiente

Il seguente esempio mette insieme tutti i componenti in un unico script eseguibile.

let SlidesApi = require("asposeslidescloud");
let configuration = new SlidesApi.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
let api = new SlidesApi.SlidesApi(configuration);
let name = "sample.pptx";
let format = "pdf";
let outPath = "output.pdf";
api.convertAndSave(name, format, outPath, null, null, null, null, null)
    .then(() => console.log("Converted"))
    .catch(err => console.error(err));

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 installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Esecuzione della conversione 3D in PDF tramite REST API usando cURL

Se preferisci un approccio REST puro, la stessa conversione può essere ottenuta con comandi cURL.

1. Ottenere un token di accesso

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"

2. Carica il file 3D di origine

curl -X PUT "https://api.aspose.cloud/v3.0/slides/storage/file/sample.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./sample.pptx"

3. Richiedi la conversione in PDF

curl -X POST "https://api.aspose.cloud/v3.0/slides/sample.pptx/convert/pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

4. Scarica il PDF convertito (se non salvato direttamente)

curl -X GET "https://api.aspose.cloud/v3.0/slides/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

Per un elenco completo di parametri e opzioni aggiuntive, vedi il riferimento API.

Configurazione delle impostazioni di conversione per 3D in PDF

L’SDK consente di regolare diversi parametri per controllare l’output della conversione. Di seguito sono riportate due opzioni comunemente utilizzate:

  • Output Path - Determina dove il PDF convertito verrà salvato sul server.
let outPath = "custom_folder/converted.pdf";
  • Protezione con password - Puoi aggiungere una password al PDF risultante per motivi di sicurezza. Questa opzione viene impostata tramite il parametro password nel metodo convertAndSave (consulta la documentazione API per l’uso esatto).

Regolare queste impostazioni ti aiuta a personalizzare la conversione in base ai requisiti del tuo progetto.

Conclusione

Ora che hai completato il tutorial, dovresti essere in grado di trasformare le diapositive 3D in file PDF direttamente da un’app Node.js utilizzando l’Aspose.Slides Cloud SDK for Node.js. L’SDK si occupa del lavoro pesante di rendering, mentre la REST API sottostante ti offre la flessibilità di chiamare il servizio senza la libreria client. Ricorda di ottenere una licenza valida per qualsiasi distribuzione in produzione, sia acquistando un abbonamento sulla pagina dei prezzi di Aspose sia richiedendo una chiave temporanea dalla pagina di licenza temporanea. Con il codice di esempio e i suggerimenti di configurazione forniti, puoi integrare rapidamente la conversione da 3D a PDF nei tuoi progetti.

FAQ

Come posso convertire 3D in PDF in Node.JS usando Aspose.Slides Cloud SDK?
Utilizza il metodo convertAndSave della classe SlidesApi dopo aver configurato le credenziali del client. Fornisci il nome del file 3D di origine, imposta il formato su "pdf" e specifica un percorso di output.

Quali formati di file 3D supporta l’SDK per la conversione in PDF?
L’SDK supporta OBJ, STL, FBX, 3DS, GLTF, e diversi altri formati 3D standard del settore. Consulta la documentazione per l’elenco completo.

Devo gestire manualmente i token di autenticazione?
No. Una volta impostati clientId e clientSecret nell’oggetto di configurazione, l’SDK ottiene e aggiorna automaticamente il token di accesso per ogni richiesta.

Esiste un limite alla dimensione dei file 3D che posso convertire?
Il servizio cloud accetta file fino a 200 MB. I file più grandi dovrebbero essere suddivisi o compressi prima del caricamento.

Read More