Convertire un modello 3D in un documento PDF consente una facile condivisione e stampa su qualsiasi piattaforma. Aspose.Email Cloud SDK for PHP offre una potente libreria basata sul cloud che gestisce la conversione da 3D a PDF in PHP con poche chiamate API. In questo tutorial vedrai come configurare le credenziali, caricare un file OBJ, avviare la conversione, scaricare il PDF risultante e perfezionare alcune opzioni. Alla fine avrai uno script PHP riutilizzabile che può essere integrato in qualsiasi applicazione web o desktop.

Prima di iniziare: requisiti e installazione

È necessario un ambiente di sviluppo PHP (consigliato PHP 8.0+) e Composer installato. Registrati per un account Aspose Cloud per ottenere il tuo Client Id e Client Secret.

Installa l’SDK con Composer:

composer require aspose/aspose-email-cloud

Scarica il pacchetto SDK se preferisci un’installazione manuale: URL di download.

Il seguente frammento mostra il blocco di configurazione che riutilizzerai in seguito. Sostituisci i valori segnaposto con le credenziali del tuo dashboard di Aspose Cloud.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Aspose\ThreeD\Configuration;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud client credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');          // Client Id
$config->setAppKey('YOUR_CLIENT_SECRET');     // Client Secret
$config->setHost('https://api.aspose.cloud'); // Base URL (default)

Con l’SDK installato e le credenziali pronte, puoi passare ai passaggi effettivi di conversione.

Costruirlo passo dopo passo: conversione da 3D a PDF in PHP

Passo 1: Carica la configurazione e imposta le credenziali

Innanzitutto, crea un oggetto Configuration e imposta il tuo client ID, secret e host. Questo oggetto verrà passato a tutte le istanze API.

$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');
$config->setAppKey('YOUR_CLIENT_SECRET');
$config->setHost('https://api.aspose.cloud');

Passo 2: Inizializzare le istanze API

Crea istanze di StorageApi e ThreeDApi utilizzando l’oggetto di configurazione.

use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;

$storageApi = new StorageApi(null, $config);
$threeDApi   = new ThreeDApi(null, $config);

Passo 3: Carica il file 3D di origine

Carica il tuo file OBJ locale su Aspose Cloud storage in modo che il servizio di conversione possa accedervi.

use Aspose\ThreeD\Model\UploadFileRequest;

$source3DFile = 'sample.obj';   // Input 3D model file
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);

Passo 4: Converti 3D in PDF

Richiedi la conversione da OBJ a PDF. Il nome del file di destinazione è definito da $targetPdfFile.

use Aspose\ThreeD\Model\Convert3DRequest;

$targetPdfFile = 'sample.pdf';  // Desired output PDF name
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);

Passo 5: Scarica il PDF risultante

Recupera il PDF appena creato dallo storage cloud e salvalo localmente.

use Aspose\ThreeD\Model\DownloadFileRequest;

$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());

Passo 6: Pulizia dell’archiviazione

Facoltativamente elimina l’OBJ di origine e il PDF generato dall’archiviazione cloud per mantenere il tuo account ordinato.

$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));

Con questi passaggi completati, hai eseguito con successo una conversione da 3D a PDF in PHP.

Esempio completo di script PHP: conversione 3D in PDF in PHP - Script completo

L’esempio seguente dimostra il flusso di lavoro completo in un unico file. Copialo in un progetto PHP e regola i segnaposto delle credenziali.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Aspose\ThreeD\Configuration;
use Aspose\ThreeD\Api\ThreeDApi;
use Aspose\ThreeD\Api\StorageApi;
use Aspose\ThreeD\Model\UploadFileRequest;
use Aspose\ThreeD\Model\Convert3DRequest;
use Aspose\ThreeD\Model\DownloadFileRequest;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud client credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_CLIENT_ID');          // Client Id
$config->setAppKey('YOUR_CLIENT_SECRET');     // Client Secret
$config->setHost('https://api.aspose.cloud'); // Base URL (default)

// -----------------------------------------------------------------------------
// Initialise API instances
// -----------------------------------------------------------------------------
$storageApi = new StorageApi(null, $config);
$threeDApi   = new ThreeDApi(null, $config);

// -----------------------------------------------------------------------------
// Define source 3D file and target PDF file (paths are relative to the project)
// -----------------------------------------------------------------------------
$source3DFile = 'sample.obj';   // Input 3D model file
$targetPdfFile = 'sample.pdf';  // Desired output PDF name

// -----------------------------------------------------------------------------
// Upload the 3D file to Aspose Cloud storage
// -----------------------------------------------------------------------------
$uploadRequest = new UploadFileRequest($source3DFile, $source3DFile);
$storageApi->uploadFile($uploadRequest);

// -----------------------------------------------------------------------------
// Perform the conversion: 3D → PDF
// -----------------------------------------------------------------------------
$convertRequest = new Convert3DRequest($source3DFile, $targetPdfFile, 'pdf');
$threeDApi->convert3D($convertRequest);

// -----------------------------------------------------------------------------
// Download the resulting PDF back to local storage
// -----------------------------------------------------------------------------
$downloadRequest = new DownloadFileRequest($targetPdfFile);
$response = $storageApi->downloadFile($downloadRequest);
$localPdfPath = __DIR__ . '/output.pdf';
file_put_contents($localPdfPath, $response->getContent());

// -----------------------------------------------------------------------------
// Clean‑up: optionally delete files from cloud storage
// -----------------------------------------------------------------------------
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($source3DFile));
$storageApi->deleteFile(new \Aspose\ThreeD\Model\DeleteFileRequest($targetPdfFile));

echo "3D to PDF conversion completed. PDF saved to: {$localPdfPath}\n";

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo 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 incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Converti modelli 3D usando cURL e l’API REST

Se preferisci lavorare direttamente con gli endpoint REST, i seguenti comandi cURL ottengono lo stesso risultato.

  1. Autenticazione e Ottenimento del 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"

La risposta contiene un access_token utilizzato nelle chiamate successive.

  1. Carica il file OBJ di origine
   curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -T "sample.obj"
  1. Esegui la conversione
   curl -X POST "https://api.aspose.cloud/v3.0/3d/convert/sample.obj?format=pdf&outPath=sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Scarica il PDF di output
   curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o "output.pdf"

Per un elenco completo di parametri e gestione degli errori, vedi il riferimento API.

Opzioni di conversione: impostazioni e regolazioni

L’SDK espone diverse proprietà che è possibile regolare prima di chiamare convert3D:

  • Formato di output - Il terzo argomento di Convert3DRequest definisce il formato di destinazione (pdf in questo tutorial). Cambialo in png o jpeg per l’output immagine.
  • URL host - Se utilizzi un endpoint regionale di Aspose Cloud, modifica $config->setHost('https://api-eu.aspose.cloud');.
  • Timeout - Sia StorageApi che ThreeDApi accettano configurazioni opzionali del client HTTP dove puoi impostare i timeout delle richieste per file di grandi dimensioni.

Queste opzioni ti consentono di personalizzare il processo di conversione in base alle tue esigenze di prestazioni e conformità. Per un elenco completo, consulta il riferimento API.

Conclusione

Hai ora padroneggiato la conversione da 3D a PDF in PHP utilizzando l’Aspose.Email Cloud SDK for PHP. La guida ha coperto tutto, dalla configurazione dell’ambiente a uno script completo, pronto per la produzione, e un’alternativa cURL. Ricorda che l’SDK è un prodotto commerciale; puoi consultare i dettagli dei prezzi nella pagina del prodotto e ottenere una licenza temporanea per la valutazione nella pagina della licenza temporanea. Integra questo flusso di lavoro nelle tue applicazioni per fornire una gestione fluida dei documenti 3D ai tuoi utenti.

Domande frequenti

  • Qual è il modo più semplice per eseguire la conversione da 3D a PDF in PHP?
    Utilizzare l’Aspose.Email Cloud SDK for PHP è il metodo più diretto. La libreria astrae le chiamate REST e consente di convertire modelli 3D in PDF con poche righe di codice.

  • Posso convertire altri formati 3D oltre a OBJ con questa libreria?
    Sì, l’SDK supporta STL, FBX, 3DS e altri formati 3D comuni. Basta cambiare il nome del file di origine e l’SDK gestirà la conversione in PDF.

  • Come gestisco file 3D di grandi dimensioni durante la conversione?
    Carica il file su Aspose Cloud storage prima, quindi avvia la conversione. Questo mantiene basso l’uso della memoria sul tuo server. Per file molto grandi considera di dividerli o di utilizzare l’API di conversione asincrona.

  • È possibile personalizzare l’output PDF, ad esempio la dimensione o l’orientamento della pagina?
    L’API di conversione consente di specificare parametri aggiuntivi nel corpo della richiesta. Consulta il riferimento API per l’elenco completo delle opzioni supportate.

Leggi di più