API Overview — @aspose/3d for TypeScript
Paket: @aspose/3d (v24.12.0) Jezik: TypeScript / Node.js 18+ Licenca: MIT
@aspose/3d je biblioteka pod MIT licencom za čitanje, konstruisanje i izvoz 3D scena u Node.js. Dostavlja se sa kompletnim TypeScript definicijama tipova, jednim runtime zavisnošću.xmldom), i podržava sedam glavnih 3D formata datoteka. Sav I/O je sinhronizovan. Nema potrebe za native addons.
npm install @aspose/3d{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"moduleResolution": "node",
"esModuleInterop": true,
"strict": true
}
}Osnovne klase
Koreni kontejner za 3D scenu. Sav sadržaj; čvorovi, geometrija, materijali i animacije; se čuva u stablu čiji koren je scene.rootNode.Koristite open() / openFromBuffer() za učitavanje datoteke i save() / saveToBuffer() za izvoz.
| —————————- | ——————————— | ——————————————————— |
| rootNode | Node | Koren grafika scene |
| assetInfo | AssetInfo | Metapodaci datoteke (autor, jedinice, koordinatni sistem) |
| animationClips | AnimationClip[] | Svi animacioni klipovi u sceni |
| open(path, opts?) | (string, LoadOptions?) → void | Učitajte datoteku sa diska |
| openFromBuffer(buf, opts?) | (Buffer, LoadOptions?) → void | Učitaj iz memorijskog bafera |
| save(path, opts?) | Transform | Sačuvaj na disk (format se zaključuje iz ekstenzije) |
| saveToBuffer(ext, opts?) | (string, SaveOptions?) → Buffer | Sačuvaj u memorijski bafer |
| createAnimationClip(name) | (string) → AnimationClip | Kreiraj i registruj novi animacioni klip |
Imenovani čvor stabla u grafu scene. Čvorovi nose opcioni Entity (mesh, kamera, svetlo) i Transform koji pozicionira čvor relativno u odnosu na njegovog roditelja.
| ————————- | ————————- | ————————————— |
| name | string | Ime čvora |
| childNodes | Node[] | Direktni podređeni čvorovi |
| entity | Entity | null | Prikačena geometrija, kamera ili svetlo |
| transform | Transform | Lokalna translacija, rotacija, skala |
| materials | Material[] | Materijali dodeljeni ovom čvoru |
| createChildNode(name) | (string) → Node | Dodaj podređeni čvor |
| getChildNode(name) | (string) → Node | null | Nađi podređeni čvor po imenu |
Poligonalna mreža; primarni tip geometrije. Proširuje Geometry.
| ————————- | ——————————————– | ————————————— |
| controlPoints | Vector4[] | Pozicije vrhova (w=1 za pozicije) |
| polygonCount | number | Broj poligona |
| createPolygon(indices) | (number[]) → void | Dodaj poligon (trougao ili četvorougao) |
| getElement(type) | (VertexElementType) → VertexElement | null | Preuzmi element vrha po semantički |
| createElement(type) | (VertexElementType) → VertexElement | Kreiraj element vrha |
Lokalna transformacija primenjena na čvor.
| ————————- | ————————- | ——————————————– |
| translation | Vector3 | Lokalna pozicija |
| eulerAngles | Vector3 | Eulerova rotacija u stepenima (redosled XYZ) |
| rotation | Quaternion | Rotacija kao kvaternion |
| scaling | Vector3 | Lokalna skala |
Klase materijala
| ————————- | ————————————- | ————————————————————– |
| LambertMaterial | Difuzno + ambijentalno senčenje | diffuseColor, ambientColor, transparency |
| PhongMaterial | Dodaje spekularno + emisivno Lambertu | specularColor, shininess, emissiveColor |
| PbrMaterial | Fizički zasnovano za glTF 2.0 | albedo, metallicFactor, roughnessFactor, emissiveColor |
Matematičke klase
| ————————- | ———————————————————————————- |
| Vector3 | 3-component double-precision vector (x, y, z) |
| Vector4 | 4-component vector for homogeneous math (x, y, z, w) |
| FVector3 | Varijanta single-precision korišćena u podacima vrhova |
| Matrix4 | 4×4 transformation matrix; multiply, invert, decompose |
| Quaternion | Kvaternion rotacije; fromEulerAngle, toEulerAngles, slerp |
| BoundingBox | Okvir ograničenja poravnat na ose; minimum, maximum, center, size, merge |
Klase animacija
| ————————- | ————————————————————————————– |
| AnimationClip | Imenovani klip; sadrži AnimationNode lista; pristupa se putem scene.animationClips |
| AnimationNode | Povezuje klip sa imenovanim čvorom scene; sadrži AnimationChannel lista |
| AnimationChannel | Cilja pojedinačno svojstvo (npr. translacija X); drži KeyframeSequence |
| KeyframeSequence | Uređena lista KeyFrame objekte sa interpolation i extrapolation |
| KeyFrame | Jedan par vreme/vrednost |
| ————————- | ————————————————————– | ———————————————- |
| VertexElementType | NORMAL, UV, VERTEX_COLOR, BINORMAL, TANGENT | Semantika elementa vrha |
| MappingMode | CONTROL_POINT, POLYGON_VERTEX, POLYGON, ALL_SAME | Kako se podaci mapiraju na geometriju |
| ReferenceMode | DIRECT, INDEX, INDEX_TO_DIRECT | Strategija indeksiranja podataka elementa vrha |
| Interpolation | CONSTANT, LINEAR, BEZIER | Interpolacija ključnih frejmova |
| Extrapolation | CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE | Ponašanje izvan opsega ključnih frejmova |
Moduli formata
Klase opcija specifičnih za format se izvoze iz pod-modula. Uvezite ih odvojeno:
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';
import { StlLoadOptions, StlSaveOptions } from '@aspose/3d/formats/stl';
import { FbxLoadOptions, FbxSaveOptions } from '@aspose/3d/formats/fbx';
import { ColladaLoadOptions } from '@aspose/3d/formats/collada';
import { ThreeMfSaveOptions } from '@aspose/3d/formats/3mf';OBJ modul (@aspose/3d/formats/obj)
| ————————- | ——————————————————————— |
| ObjLoadOptions | enableMaterials, flipCoordinateSystem, scale, normalizeNormal |
glTF/GLB modul (@aspose/3d/formats/gltf)
| ————————- | ————————————————————– |
| GltfSaveOptions | binaryMode (true → .glb), flipTexCoordV |
| GltfFormat | GltfFormat.getInstance(): instanca formata za scene.save() |
STL modul (@aspose/3d/formats/stl)
| ————————- | ——————————————– |
| StlLoadOptions | N/A |
| StlSaveOptions | binaryMode (false → ASCII, true → binarni) |
FBX modul (@aspose/3d/formats/fbx)
| ————————- | ————— |
| FbxLoadOptions | N/A |
| FbxSaveOptions | embedTextures |
Podržani formati
| ————————- | ————————- | ————————- | ————————- |
| FBX | .fbx | Ne* | Ne* |
Brzi referentni primer
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
// Load OBJ with materials
const scene = new Scene();
const loadOpts = new ObjLoadOptions();
loadOpts.enableMaterials = true;
scene.open('input.obj', loadOpts);
// Inspect root nodes
for (const node of scene.rootNode.childNodes) {
console.log(`Node: ${node.name}, entity: ${node.entity?.constructor.name}`);
}
// Export as GLB (binary glTF)
const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true;
scene.save('output.glb', saveOpts);