Installation

Tämä opas kattaa kaiken, mitä tarvitset Aspose.3D FOSS:n asentamiseen TypeScriptille ja sen toimivuuden varmistamiseen ennen kuin kirjoitat ensimmäisen 3D‑käsittelyskriptisi.

Ehdellytykset

Varmista, että seuraavat on asennettu ja ovat järjestelmässäsi PATH ennen kuin jatkat:

Tarkista versiosi:

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

Vaihe 1: Luo projekti (tarvittaessa)

Jos lisäät Aspose.3D:n olemassa olevaan TypeScript-projektiin, ohita tämä vaihe ja siirry suoraan vaiheeseen 2.

Uutta projektia varten:

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

Vaihe 2: Asenna @aspose/3d

npm install @aspose/3d

Tämä asentaa paketin ja sen yhden transitiivisen riippuvuuden, xmldom, automaattisesti. Lisäpaketteja, natiivilisäosia tai kääntäjiä ei tarvita. Asennus on valmis, kun @aspose/3d tulee näkyviin package.json kohdassa dependencies.

Vahvista asennus:

ls node_modules/@aspose/3d

Sinun pitäisi nähdä pakettikansio, jossa on package.json, tyyppimäärittelytiedostot (.d.ts), ja käännetty JavaScript.

Vaihe 3: Määritä TypeScript

Lisää tai päivitä tsconfig.json projektisi juurihakemistossa seuraavilla asetuksilla. Nämä vaaditaan täyteen yhteensopivuuteen kirjaston tyyppimäärittelyjen ja CommonJS-ulostulon kanssa:

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

Keskeiset asetukset ja miksi ne ovat tärkeitä:

Vaihe 4: Vahvista asennus

Luo src/verify.ts seuraavalla minimaalisen tuonnin testillä:

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

Käännä ja suorita:

npx tsc
node dist/verify.js

Expected output:

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

Juurisolmun nimi on oletuksena tyhjä merkkijono — scene.rootNode luodaan ilman nimeä-argumenttia.

Jos haluat ohittaa käännösvaiheen kehityksen aikana, suorita suoraan käyttäen ts-node:

npx ts-node src/verify.ts

Vaihe 5: Nopean aloituksen ohje: Lataa kohtaus ja tulosta solmun tiedot

Seuraava skripti lataa 3D-tiedoston ja tulostaa jokaisen kohtauksen solmun nimen ja entiteettityypin. Se toimii kaikilla tuetuilla formaateilla: OBJ, glTF, GLB, STL, 3MF, FBX tai 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);

Tallenna tämä nimellä src/quickstart.ts ja suorita se:

npx ts-node src/quickstart.ts

OBJ-tiedostolle, jossa on yksi verkko nimeltä Cube, tulos näyttää tältä:

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

Juuren solmulla on tyhjä nimi (tulostettu tyhjänä etuliitteenä). Lapsisolmut perivät nimensä ladatusta tiedostosta.

Riippuvuuksien huomautukset

Aspose.3D FOSS for TypeScript:lla on täsmälleen yksi ajonaikainen riippuvuus:

Sinun ei tarvitse asentaa xmldom manuaalisesti. Se ilmestyy sinun node_modules pääasiallisen asennuskomennon jälkeen. Ei ole natiiveja lisäosia (.node tiedostot) eikä järjestelmäkirjastoja vaadita.

Seuraavat askeleet

Kun kirjasto on asennettu ja tarkistettu:

• Lue Kehittäjän opas saadaksesi täydellisen läpikäynnin kaikista ominaisuusalueista.
• Katso Ominaisuudet ja toiminnot saadaksesi tietoja formaattituen yksityiskohdista, kohtausgrafiikkamalleista, materiaali- ja animaatio-API:ista sekä täysistä TypeScript-koodiesimerkeistä.