Jak rozpocząć pracę z Aspose.3D FOSS dla typografii TypeScript

@aspose/3d dla TypeScript jest darmowym, licencjonowanym pakietem MIT do ładowania, manipulacji i Zapisywanie plików 3D w Node.js – nie wymagane są native binary, instalowane od npm.

Przewodnik krok po kroku

Krok 1: Instalacja pakietu

Instalacja od npm (Node.js 18 lub później wymagane):

npm install @aspose/3d@24.12.0

Sprawdź, czy instalacja jest prawidłowo ładowana:

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

Krok 2: Import wymaganych klas

Importować klas, które potrzebujesz z pakietu:

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

Krok 3: Pobierz plik 3D

Używanie scene.open() do pobierania dowolnego obsługiwanego formatu. biblioteka wykrywa format automatycznie z rozszerzenia pliku:

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

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

Wykorzystujemy metodę statycznego fabrycznego:

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

Krok 4: Przejdź przez scenę grafiki

„Przemocny sceną jest drzewo Node Obiekty z korzeniami w 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);

Krok 5: Zapisz do innego formatu

Używanie scene.save() do eksportu do dowolnego obsługiwanego formatu wyjścia. biblioteka wykrywa Format wyjścia z rozszerzenia pliku:

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

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

Wspólne problemy i rozwiązania

Error: ENOENT Kiedy zadzwonić scene.open() Droga, którą przeszedłeś nie istnieje. użyj absolutnej drogi lub path.resolve() Aby zapewnić Poczta pliku jest poprawna.

Nieznany błąd formatowy Upewnij się, że rozszerzenie pliku odpowiada rzeczywistemu formatowi. biblioteka wykrywa format przez Rozszerzenie dla open() i fromFile().Przeprowadź wyraźny parametr formatu do przełomu.

Puste miejsce po ładowaniu Niektóre formaty binarne mogą wymagać konkretnych opcji ładowania. spróbuj używać wyraźnego nadładunku z opcjami specyficznymi dla formatu, jeśli domyślne obciążenie wytwarza pustą scenę.

błędy typu import Definicje typu są połączone z pakietem. "moduleResolution": "bundler" lub "node16" Został umieszczony w Twoim tsconfig.json.

Często zadawane pytania

Czy @aspose/3d wymaga żadnych domowych binarów?

Pakiet jest czystej JavaScript/TypeScript bez zależności. działa na każdej platformie obsługującej Node.js 18 lub później.

Jakie wersje Node.js są obsługiwane?

Node.js 18 lub później Pakiet działa na systemach Windows, macOS i Linux.

Czy biblioteka jest wolna do użytku komercyjnego?

Jest on wydany na podstawie licencji MIT. Możesz używać, modyfikować i redistribuować go do jakiegokolwiek celu, w tym aplikacji komercyjnych.

Jakie formaty 3D można czytać i pisać?

Pakiet obsługuje OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i PLY dla obu czytania. i pisanie. użyj rozszerzenia opartego na scene.save() Wywożenie do dowolnego formatu obsługiwanego.

Czy mogę stworzyć scenę 3D z scratch?

Konstrukcja A Scene bez argumentów, dodaj dziecięce węzły do scene.rootNode,i Wystarczy przechowywać w pożądanej formie.