Aspose.3D FOSS
TypeScript
API Overview

API Overview — @aspose/3d for TypeScript

Paket: @aspose/3d (v24.12.0) Jezik: TypeScript / Node.js 18+ Licenca: MIT

@aspose/3d je biblioteka pod licencom MIT za čitanje, konstruiranje i izvoz 3D scena u Node.js-u. Dolazi s potpunim TypeScript definicijama tipova, jednim runtime ovisnošću (xmldom), i podržava sedam glavnih 3D formata datoteka. Sav I/O je sinkroniziran. Nativni dodaci nisu potrebni.

Enumerations 

npm install @aspose/3d

Enumerations tsconfig.json postavke za ispravno razrješavanje podputeva:

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

API referenca za značajke vezane uz zaštitu u Aspose.Slides FOSS za C++. Zaključci oblika i postavke zaštite.

Enumerations

Korijenski kontejner za 3D scenu. Sav sadržaj; čvorovi, geometrija, materijali i animacije; pohranjuje se u stablu čiji je korijen na scene.rootNode.Koristite open() / openFromBuffer() za učitavanje datoteke i save() / saveToBuffer() za izvoz.

EnumerationsEnumerationsEnumerations
rootNodeNodeKorijen grafova scene
assetInfoAssetInfoMetapodaci datoteke (autor, jedinice, koordinatni sustav)
animationClipsAnimationClip[]Svi animacijski isječci u sceni
open(path, opts?)(string, LoadOptions?) → voidUčitajte datoteku s diska
openFromBuffer(buf, opts?)(Buffer, LoadOptions?) → voidUčitaj iz memorijskog bafera
save(path, opts?)(string, SaveOptions?) → voidSpremi na disk (format se zaključuje iz ekstenzije)
saveToBuffer(ext, opts?)(string, SaveOptions?) → BufferSpremi u memorijski bafer
createAnimationClip(name)(string) → AnimationClipStvori i registriraj novi animacijski isječak

Enumerations

Imenovani čvor stabla u grafu scene. Čvorovi nose opcionalni Entity (mesh, camera, light) i Transform koji pozicionira čvor relativno na njegovog roditelja.

EnumerationsEnumerationsEnumerations
namestringNaziv čvora
childNodesNode[]Izravni podčvorovi
entity`Entitynull`
transformTransformLokalni pomak, rotacija, skaliranje
materialsMaterial[]Materijali dodijeljeni ovom čvoru
createChildNode(name)(string) → NodeDodaj podčvor
getChildNode(name)`(string) → Nodenull`

Enumerations

Poligonalna mreža; primarna vrsta geometrije. Proširuje Geometry.

EnumerationsEnumerationsEnumerations
controlPointsVector4[]Pozicije vrhova (w=1 za pozicije)
polygonCountnumberBroj poligona
createPolygon(indices)(number[]) → voidDodaj poligon (trokut ili četverokut)
getElement(type)`(VertexElementType) → VertexElementnull`
createElement(type)(VertexElementType) → VertexElementStvori element vrha

Enumerations

Lokalna transformacija primijenjena na čvor.

EnumerationsEnumerationsEnumerations
translationVector3Lokalna pozicija
eulerAnglesVector3Eulerova rotacija u stupnjevima (redoslijed XYZ)
rotationQuaternionRotacija kao kvaternion
scalingVector3Lokalna skala

Klase materijala

EnumerationsEnumerationsKljučna svojstva
LambertMaterialDifuzno + ambijentalno sjenčanjediffuseColor, ambientColor, transparency
PhongMaterialDodaje spekularno + emisivno LambertuspecularColor, shininess, emissiveColor
PbrMaterialFizički temeljeno za glTF 2.0albedo, metallicFactor, roughnessFactor, emissiveColor

Matematičke klase

EnumerationsEnumerations
Vector33-component double-precision vector (x, y, z)
Vector44-component vector for homogeneous math (x, y, z, w)
FVector3Varijanta s jednostrukom preciznošću korištena u podacima vrhova
Matrix44×4 transformation matrix; multiply, invert, decompose
QuaternionKvaternion rotacije; fromEulerAngle, toEulerAngles, slerp
BoundingBoxOkvir usklađen s osima; minimum, maximum, center, size, merge

Klase animacije

EnumerationsEnumerations
AnimationClipImenujeni isječak; sadrži AnimationNode popis; pristupa se putem scene.animationClips
AnimationNodePovezuje isječak s imenovanim čvorom scene; sadrži AnimationChannel popis
AnimationChannelCilja jedinstvenu svojstvo (npr. pomak X); drži a KeyframeSequence
KeyframeSequenceUređeni popis od KeyFrame objekata s interpolation i extrapolation
KeyFrameJedinstveni par vrijeme/vrijednost

Enumerations

EnumerationsEnumerationsEnumerations
VertexElementTypeNORMAL, UV, VERTEX_COLOR, BINORMAL, TANGENTSemantika elementa vrha
MappingModeCONTROL_POINT, POLYGON_VERTEX, POLYGON, ALL_SAMEKako se podaci mapiraju na geometriju
ReferenceModeDIRECT, INDEX, INDEX_TO_DIRECTStrategija indeksiranja podataka elementa vrha
InterpolationCONSTANT, LINEAR, BEZIERInterpolacija ključnih okvira
ExtrapolationCONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATEPonašanje izvan raspona ključnih okvira

Moduli formata

Klase opcija specifičnih za format izvezu se iz podputnih 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)

EnumerationsKljučne opcije
ObjLoadOptionsenableMaterials, flipCoordinateSystem, scale, normalizeNormal

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

EnumerationsKljučne opcije
GltfSaveOptionsbinaryMode (true → .glb), flipTexCoordV
GltfFormatGltfFormat.getInstance(): instanca formata za scene.save()

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

EnumerationsKljučne opcije
StlLoadOptionsN/A
StlSaveOptionsbinaryMode (false → ASCII, true → binary)

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

EnumerationsKljučne opcije
FbxLoadOptionsN/A
FbxSaveOptionsembedTextures

Podržani formati

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

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

Vidi također

 Hrvatski