1. Termékek
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

Tölts be, építs fel, transzformálj és exportálj 3D jeleneteket Node.js-ből — teljesen típusos, nyílt forráskódú és termelésre kész egyetlen npm telepítéssel.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Tanul GitHub

Nyílt forráskódú TypeScript könyvtár 3D fájlfeldolgozáshoz

Aspose.3D FOSS for TypeScript egy MIT-licencű könyvtár 3D fájlformátumokkal való munkához Node.js alkalmazásokban. Telepítsd egyetlen npm install @aspose/3d paranccsal, és azonnal elkezdhetsz 3D jeleneteket olvasni, építeni és írni TypeScriptben, anélkül, hogy natív kiegészítőket kellene lefordítani, külső SDK-kat telepíteni, vagy renderelőt igényelne.

A könyvtár egy teljesen típusos jelenetgrafikus API-t tesz elérhetővé, amely a Scene, Node, Entity, Mesh, Camera, Light és Transform köré épül, ugyanazt a koncepcionális modellt használva, mint a professzionális 3D eszközök. A támogatott formátumok közé tartozik az OBJ (Wavefront, .mtl anyagbetöltéssel), a glTF 2.0 és a GLB bináris (PBR anyagok), az STL (bináris és ASCII, teljes körúton), a COLLADA (DAE), a 3MF és az FBX. Formátumonkénti opcióosztályok, például ObjLoadOptions és GltfSaveOptions, pontos vezérlést biztosítanak a koordináta-rendszer orientációja, méretezés, normál normalizálás, bináris vs. JSON kimenet és anyagbetöltés felett.

Aspose.3D FOSS a Node.js 18, 20 és 22+ verziókat célozza meg TypeScript 5.0+ támogatással, és CommonJS-re fordul. A könyvtár szigorú TypeScript fordítóbeállításokkal (noImplicitAny, strictNullChecks) érkezik, így az IDE teljes automatikus kiegészítést és fordítási időbeli biztonságot nyújt. Az egyetlen futásidejű függősége, a xmldom, automatikusan települ.

3D formátum támogatás és típusos jelenetgrafikon API

  • OBJ / MTL: Wavefront OBJ fájlok betöltése a hozzájuk tartozó anyagleírásokkal.
  • glTF 2.0 / GLB: PBR anyagbetöltés és bináris GLB kimenet a GltfSaveOptions segítségével.
  • STL: Bináris és ASCII STL fájlok olvasása és írása teljes körúton történő ellenőrzéssel.
  • COLLADA, 3MF, FBX: További formátumtámogatás formátumonkénti opcióosztályokkal.
  • Teljes TypeScript típusok: Minden osztály, metódus és opció erősen típusos a noImplicitAny és strictNullChecks beállításokkal.

Ahol a Aspose.3D FOSS használható

  • Node.js eszközcsővezetékek: OBJ fájlok importálása, validálása és a geometria újraorientálása, majd GLB exportálása CI-ben.
  • Játék eszközök: 3D hálók kötegelt feldolgozása natív motor vagy renderelő nélkül.
  • 3D nyomtatási munkafolyamatok: STL és 3MF fájlok olvasása, validálása és újraexportálása.
  • Serverless backends: 3D konverziós végpontok futtatása Lambda vagy Cloud Functions környezetben.
  • Content migration: Formátumcsaládok közötti átalakítás nagy léptékben egyetlen szkriptből.

Formátumonkénti beállítások és koordináta vezérlés

  • Koordináta-rendszer orientációja: Tengelyek megfordítása és a méretezés igazítása formátumonként opcióosztályokkal.
  • Normál normalizálás: A csúcspontok normáljait automatikusan normalizálja betöltéskor vagy mentéskor.
  • Bináris vs. JSON kimenet: Válasszon kompakt GLB vagy olvasható glTF formátumot a GltfSaveOptions segítségével.
  • Anyagbetöltés vezérlése: Engedélyezze vagy tiltsa le az MTL/textúra betöltését a gyorsabb elemzés érdekében.
  • Körkörös hűség: Az ismeretlen jelenetgrafikon csomópontok szó szerint megmaradnak az újramentéskor.

Fejlesztői élmény

Aspose.3D FOSS TypeScript telepítésekhez egyetlen npm install @aspose/3d paranccsal. Nincsenek natív kiegészítők, amiket le kellene fordítani. A könyvtár tiszta TypeScript/JavaScript, egy automatikusan telepített függőséggel (xmldom).

A erősen típusos API teljes IDE automatikus kiegészítést biztosít minden jelenetgraf osztályhoz és formátum opcióhoz. A könyvtár a Node.js 18–22+ és a TypeScript 5.0+ verziókra céloz, azonos módon fut Linux CI futtatókon és fejlesztői munkaállomásokon, és MIT licenc alatt áll, nyílt hibakövetővel a GitHubon.

OBJ jelenet betöltése és exportálása glTF formátumba

Telepítsd npm-mel, majd használd a szinkron scene.open() metódust ObjLoadOptions-szel a háló betöltéséhez az MTL anyagfájllal együtt. A scene.save() .gltf kiterjesztéssel hívva szabványos glTF 2.0 JSON-t ír; a formátumot a fájlkiterjesztés alapján automatikusan meghatározza.

npm install @aspose/3d

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

const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());

// Exportálás glTF 2.0 JSON formátumba
scene.save("model.gltf");

STL konvertálása bináris GLB formátumba

A kompakt bináris GLB előállításához az alapértelmezett JSON glTF helyett adja meg a GltfSaveOptions-t a binaryMode = true beállítással.

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

const scene = new Scene();
scene.open("mesh.stl");

// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

Mi a Aspose.3D FOSS a TypeScript-hez?

Ez egy ingyenes, MIT‑licencű TypeScript/Node.js könyvtár 3D jelenetek betöltésére, manipulálására és mentésére, anélkül, hogy natív kiegészítőt vagy külső SDK‑t telepítenénk.

Mely 3D formátumok támogatottak?

OBJ (a .mtl fájllal), glTF 2.0 és GLB, STL (bináris és ASCII), COLLADA (DAE), 3MF és FBX. Minden formátumnak saját típusos beállításosztálya van.

Igényel natív Node.js kiegészítőket?

Nem. Aspose.3D FOSS for TypeScript tiszta JavaScript/TypeScript. Nem igényel fordítási lépést, és egyetlen futásidejű függősége van (xmldom), amelyet az npm automatikusan telepít.

Hogyan telepítem?

Futtassa a npm install @aspose/3d parancsot. Nem szükségesek további rendszercsomagok vagy natív kiegészítők.

Mely Node.js és TypeScript verziók támogatottak?

Node.js 18, 20 és 22+. TypeScript 5.0+. A könyvtár CommonJS-re fordul, és szigorú TypeScript beállításokkal működik.

Tartalmaz-e TypeScript típusdefiníciókat?

Igen. Minden osztály, metódus, enum és opciótípus teljesen tipizált a noImplicitAny és a strictNullChecks engedélyezésével.

Irányíthatom-e a koordináta‑rendszer orientációját?

Igen. Formátumonkénti opcióosztályok, mint a ObjLoadOptions és a GltfSaveOptions, lehetővé teszik a tengelyek megfordítását, a méretezés beállítását és a normálok normalizálását egyedi elemzőkód nélkül.

Hol találom a forráskódot?

A könyvtár MIT licenc alatt áll, és a GitHubon van tárolva. Hibajelentések és pull requestek szívesen fogadottak.

  

Támogatás és tanulási források

 Magyar