Telepítés

Ez az útmutató mindent lefed, amire szükséged van a Aspose.3D FOSS telepítéséhez TypeScripthez, és annak megerősítéséhez, hogy helyesen működik, mielőtt megírnád az első 3D feldolgozó szkriptedet.

Előfeltételek

Biztosítsa, hogy a következők telepítve legyenek és a PATH mielőtt folytatná:

A verziók ellenőrzéséhez:

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

1. lépés: Projekt létrehozása (ha szükséges)

Ha a Aspose.3D-t egy meglévő TypeScript projekthez adod hozzá, hagyd ki ezt a lépést, és lépj közvetlenül a 2. lépésre.

Új projekt esetén:

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

2. lépés: @aspose/3d telepítése

npm install @aspose/3d

Ez telepíti a csomagot és annak egyetlen tranzitív függőségét, xmldom, automatikusan. Nem szükséges további rendszercsomag, natív kiegészítő vagy fordító. A telepítés befejeződik, amikor @aspose/3d megjelenik a package.json alatt dependencies.

A telepítés ellenőrzése:

ls node_modules/@aspose/3d

Látnia kell a csomag könyvtárát a package.json, típusdefiníciós fájlok (.d.ts), és lefordított JavaScript.

3. lépés: TypeScript konfigurálása

Adjon hozzá vagy frissítsen tsconfig.json a projekt gyökerében a következő beállításokkal. Ezek szükségesek a könyvtár típusdefinícióival és a CommonJS kimenettel való teljes kompatibilitáshoz:

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

Fontos beállítások és miért számítanak:

4. lépés: A telepítés ellenőrzése

Hozz létre src/verify.ts a következő minimális import teszttel:

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

Fordítsd le és futtasd:

npx tsc
node dist/verify.js

Expected output:

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

A gyökércsomópont neve alapértelmezés szerint üres karakterlánc — scene.rootNode név argumentum nélkül jön létre.

Ha inkább kihagyod a fordítási lépést fejlesztés közben, futtasd közvetlenül a következővel ts-node:

npx ts-node src/verify.ts

5. lépés: Gyors kezdés: Jelenet betöltése és csomópont információk kiírása

A következő szkript betölt egy 3D fájlt, és kiírja a jelenet minden csomópontjának nevét és entitástípusát. Bármely támogatott formátummal működik: OBJ, glTF, GLB, STL, 3MF, FBX vagy 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);

Mentsd el így src/quickstart.ts és futtasd:

npx ts-node src/quickstart.ts

Egy OBJ fájl esetén, amelynek egyetlen hálója van, név Cube, a kimenet így fog kinézni:

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

A gyökércsomópontnak üres a neve (üres előtagként jelenik meg). A gyermekcsomópontok a betöltött fájlból öröklik a neveiket.

Függőségi megjegyzések

Aspose.3D FOSS for TypeScript pontosan egy futásidejű függőséggel rendelkezik:

Nem kell telepítenie xmldom kézzel. Megjelenik a node_modules a fő telepítési parancs után. Nincsenek natív kiegészítők (.node fájlok) és nincs szükség rendszerkönyvtárakra.

Következő lépések

Most, hogy a könyvtár telepítve és ellenőrizve van:

• Olvassa el a Fejlesztői útmutató az összes funkció területének teljes áttekintéséhez.
• Lásd Funkciók és képességek a formátumtámogatás részleteiért, a jelenetgrafikon mintákért, az anyag- és animációs API-kért, valamint a teljes TypeScript kódpéldákért.