Csomag: @aspose/3d (v24.12.0) Nyelv: TypeScript / Node.js 18+ Licenc: MIT
@aspose/3d egy MIT-licencű könyvtár 3D jelenetek olvasásához, felépítéséhez és exportálásához Node.js környezetben. Teljes TypeScript típusdefiníciókkal érkezik, egyetlen futásidejű függőséggel ( «<SEG_7»> ), és hét fő 3D fájlformátumot támogat. Minden I/O szinkron. Nincsenek natív kiegészítők szükségesek.xmldom), és hét fő 3D fájlformátumot támogat. Minden I/O szinkron. Nincsenek natív kiegészítők szükségesek.
Enumerations
Enumerations tsconfig.json beállítások a helyes alútvonal feloldásához:
API-referencia a Aspose.Slides FOSS C++-hoz tartozó helykitöltő támogatáshoz. A helykitöltő alakzatok a elrendezés és diakép sablonok tartalmi területeit határozzák meg.
Enumerations
A 3D jelenet gyökérkonténere. Minden tartalom; csomópontok, geometria, anyagok és animációk; egy, a következőn gyökerező fában tárolódik: scene.rootNode.Használja open() / openFromBuffer() fájl betöltéséhez és save() / saveToBuffer() exportáláshoz.
| Enumerations | Enumerations | Enumerations |
|---|
rootNode | Node | A jelenet gráf gyökere |
assetInfo | AssetInfo | Fájl metaadatok (készítő, egységek, koordináta-rendszer) |
animationClips | AnimationClip[] | Az összes animációs klipek a jelenetben |
open(path, opts?) | (string, LoadOptions?) → void | Fájl betöltése lemezről |
openFromBuffer(buf, opts?) | (Buffer, LoadOptions?) → void | Betöltés a memóriában lévő pufferből |
save(path, opts?) | (string, SaveOptions?) → void | Mentés lemezre (a formátum a kiterjesztésből következtethető) |
saveToBuffer(ext, opts?) | (string, SaveOptions?) → Buffer | Mentés a memóriában lévő pufferbe |
createAnimationClip(name) | (string) → AnimationClip | Új animációs klip létrehozása és regisztrálása |
Enumerations
Egy elnevezett fa csomópont a jelenet gráfjában. A csomópontok opcionálisan tartalmaznak Entity (mesh, camera, light) és egy Transform amely a csomópontot a szülőjéhez viszonyítva helyezi el.
| Enumerations | Enumerations | Enumerations |
|---|
name | string | Csomópont neve |
childNodes | Node[] | Közvetlen gyermek csomópontok |
entity | `Entity | null` |
transform | Transform | Helyi eltolás, forgatás, méretezés |
materials | Material[] | Ehhez a csomóponthoz rendelt anyagok |
createChildNode(name) | (string) → Node | Gyermek csomópont hozzáadása |
getChildNode(name) | `(string) → Node | null` |
Enumerations
Poligon háló; az elsődleges geometria típus. Kiterjeszti Geometry.
| Enumerations | Enumerations | Enumerations |
|---|
controlPoints | Vector4[] | Csúcs pozíciók (w=1 a pozíciókhoz) |
polygonCount | number | Poligonok száma |
createPolygon(indices) | (number[]) → void | Poligon hozzáadása (háromszög vagy négyszög) |
getElement(type) | `(VertexElementType) → VertexElement | null` |
createElement(type) | (VertexElementType) → VertexElement | Csúcs elem létrehozása |
Enumerations
A csomópontra alkalmazott helyi transzformáció.
| Enumerations | Enumerations | Enumerations |
|---|
translation | Vector3 | Helyi pozíció |
eulerAngles | Vector3 | Euler-rotáció fokban (XYZ sorrend) |
rotation | Quaternion | Rotáció kvaternióként |
scaling | Vector3 | Helyi méret |
Anyag osztályok
| Enumerations | Enumerations | Kulcsfontosságú tulajdonságok |
|---|
LambertMaterial | Diffúz + környezeti árnyalás | diffuseColor, ambientColor, transparency |
PhongMaterial | Speculárt + emisszívot ad a Lamberthez | specularColor, shininess, emissiveColor |
PbrMaterial | Fizikai alapú a glTF 2.0-hoz | albedo, metallicFactor, roughnessFactor, emissiveColor |
Matematikai osztályok
| Enumerations | Enumerations |
|---|
Vector3 | 3-component double-precision vector (x, y, z) |
Vector4 | 4-component vector for homogeneous math (x, y, z, w) |
FVector3 | Egypontos változat, amely a csúcsadatokban használatos |
Matrix4 | 4×4 transformation matrix; multiply, invert, decompose |
Quaternion | Rotációs kvaternió; fromEulerAngle, toEulerAngles, slerp |
BoundingBox | Tengelyhez igazított határoló doboz; minimum, maximum, center, size, merge |
Animációs osztályok
| Enumerations | Enumerations |
|---|
AnimationClip | Nevesített klip; tartalmaz AnimationNode lista; elérhető scene.animationClips |
AnimationNode | Összekapcsol egy klipet egy nevesített jelenetcsomóval; tartalmaz AnimationChannel lista |
AnimationChannel | Egyetlen tulajdonságot céloz meg (pl. X eltolás); tartalmaz egy KeyframeSequence |
KeyframeSequence | Rendezett lista a KeyFrame objektumokkal interpolation és extrapolation |
KeyFrame | Egyetlen idő/érték pár |
Enumerations
| Enumerations | Enumerations | Enumerations |
|---|
VertexElementType | NORMAL, UV, VERTEX_COLOR, BINORMAL, TANGENT | Vertex elem szemantika |
MappingMode | CONTROL_POINT, POLYGON_VERTEX, POLYGON, ALL_SAME | Hogyan térképeződik az adat a geometriára |
ReferenceMode | DIRECT, INDEX, INDEX_TO_DIRECT | Indexelési stratégia a vertex elem adatokhoz |
Interpolation | CONSTANT, LINEAR, BEZIER | Kulcskeret interpoláció |
Extrapolation | CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE | Viselkedés a kulcskeret tartományon kívül |
Formátum modulok
Formátum-specifikus opciós osztályok alútvonal modulokból exportálva vannak. Importáld őket külön-külön:
OBJ modul (@aspose/3d/formats/obj)
| Enumerations | Kulcsopciók |
|---|
ObjLoadOptions | enableMaterials, flipCoordinateSystem, scale, normalizeNormal |
glTF/GLB modul (@aspose/3d/formats/gltf)
| Enumerations | Kulcsfontosságú beállítások |
|---|
GltfSaveOptions | binaryMode (true → .glb), flipTexCoordV |
GltfFormat | GltfFormat.getInstance(): formátum példány a scene.save() |
STL modul (@aspose/3d/formats/stl)
| Enumerations | Kulcsfontosságú beállítások |
|---|
StlLoadOptions | N/A |
StlSaveOptions | binaryMode (false → ASCII, true → bináris) |
FBX modul (@aspose/3d/formats/fbx)
| Enumerations | Kulcsfontosságú beállítások |
|---|
FbxLoadOptions | N/A |
FbxSaveOptions | embedTextures |
Támogatott formátumok
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|
| Enumerations | .obj | Enumerations | Enumerations |
| glTF 2.0 | .gltf | Enumerations | Enumerations |
| Enumerations | .glb | Enumerations | Enumerations |
| STL | .stl | Enumerations | Enumerations |
| FBX | .fbx | Nem* | Nem* |
| COLLADA | .dae | Enumerations | Enumerations |
| 3MF | .3mf | Enumerations | Enumerations |
Gyorsreferencia példa
Lásd még