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

Aspose.3D FOSS a TypeScript-hez

Tölts be, építs, 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 alatt álló könyvtár, amely 3D fájlformátumokkal való munkához nyújt támogatást Node.js alkalmazásokban. Telepítsd egyetlen npm install @aspose/3d paranccsal, és azonnal elkezdhetsz 3D jeleneteket olvasni, felépíteni és írni TypeScriptben, anélkül, hogy natív kiegészítőket kellene lefordítani, külső SDK-ket telepíteni, vagy renderert 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, amelyet a professzionális 3D eszközök használnak. A formátumtámogatás magában foglalja az OBJ-t (Wavefront, .mtl anyagbetöltéssel), a glTF 2.0-t és a GLB binárist (PBR anyagok), az STL-t (bináris és ASCII, teljes körúton), a COLLADA-t (DAE), a 3MF-et és az FBX-et. Formátumonkénti opcióosztályok, mint a ObjLoadOptions és a GltfSaveOptions, pontos vezérlést biztosítanak a koordináta‑rendszer orientációja, a méretezés, a normál normalizálás, a bináris vs. JSON kimenet és az anyagbetöltés felett.

Aspose.3D FOSS a Node.js 18, 20 és 22+ verziókat célozza meg TypeScript 5.0+ használatával, és CommonJS-re fordít. 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 biztosít. Egyetlen futásidejű függősége, a xmldom, automatikusan települ. Az vállalati termékcsaládért lásd a Aspose.3D — Enterprise Product Family.

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

  • OBJ / MTL: Töltsön be Wavefront OBJ fájlokat a kísérő anyagdefiníciókkal.
  • glTF 2.0 / GLB: PBR anyag betöltése és bináris GLB kimenet a GltfSaveOptions segítségével.
  • STL: Olvassa és írja mind a bináris, mind az ASCII STL-t teljes körúti ellenőrzéssel.
  • COLLADA, 3MF, FBX: További formátumtámogatás formátumonkénti opcióosztályokkal.
  • Full TypeScript types: Minden osztály, metódus és opció erősen típusos a noImplicitAny és strictNullChecks segítségével.

Ahol a Aspose.3D FOSS felhasználható

  • Node.js asset pipelines: OBJ fájlok importálása, geometria ellenőrzése és újraorientálása, majd GLB exportálása CI-ben.
  • Game tooling: Kötegelt feldolgozás 3D hálókra natív motor vagy renderelő nélkül.
  • 3D nyomtatási munkafolyamatok: Olvasás, ellenőrzés és újraexportálás STL és 3MF fájlok.
  • Serverless háttérprogramok: Futtass 3D konverziós végpontokat a Lambda vagy a Cloud Functions környezetben.
  • Tartalom migráció: Konvertáljon formátumcsaládok között 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ó: Tengelyek megfordítása és a méretezés beállítása formátumonként opcióosztályokkal.
  • Normál normalizálás: Automatikusan normalizálja a csúcsnormálokat betöltéskor vagy mentéskor.
  • Bináris vs. JSON kimenet: Válasszon kompakt GLB-t vagy olvasható glTF-t 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éshez.
  • Round-trip fidelity: Ismeretlen scene-graph csomópontok szó szerint megmaradnak az újramentéskor.

Fejlesztői élmény

Aspose.3D FOSS for TypeScript egyetlen npm install @aspose/3d parancs segítségével telepíthető. Nincsenek natív kiegészítők, amelyeket le kell fordítani. A könyvtár tiszta TypeScript/JavaScript, egy automatikusan telepített függőséggel (xmldom).

Az erősen típusos API teljes IDE automatikus kiegészítést biztosít minden jelenetgrafikon osztályhoz és formátum opcióhoz. A könyvtár a Node.js 18–22+ és a TypeScript 5.0+ verziókat célozza, azonos módon fut Linux CI futtatókon és fejlesztői munkaállomásokon, és MIT-licencű, 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 scene.open() a ObjLoadOptions segítségével a háló betöltéséhez az MTL anyagfájljával együtt. Mind a open(), mind a save() szinkron — nincs szükség await vagy Promise láncolásra. A scene.save() hívása egy .gltf kiterjesztéssel szabványos glTF 2.0 JSON ír ki — a formátum automatikusan a fájlkiterjesztésből kerül meghatározásra.

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 as glTF 2.0 JSON
scene.save("model.gltf");

STL konvertálása bináris GLB-re

A kompakt bináris GLB előállításához az alapértelmezett JSON glTF helyett, adja meg a GltfSaveOptions értékét a binaryMode = true segítségével. A open() és a save() egyaránt szinkron — nincs szükség await.

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

Gyakran ismételt kérdések

Mi az 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átumhoz dedikált típusos beállítási osztály tartozik.

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

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

Hogyan telepítem?

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

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.

Szállít-e TypeScript típusdefiníciókat?

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

Irányíthatom 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éseket és pull requesteket szívesen fogadunk.

  

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

 Magyar