Como começar com Aspose.3D FOSS para TypeScript

@aspose/3d para TypeScript é um pacote gratuito, licenciado pelo MIT para carregamento, manipulação e salvar arquivos 3D em Node.js — nenhuma binária nativa necessária, instalável a partir de npm.

Guia passo a passo

Passo 1: Instale o pacote

Instalar a partir de npm (Node.js 18 ou posterior requerido):

npm install @aspose/3d@24.12.0

Verifique o instalador carregado corretamente:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

Passo 2: Importar as classes necessárias

Importar as aulas que você precisa do pacote:

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

Passo 3: Carregar um arquivo 3D

Usando scene.open() para carregar qualquer formato suportado. a biblioteca detecta o formato automaticamente da extensão de arquivo:

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

const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);

Ou use o método fábrica estático:

const scene = Scene.fromFile("model.glb");

Passo 4: atravessar o gráfico da cena

Uma cena carregada é uma árvore de Node Objetos que se enraizam em scene.rootNode:

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

function walk(node: Node, depth: number = 0): void {
    const indent = " ".repeat(depth * 2);
    console.log(`${indent}Node: ${node.name}`);
    for (const child of node.childNodes) {
        walk(child, depth + 1);
    }
}

const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);

Passo 5: Salve para um formato diferente

Usando scene.save() para exportar a qualquer formato de saída suportado.A biblioteca detecta o Formato de saída da extensão do arquivo:

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

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

Problemas comuns e fixos

Error: ENOENT Quando chamar scene.open() O caminho que você passou não existe.Utiliza um caminho absoluto ou path.resolve() Para garantir O caminho do arquivo é correto.

Erro de formato desconhecido Assegure-se que a extensão de arquivo corresponde ao formato real.A biblioteca detecta o formato por meio do Extensão para open() e fromFile().Passar um parâmetro de formato explícito para sobrecarregar.

A cena vazia após o carregamento Alguns formatos binários podem exigir opções de carga específicas. tente usar o expresso sobrecarga com opções específicas de formato se a carga padrão produz uma cena vazia.

Tipo de erros de importação As definições de tipo estão ligadas ao pacote. assegura-se "moduleResolution": "bundler" ou "node16" Está estabelecido em seu tsconfig.json.

Perguntas frequentes

@aspose/3d requer qualquer binário nativo?

O pacote é puro JavaScript/TypeScript sem dependências nativas. Ele funciona em qualquer plataforma que suporta Node.js 18 ou mais tarde.

Quais versões do Node.js são suportadas?

Node.js 18 ou mais tarde. o pacote funciona em Windows, macOS e Linux.

A biblioteca é livre para uso comercial?

É lançado sob a Licença MIT. Você pode usá-lo, modificar e redistribuir para qualquer finalidade, incluindo aplicações comerciais.

Quais os formatos 3D que eu posso ler e escrever?

O pacote suporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA e PLY para ambos a leitura. e escrever. Use a extensão-base scene.save() para exportar a qualquer formato suportado.

Posso criar uma cena 3D de escorregamento?

Construindo a Scene sem argumentos, adicione os nodos da criança para scene.rootNode,e Acompanhe o formato desejado.