Instalace

Tato příručka pokrývá vše, co potřebujete k instalaci Aspose.3D FOSS pro TypeScript a potvrdit, že funguje správně před tím, než napíšete svůj první 3D zpracování skriptu.

Předpoklady

Ujistěte se, že jsou nainstalovány následující a vaše zařízení: PATH před zahájením řízení:

Pro ověření vašich verzí:

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

Krok 1: Vytvořte projekt (pokud je to nutné)

Pokud přidáte Aspose.3D k existujícímu projektu TypeScript, přeskočte tento krok a přejděte přímo na krok 2.

Pro nový projekt:

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

Krok 2: Nainstalujte @aspose/3d

Tím se nainstaluje balíček a jeho jednotná přechodná závislost, xmldom,Není potřeba žádné další systémové balíčky, nativní doplňky ani kompilátory. Instalace je dokončena až po ukončení instalace. @aspose/3d se objevuje ve Vašem package.json pod: dependencies.

Ověřte instalaci:

ls node_modules/@aspose/3d

Paketní adresář by měl být zobrazen s: package.json, soubory definice typu (.d.ts), a kompiloval JavaScript.

Krok 3: Konfigurovat TypeScript

Přidání nebo aktualizace tsconfig.json Tyto nastavení jsou nutné pro plnou kompatibilitu s definicemi typů knihovny a výstupem CommonJS:

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

Klíčové nastavení a proč je důležité:

Krok 4: Ověřte instalaci

Vytvořit src/verify.ts s následujícím minimálním dovozním testem:

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

Kompilace a spuštění:

npx tsc
node dist/verify.js

Očekávaný výstup:

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

Název kořenového uzlu je výchozím nastavením prázdný řetěz scene.rootNode je vytvořena bez názvu argumentu.

Pokud chcete přeskočit krok kompilování během vývoje, běžte přímo s ts-node:

npx ts-node src/verify.ts

Krok 5: Rychlý start: Nahrát scénu a vytisknout informace o uzlu

Následující skript načte 3D soubor a vytiskne název a typ entity každého uzlu v scéně. Funguje s jakýmkoliv podporovaným formátem: OBJ, glTF, GLB, STL, 3MF, FBX nebo 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);

Uložte to jako: src/quickstart.ts a spustí:

npx ts-node src/quickstart.ts

Pro soubor OBJ s jedním jmenovaným mřížkem Cube, výstup bude vypadat takto:

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

Rootový uzel má prázdný název (vytisknutý jako prázdná předponě). Dítě nody zdědí své jména z načteného souboru.

Poznámky o závislosti

Aspose.3D FOSS pro TypeScript má přesně jednu závislost na čase běhu:

Není třeba instalovat xmldom Zobrazí se ve Vašem příspěvku. node_modules Po hlavním příkazu instalace. Žádné nativní doplňky (.node soubory) a nejsou vyžadovány žádné systémové knihovny.

Další kroky

Nyní, když je knihovna nainstalována a ověřena:

• Přečtěte si: Příručka pro vývojáře pro kompletní prohlídku všech oblastí.
• Viz. článek: Charakteristika a funkčnost pro podrobnosti o podpoře formátu, vzorce scén-grafu, API materiálů a animací a úplné příklady kódu TypeScript.