Aspose.3D FOSS
TypeScript
API Overview

API Overview — @aspose/3d for TypeScript

Pakke: @aspose/3d (v24.12.0) Sprog: TypeScript / Node.js 18+ Licens: MIT

@aspose/3d er et MIT-licenseret bibliotek til at læse, konstruere og eksportere 3D-scener i Node.js. Det leveres med komplette TypeScript-typedefinitioner, en enkelt runtime‑afhængighed (xmldom), og understøtter syv store 3D-filformater. Al I/O er synkron. Ingen native add-ons er påkrævet.

Properties 

npm install @aspose/3d

Properties tsconfig.json indstillinger for korrekt understi‑opløsning:

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

API-reference for pladsholderunderstøttelse i Aspose.Slides FOSS for C++. Pladsholderformer definerer indholdsområder på layout- og slide-skabeloner.

Properties

Rodbeholderen for en 3D-scene. Alt indhold; noder, geometri, materialer og animationer; gemmes i et træ med rod i scene.rootNode.Brug open() / openFromBuffer() til at indlæse en fil og save() / saveToBuffer() til at eksportere.

PropertiesPropertiesProperties
rootNodeNodeRoden af scenegrafen
assetInfoAssetInfoFilmetadata (opretter, enheder, koordinatsystem)
animationClipsAnimationClip[]Alle animationsklip i scenen
open(path, opts?)(string, LoadOptions?) → voidIndlæs en fil fra disk
openFromBuffer(buf, opts?)(Buffer, LoadOptions?) → voidIndlæs fra hukommelsesbuffer
save(path, opts?)(string, SaveOptions?) → voidGem til disk (format udledt fra filendelse)
saveToBuffer(ext, opts?)(string, SaveOptions?) → BufferGem til hukommelsesbuffer
createAnimationClip(name)(string) → AnimationClipOpret og registrer et nyt animationsklip

Properties

En navngivet trænode i scenegrafen. Noder bærer en valgfri Entity (mesh, kamera, lys) og en Transform der positionerer noden i forhold til dens forælder.

PropertiesPropertiesProperties
namestringNode-navn
childNodesNode[]Direkte underordnede noder
entity`Entitynull`
transformTransformLokal translation, rotation, skalering
materialsMaterial[]Materialer tildelt denne node
createChildNode(name)(string) → NodeTilføj en barnenode
getChildNode(name)`(string) → Nodenull`

Properties

Polygonnet; den primære geometri-type. Udvider Geometry.

PropertiesPropertiesProperties
controlPointsVector4[]Vertexpositioner (w=1 for positioner)
polygonCountnumberAntal polygoner
createPolygon(indices)(number[]) → voidTilføj et polygon (trekant eller quad)
getElement(type)`(VertexElementType) → VertexElementnull`
createElement(type)(VertexElementType) → VertexElementOpret et vertex-element

Properties

Lokal transformation anvendt på en node.

PropertiesPropertiesProperties
translationVector3Lokal position
eulerAnglesVector3Euler-rotation i grader (XYZ-orden)
rotationQuaternionRotation som en quaternion
scalingVector3Lokal skala

Materialeklasser

PropertiesPropertiesNøgleegenskaber
LambertMaterialDiffus + omgivende shadingdiffuseColor, ambientColor, transparency
PhongMaterialTilføjer specular + emissiv til LambertspecularColor, shininess, emissiveColor
PbrMaterialFysisk baseret for glTF 2.0albedo, metallicFactor, roughnessFactor, emissiveColor

Matematikklasser

PropertiesProperties
Vector33-component double-precision vector (x, y, z)
Vector44-component vector for homogeneous math (x, y, z, w)
FVector3Enkeltpræcisionsvariant brugt i vertexdata
Matrix44×4 transformation matrix; multiply, invert, decompose
QuaternionRotationsquaternion; fromEulerAngle, toEulerAngles, slerp
BoundingBoxAksialt justeret begrænsningsboks; minimum, maximum, center, size, merge

Animationsklasser

PropertiesProperties
AnimationClipNavngivet klip; indeholder AnimationNode liste; tilgået via scene.animationClips
AnimationNodeBinder et klip til en navngivet scenenode; indeholder AnimationChannel liste
AnimationChannelMålretter en enkelt egenskab (f.eks. translation X); indeholder en KeyframeSequence
KeyframeSequenceOrdnet liste over KeyFrame objekter med interpolation og extrapolation
KeyFrameEnkelt tids-/værdipar

Properties

PropertiesPropertiesProperties
VertexElementTypeNORMAL, UV, VERTEX_COLOR, BINORMAL, TANGENTVertex-element semantik
MappingModeCONTROL_POINT, POLYGON_VERTEX, POLYGON, ALL_SAMEHvordan data kortlægges til geometri
ReferenceModeDIRECT, INDEX, INDEX_TO_DIRECTIndekseringsstrategi for vertex-element data
InterpolationCONSTANT, LINEAR, BEZIERKeyframe-interpolation
ExtrapolationCONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATEAdfærd uden for nøglebilledintervallet

Formatmoduler

Format‑specifikke options‑klasser eksporteres fra understi‑moduler. Importér dem separat:

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)

PropertiesNøgleindstillinger
ObjLoadOptionsenableMaterials, flipCoordinateSystem, scale, normalizeNormal

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

PropertiesNøgleindstillinger
GltfSaveOptionsbinaryMode (true → .glb), flipTexCoordV
GltfFormatGltfFormat.getInstance(): formatinstans for scene.save()

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

PropertiesNøgleindstillinger
StlLoadOptionsN/A
StlSaveOptionsbinaryMode (false → ASCII, true → binær)

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

PropertiesNøgleindstillinger
FbxLoadOptionsN/A
FbxSaveOptionsembedTextures

Understøttede formater

PropertiesPropertiesPropertiesProperties
Properties.objPropertiesProperties
glTF 2.0.gltfPropertiesProperties
Properties.glbPropertiesProperties
STL.stlPropertiesProperties
FBX.fbxNej*Nej*
COLLADA.daePropertiesProperties
3MF.3mfPropertiesProperties

Eksempel på hurtig reference 

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

Se også

 Dansk