Instalação

Este guia abrange tudo o que você precisa para instalar Aspose.3D FOSS for TypeScript e confirmar se ele está funcionando corretamente antes de escrever seu primeiro script de processamento 3D.

Precondições

Certifique-se de que os seguintes dispositivos estão instalados e em seu dispositivo: PATH Antes de proceder:

Para verificar as suas versões:

node --version   # v18.x.x or later
npm --version    # 7.x or later
npx tsc --version  # Version 5.x.x

Passo 1: Criar um Projeto (se necessário)

Se você estiver adicionando Aspose.3D a um projeto TypeScript existente, pule esta etapa e vá diretamente para a Etapa 2.

Para um novo projecto:

mkdir my-3d-project && cd my-3d-project
npm init -y
npm install -D typescript ts-node @types/node

Passo 2: Instalar @aspose/3d

Instala o pacote e a sua dependência transitória única, xmldom,Não são necessários pacotes de sistema adicionais, complementos nativos ou compiladores. A instalação é completa quando o software for instalado no computador e a operação está concluída. @aspose/3d O seu nome aparece no seu e-mail. package.json em: dependencies.

Verificar a instalação:

ls node_modules/@aspose/3d

Deveria ver o diretório de pacotes com: package.json, ficheiros de definição do tipo (.d.ts), e compilado JavaScript.

Passo 3: Configurar o TypeScript

Adicionar ou atualizar tsconfig.json Estas são necessárias para a total compatibilidade com as definições de tipos da biblioteca e o resultado do CommonJS:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*.ts"],
  "exclude": ["node_modules", "dist"]
}

Configurações-chave e por que elas importam:

Passo 4: Verificar a instalação

Criar src/verify.ts com o seguinte ensaio mínimo de importação:

import { Scene } from '@aspose/3d';

const scene = new Scene();
console.log('Aspose.3D FOSS for TypeScript is installed correctly.');
console.log('rootNode name:', scene.rootNode.name);

Compila e executa:

npx tsc
node dist/verify.js

Produção prevista:

Aspose.3D FOSS for TypeScript is installed correctly.
rootNode name:

O nome do nó raiz é uma cadeia vazia por padrão scene.rootNode é criado sem argumento de nome.

Se você preferir pular a etapa de compilação durante o desenvolvimento, execute diretamente com ts-node:

npx ts-node src/verify.ts

Passo 5: Iniciação rápida: carregar uma cena e imprimir a informação do nó

O seguinte script carrega um arquivo 3D e imprime o nome e tipo de entidade de cada nó na cena. Ele funciona com qualquer formato suportado: OBJ, glTF, GLB, STL, 3MF, FBX ou COLLADA.

import { Scene, Node } from '@aspose/3d';

function printNode(node: Node, depth: number = 0): void {
  const indent = '  '.repeat(depth);
  const entityType = node.entity ? node.entity.constructor.name : '(no entity)';
  console.log(`${indent}${node.name} [${entityType}]`);
  for (const child of node.childNodes) {
    printNode(child, depth + 1);
  }
}

const scene = new Scene();

// Replace 'model.obj' with any supported 3D file path.
// Format is detected automatically from binary magic numbers.
scene.open('model.obj');

console.log('Scene loaded. Node hierarchy:');
printNode(scene.rootNode);

Salve isto como: src/quickstart.ts e executá-lo:

npx ts-node src/quickstart.ts

Para um ficheiro OBJ com uma malha nomeada Cube, a saída será como:

Scene loaded. Node hierarchy:
 [(no entity)]
  Cube [Mesh]

O nó raiz tem um nome vazio (impresso como prefixo em branco). Os nós filhos herdam seus nomes do arquivo carregado.

Notas de dependência

Aspose.3D FOSS para TypeScript tem exatamente uma dependência de tempo de execução:

Não é necessário instalar o sistema de xmldom O seu nome aparecerá no seu e-mail. node_modules Não há nenhum complemento nativo (.node arquivos) e não são necessárias bibliotecas de sistema.

Pasos seguintes

Agora que a biblioteca está instalada e verificada:

• Leia o artigo 85.o. Guia de Desenvolvedores Para uma visita completa de todas as áreas especiais.
• Ver também: Características e funcionalidades Para detalhes de suporte a formatos, padrões gráficos de cenas, APIs de materiais e animações e exemplos completos de código TypeScript.

Ver também:

• Aspose.3D para TypeScript Documentação Empresarial