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

Aspose.3D FOSS for TypeScript

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

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

Tanul GitHub

Nyitott 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 kezdj el azonnal 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-kat telepíteni, vagy renderelőt igényelne.

A könyvtár egy teljesen típusos scene-graph API-t tesz elérhetővé, amely 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 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álok normalizálása, 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 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. 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ása és gépelt jelenet-grafikus API

  • ** OBJ / MTL:** A Wavefront OB J fájlok feltöltése a mellékelt anyag meghatározásaival.
  • glTF 2.0 / GLB: PBR-anyag betöltése és bináris GDB kimenete GltfSaveOptions segítségével.
  • STL: Olvasni és írni bináris és ASCII STL teljes körű utazási ellenőrzéssel.
  • COLLADA, 3MF, FBX: További formátum-támogatás a formatonkénti opciós osztályokkal.
  • ** Teljes TypeScript típusok:** Minden osztály, módszer és opció erősen noImplicitAny és strictNullChecks.

Ahol Aspose.3D KÖRZSÍTÁST használhatunk

  • Node.js eszközcsatornák: Behozott OBJ fájlok, validált és újratárgyalt geometria, exportálva GLB-ként a CI-ben.
  • Játékeszközök: 3D-s hálózatok, amelyek nem rendelkeznek saját motorral vagy renderrel.
  • 3D nyomtatási munkafolyamatok: Olvasni, validálni és újraexportálni STL- és 3MF-fájlok.
  • Serverless backends: futtatni 3D konvertációs végpontok Lambda vagy Cloud Funkciók.
  • ** Tartalom-vándorlás:** Egyetlen forgatókönyvből formatcsaládok között átváltás.

A formátumra vonatkozó opciók és a koordinációs ellenőrzés

  • Koordinátarendszer-orientáció: Fordítsa a tengelyeket és állítson be méretét formátumonként, opcióosztályokkal.
  • Normál normalizáció: Automatikusan normálítja a csúcson lévő normális értékeket töltés vagy mentés esetén.
  • Bináris vs. JSON kimeneti: Válassza a kompakt GLB-t vagy az olvasható glTF-et GltfSaveOptions.
  • A anyagok betöltésének ellenőrzése: A gyors elemzéshez engedélyezze vagy letiltsa az MTL/textúra betöltést.
  • Közel utazás: A nem ismert jelenet-grafikus csomópontok szó szerint megőrződnek a újramegmentéskor.

Készítő tapasztalata

A Aspose.3D FOSS for TypeScript egyetlen npm install @aspose/3d parancsgal települ. Nincs hozzáadott kiegészítő, amit összeállítanék. A könyvtár tiszta Type Script/JavaScript egy automatikusan telepített függőséggel (xmldom).

A erősen gépelt API teljes IDE automatikus kitöltését biztosít minden jelenet-grafikus osztály és formátum opció számára. A könyvtár célpontja a Node.js 1822+ és TypeScript 5.0+, azonos módon fut Linux CI futókban és fejlesztői munkaállomásokon, és MIT licencben van egy nyitott probléma nyomon követővel a GitHub-on.

Töltse be az OBJ jelenetet és exportálja glTF-ként

Telepítsd npm‑mel, majd használd a scene.open() ObjLoadOptions kombinációját a háló betöltéséhez az MTL anyagfájljával együtt. A open() és a save() egyaránt szinkronikus — nincs szükség await vagy Promise láncolásra. A scene.save() meghívása egy .gltf kiterjesztéssel szabványos glTF 2.0 JSON fájlt ír — 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-t bináris GLB-re alakítani

A kompakt bináris GLB-t a JSON glTF helyett az GltfSaveOptions és a binaryMode = true átadása érdekében mindkét open(), mind pedig asave() szinkron nincs szükség await -ra.

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 a Aspose.3D FOSS for TypeScript?

Ez egy ingyenes, MIT-licencelt TypeScript/Node.js könyvtár a 3D jelenetek betöltésére, manipulálására és mentésére anélkül, hogy telepítene bármilyen nátív kiegészítést vagy külső SDK-t.

Milyen 3D formátumokat támogatnak?

OBJ (mtl), glTF 2.0 és GLB, STL (bináris és ASCII), COLLADA (DAE), 3MF és FBX. Minden formátumnak van egy dedikált betűzött opció osztályja.

Szükség van-e a Node.js hozzáadásokra?

Nem. Aspose.3D FOSS for TypeScript tiszta JavaScript/TypeScript. Nincs szükség összeállítási lépésre, és egy runtime függőség (xmldom) van automatikusan telepítve npm-ben.

Hogy telepítem?

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

Mely Node.js és TypeScript változatokat támogatnak?

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

Kapható-e TypeScript típusdefinícióval?

Igen. Minden osztály, módszer, enum és opció típus teljesen be van írva a noImplicitAny-val és az strictNullChecks engedélyezettvel.

  • Ellenőrzhetem a koordinátarendszer irányítását?

Igen. A formátumonkénti opciós osztályok, mint például a ObjLoadOptions és aGltfSaveOptions lehetővé teszik az oszlopok fordítását, a skálázást és normális normalizációt egyedi elemző kód nélkül.

Hol találom a forráskódot?

A könyvtár MIT-licencelt és a GitHubon található. Bug jelentések és pull kérelmek szívesen fogadhatók.

  

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

 Magyar