Instalēšana

Šis ceļvedis aptver visu, kas nepieciešams, lai instalētu Aspose.3D FOSS priekš TypeScript un pārliecinātos, ka tas darbojas pareizi, pirms rakstāt savu pirmo 3D apstrādes skriptu.

Priekšnosacījumi

Pārliecinieties, ka sekojošais ir instalēts un atrodas jūsu PATH pirms turpināšanas:

Lai pārbaudītu savas versijas:

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

1. solis: Izveidojiet projektu (ja nepieciešams)

Ja pievienojat Aspose.3D esošam TypeScript projektam, izlaidiet šo soli un pārejiet tieši uz 2. soli.

Ja izveidojat jaunu projektu:

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

2. solis: Instalējiet @aspose/3d

npm install @aspose/3d

Tas instalē pakotni un tās vienīgo transitatīvo atkarību, xmldom, automātiski. Nav vajadzīgas papildu sistēmas pakotnes, vietējie papildinājumi vai kompilatori. Instalēšana ir pabeigta, kad @aspose/3d parādās jūsu package.json zem dependencies.

Pārbaudiet instalāciju:

ls node_modules/@aspose/3d

Jums vajadzētu redzēt pakotnes direktoriju ar package.json, tipa definīcijas failus (.d.ts), un kompilētu JavaScript.

3. solis: Konfigurējiet TypeScript

Pievienojiet vai atjauniniet tsconfig.json jūsu projekta saknē ar šādiem iestatījumiem. Tie ir nepieciešami pilnai saderībai ar bibliotēkas tipa definīcijām un CommonJS izvadi:

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

Galvenie iestatījumi un to nozīme:

4. solis: Pārbaudiet instalāciju

Izveidot src/verify.ts ar sekojošu minimālo importēšanas testu:

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

Kompilējiet un izpildiet:

npx tsc
node dist/verify.js

Sagaidāmais izvadījums:

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

Saknes mezgla nosaukums pēc noklusējuma ir tukša virkne — scene.rootNode tiek izveidots bez nosaukuma argumenta.

Ja vēlaties izlaist kompilācijas soli izstrādes laikā, palaidiet tieši ar ts-node:

npx ts-node src/verify.ts

5. solis: Ātrais sākums: ielādēt ainu un izdrukāt mezgla informāciju

Šis skripts ielādē 3D failu un izdrukā katra mezgla nosaukumu un vienības tipu ainas ietvaros. Tas darbojas ar jebkuru atbalstītu formātu: OBJ, glTF, GLB, STL, 3MF, FBX vai 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);

Saglabājiet šo kā src/quickstart.ts un palaidiet to:

npx ts-node src/quickstart.ts

OBJ failam ar vienu tīklu, kas nosaukts Cube, izvada izskatīsies šādi:

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

Saknes mezglam ir tukšs nosaukums (izdrukāts kā tukša prefikss). Bērnu mezgli pārmanto savus nosaukumus no ielādētā faila.

Atkarību piezīmes

Aspose.3D FOSS for TypeScript ir tieši viena izpildlaika atkarība:

Jums nav jāinstalē xmldom manuāli. Tas parādīsies jūsu node_modules pēc galvenās instalācijas komandas. Nav iebūvētu papildinājumu (.node faili) un nav vajadzīgas sistēmas bibliotēkas.

Nākamie soļi

Tagad, kad bibliotēka ir instalēta un pārbaudīta:

• Izlasiet Developer Guide lai iegūtu pilnīgu pārskatu par visām funkciju jomām.
• Skatiet Funkcijas un iespējas par formāta atbalsta detaļām, ainu grafu modeļiem, materiālu un animācijas API, kā arī pilniem TypeScript koda piemēriem.