Converter um modelo 3D em um documento PDF facilita o compartilhamento e a impressão em qualquer plataforma. Aspose.Email Cloud SDK for PHP oferece uma poderosa biblioteca baseada na nuvem que realiza a conversão de 3D para PDF em PHP com apenas algumas chamadas de API. Neste tutorial, você verá como configurar suas credenciais, fazer upload de um arquivo OBJ, invocar a conversão, baixar o PDF resultante e ajustar algumas opções. Ao final, você terá um script PHP reutilizável que pode ser integrado a qualquer aplicação web ou desktop.

Antes de Começar: Pré-requisitos e Instalação

Você precisa de um ambiente de desenvolvimento PHP (recomendado PHP 8.0+) e do Composer instalado. Inscreva‑se em uma conta Aspose Cloud para obter seu Client Id e Client Secret.

Instale o SDK com o Composer:

composer require aspose/aspose-email-cloud

Baixe o pacote SDK se preferir uma instalação manual: Download URL.

O trecho a seguir mostra o bloco de configuração que você reutilizará mais tarde. Substitua os valores de espaço reservado pelas credenciais do seu painel 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)

Com o SDK instalado e as credenciais prontas, você pode prosseguir para as etapas reais de conversão.

Construindo passo a passo: Conversão de 3D para PDF em PHP

Etapa 1: Carregar Configuração e Definir Credenciais

Primeiro, crie um objeto Configuration e defina seu ID de cliente, segredo e host. Este objeto será passado para todas as instâncias da API.

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

Etapa 2: Inicializar Instâncias da API

Crie instâncias de StorageApi e ThreeDApi usando o objeto de configuração.

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

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

Etapa 3: Carregar Arquivo 3D de Origem

Faça upload do seu arquivo OBJ local para o armazenamento Aspose Cloud para que o serviço de conversão possa acessá‑lo.

use Aspose\ThreeD\Model\UploadFileRequest;

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

Passo 4: Converter 3D para PDF

Solicite a conversão de OBJ para PDF. O nome do arquivo de destino é definido por $targetPdfFile.

use Aspose\ThreeD\Model\Convert3DRequest;

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

Etapa 5: Baixar PDF resultante

Recupere o PDF recém‑criado do armazenamento em nuvem e salve‑o localmente.

use Aspose\ThreeD\Model\DownloadFileRequest;

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

Etapa 6: Limpar o Armazenamento

Opcionalmente, exclua o OBJ de origem e o PDF gerado do armazenamento em nuvem para manter sua conta organizada.

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

Com estas etapas concluídas, você realizou com sucesso uma conversão de 3D para PDF em PHP.

Exemplo completo de script PHP: Conversão de 3D para PDF em PHP - Script completo

O exemplo abaixo demonstra o fluxo de trabalho completo em um único arquivo. Copie‑o para um projeto PHP e ajuste os marcadores de credenciais.

<?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: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Converter modelos 3D usando cURL e a API REST

Se preferir trabalhar diretamente com os endpoints REST, os seguintes comandos cURL produzem o mesmo resultado.

  1. Autenticar e Obter Token de Acesso

Substitua YOUR_CLIENT_ID e YOUR_CLIENT_SECRET pelas suas credenciais.

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"

A resposta contém um access_token usado nas chamadas subsequentes.

  1. Carregar o arquivo OBJ de origem
curl -X PUT "https://api.aspose.cloud/v3.0/3d/storage/file/sample.obj" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.obj"
  1. Execute a Conversão
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. Baixe o PDF de saída
curl -X GET "https://api.aspose.cloud/v3.0/3d/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "output.pdf"

Para uma lista completa de parâmetros e tratamento de erros, veja a referência da API.

Opções de Conversão: Configurações e Ajustes

O SDK expõe várias propriedades que você pode ajustar antes de chamar convert3D:

  • Formato de Saída - O terceiro argumento de Convert3DRequest define o formato de destino (pdf neste tutorial). Altere para png ou jpeg para saída de imagem.
  • URL do Host - Se você usar um endpoint regional do Aspose Cloud, modifique $config->setHost('https://api-eu.aspose.cloud');.
  • Limites de tempo - Tanto StorageApi quanto ThreeDApi aceitam configurações opcionais de cliente HTTP onde você pode definir limites de tempo de requisição para arquivos grandes.

Essas opções permitem que você ajuste o processo de conversão de acordo com seus requisitos de desempenho e conformidade. Para obter uma lista completa, consulte a referência da API.

Conclusão

Você agora dominou a conversão de 3D para PDF em PHP usando o Aspose.Email Cloud SDK for PHP. O guia cobriu tudo, desde a configuração do ambiente até um script completo, pronto para produção, e uma alternativa cURL. Lembre‑se de que o SDK é um produto comercial; você pode revisar os detalhes de preços na página do produto e obter uma licença temporária para avaliação na página de licença temporária. Integre este fluxo de trabalho em suas próprias aplicações para fornecer um manuseio de documentos 3D perfeito para seus usuários.

FAQs

  • Qual é a maneira mais fácil de realizar a conversão de 3D para PDF em PHP?
    Usar o Aspose.Email Cloud SDK for PHP é o método mais direto. A biblioteca abstrai as chamadas REST e permite converter modelos 3D para PDF com apenas algumas linhas de código.

  • Posso converter outros formatos 3D além de OBJ com esta biblioteca?
    Sim, o SDK suporta STL, FBX, 3DS e outros formatos 3D comuns. Basta alterar o nome do arquivo de origem e o SDK cuidará da conversão para PDF.

  • Como lidar com arquivos 3D grandes durante a conversão?
    Carregue o arquivo no armazenamento Aspose Cloud primeiro, depois inicie a conversão. Isso mantém o uso de memória baixo no seu servidor. Para arquivos muito grandes, considere dividi-los ou usar a API de conversão assíncrona.

  • Existe uma maneira de personalizar a saída PDF, como tamanho ou orientação da página?
    A API de conversão permite especificar parâmetros adicionais no corpo da solicitação. Consulte a referência da API para a lista completa de opções suportadas.

Read More