API Overview — @aspose/3d for TypeScript

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

npm install @aspose/3d

Enumerations tsconfig.json beállítások a helyes alútvonal feloldásához:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

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.

EnumerationsEnumerationsEnumerations
rootNodeNodeA jelenet gráf gyökere
assetInfoAssetInfoFájl metaadatok (készítő, egységek, koordináta-rendszer)
animationClipsAnimationClip[]Az összes animációs klipek a jelenetben
open(path, opts?)(string, LoadOptions?) → voidFájl betöltése lemezről
openFromBuffer(buf, opts?)(Buffer, LoadOptions?) → voidBetöltés a memóriában lévő pufferből
save(path, opts?)(string, SaveOptions?) → voidMentés lemezre (a formátum a kiterjesztésből következtethető)
saveToBuffer(ext, opts?)(string, SaveOptions?) → BufferMenté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.

EnumerationsEnumerationsEnumerations
namestringCsomópont neve
childNodesNode[]Közvetlen gyermek csomópontok
entity`Entitynull`
transformTransformHelyi eltolás, forgatás, méretezés
materialsMaterial[]Ehhez a csomóponthoz rendelt anyagok
createChildNode(name)(string) → NodeGyermek csomópont hozzáadása
getChildNode(name)`(string) → Nodenull`

Enumerations

Poligon háló; az elsődleges geometria típus. Kiterjeszti Geometry.

EnumerationsEnumerationsEnumerations
controlPointsVector4[]Csúcs pozíciók (w=1 a pozíciókhoz)
polygonCountnumberPoligonok száma
createPolygon(indices)(number[]) → voidPoligon hozzáadása (háromszög vagy négyszög)
getElement(type)`(VertexElementType) → VertexElementnull`
createElement(type)(VertexElementType) → VertexElementCsúcs elem létrehozása

Enumerations

A csomópontra alkalmazott helyi transzformáció.

EnumerationsEnumerationsEnumerations
translationVector3Helyi pozíció
eulerAnglesVector3Euler-rotáció fokban (XYZ sorrend)
rotationQuaternionRotáció kvaternióként
scalingVector3Helyi méret

Anyag osztályok

EnumerationsEnumerationsKulcsfontosságú tulajdonságok
LambertMaterialDiffúz + környezeti árnyalásdiffuseColor, ambientColor, transparency
PhongMaterialSpeculárt + emisszívot ad a LamberthezspecularColor, shininess, emissiveColor
PbrMaterialFizikai alapú a glTF 2.0-hozalbedo, metallicFactor, roughnessFactor, emissiveColor

Matematikai osztályok

EnumerationsEnumerations
Vector33-component double-precision vector (x, y, z)
Vector44-component vector for homogeneous math (x, y, z, w)
FVector3Egypontos változat, amely a csúcsadatokban használatos
Matrix44×4 transformation matrix; multiply, invert, decompose
QuaternionRotációs kvaternió; fromEulerAngle, toEulerAngles, slerp
BoundingBoxTengelyhez igazított határoló doboz; minimum, maximum, center, size, merge

Animációs osztályok

EnumerationsEnumerations
AnimationClipNevesített klip; tartalmaz AnimationNode lista; elérhető scene.animationClips
AnimationNodeÖsszekapcsol egy klipet egy nevesített jelenetcsomóval; tartalmaz AnimationChannel lista
AnimationChannelEgyetlen tulajdonságot céloz meg (pl. X eltolás); tartalmaz egy KeyframeSequence
KeyframeSequenceRendezett lista a KeyFrame objektumokkal interpolation és extrapolation
KeyFrameEgyetlen idő/érték pár

Enumerations

EnumerationsEnumerationsEnumerations
VertexElementTypeNORMAL, UV, VERTEX_COLOR, BINORMAL, TANGENTVertex elem szemantika
MappingModeCONTROL_POINT, POLYGON_VERTEX, POLYGON, ALL_SAMEHogyan térképeződik az adat a geometriára
ReferenceModeDIRECT, INDEX, INDEX_TO_DIRECTIndexelési stratégia a vertex elem adatokhoz
InterpolationCONSTANT, LINEAR, BEZIERKulcskeret interpoláció
ExtrapolationCONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATEViselkedé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:

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)

EnumerationsKulcsopciók
ObjLoadOptionsenableMaterials, flipCoordinateSystem, scale, normalizeNormal

glTF/GLB modul (@aspose/3d/formats/gltf)

EnumerationsKulcsfontosságú beállítások
GltfSaveOptionsbinaryMode (true → .glb), flipTexCoordV
GltfFormatGltfFormat.getInstance(): formátum példány a scene.save()

STL modul (@aspose/3d/formats/stl)

EnumerationsKulcsfontosságú beállítások
StlLoadOptionsN/A
StlSaveOptionsbinaryMode (false → ASCII, true → bináris)

FBX modul (@aspose/3d/formats/fbx)

EnumerationsKulcsfontosságú beállítások
FbxLoadOptionsN/A
FbxSaveOptionsembedTextures

Támogatott formátumok

EnumerationsEnumerationsEnumerationsEnumerations
Enumerations.objEnumerationsEnumerations
glTF 2.0.gltfEnumerationsEnumerations
Enumerations.glbEnumerationsEnumerations
STL.stlEnumerationsEnumerations
FBX.fbxNem*Nem*
COLLADA.daeEnumerationsEnumerations
3MF.3mfEnumerationsEnumerations

Gyorsreferencia példa

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

Lásd még

 Magyar