Instalación

Este guía cubre todo lo que necesita para instalar Aspose.3D FOSS para TypeScript y confirmar que está funcionando correctamente antes de escribir su primer script de procesamiento 3D.

Prerequisites

Asegúrese de que se instalen y en su PATH Antes de proceder:

Para comprobar sus versiones:

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

Paso 1: Crear un proyecto (si es necesario)

Si está añadiendo Aspose.3D a un proyecto de TypeScript existente, pasa este paso y va directamente al paso 2.

Para un nuevo proyecto:

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

Paso 2: Instalar @aspose/3d

Esto instala el paquete y su dependencia transitiva única, xmldom, automáticamente. no se requieren paquetes de sistema adicionales, ads nativos o compiladores. la instalación está completa cuando @aspose/3d Aparece en tu package.json bajo dependencies.

Verifique la instalación:

ls node_modules/@aspose/3d

Debe ver el paquete de la guía con package.json,El tipo de archivo (.d.tsy compiló JavaScript.

Paso 3: Configure TypeScript

Adicionar o actualizar tsconfig.json en su raíz del proyecto con las siguientes configuraciones. Estos son necesarios para la total compatibilidad con la definición de tipo de la biblioteca y el rendimiento CommonJS:

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

Los principales puntos y por qué importan:

Paso 4: Verifique la instalación

Creación src/verify.ts Con el siguiente mínimo de prueba de importación:

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

Compilar y correr:

npx tsc
node dist/verify.js

Producción esperada:

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

El nombre de nodo raíz es una línea vacía por defecto — scene.rootNode Se crea sin argumentos de nombre.

Si prefieres pasar el paso compilado durante el desarrollo, ejecutar directamente con ts-node:

npx ts-node src/verify.ts

Paso 5: Inicio rápido: Cargar una escena y imprimir información de nodo

El siguiente guión carga un archivo 3D y imprime el nombre y tipo de entidad de cada nodo en la escena. funciona con cualquier formato apoyado: OBJ, glTF, GLB, STL, 3MF , FBX o 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);

Salvarlo como src/quickstart.ts y corriendo:

npx ts-node src/quickstart.ts

Para un archivo OBJ con una mezcla llamada Cube,La producción se verá como:

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

El nodo de raíz tiene un nombre vacío (impreso como prefixo blanco). Nodos infantiles heredan sus nombres del archivo cargado.

Dependencias Notas

Aspose.3D FOSS para TypeScript tiene exactamente una dependencia de tiempo de trabajo:

No necesitas instalar xmldom de forma manual. aparecerá en tu node_modules En el caso de los usuarios, no hay ningún tipo de ads (.node archivos) y no se requieren bibliotecas de sistema.

Siguiente pasos

Ahora que la biblioteca está instalada y verificada:

• Leer el Guía de desarrollador para un recorrido completo de todas las áreas características.
• Ver Características y Funcionalidades para los detalles de soporte del formato, patrones de escenografía, APIs de material y animación, y ejemplos completos de código TypeScript.

Ver también

• Aspose.3D para TypeScript - Documentalización de Empresas