Aspose.3D FOSS for TypeScript

API-reference for: @aspose/3d version af 24.12.0.Installering via:

npm install @aspose/3d

Runtime: Node.js 18, 20, 22+ · Sprog: TypeScript 5.0+ / JavaScript (CommonJS) · Licens: MIT


Grafik af kernen

Scenen

  • Rødtæsken til en 3D-scene. scene.open() eller en anden scene.openFromBuffer() at indlæse en fil, og scene.save() at skrive output. scene.rootNode som indgangspunktet til knudehierarkiet.

Knudepunkt

En navngivet knude i scenen træ. Transform, en valgfri entity (magt, kamera, lys eller andre former for belysning) SceneObject), og nul eller flere underknob, der er tilgængelige via childNodes.

Enhed

Basisklasse for alle objekter, der kan vedhæftes en Node som dets primære enhed. Underklassificeret ved: Mesh, Camera, Light, og andre.

SceneObject

Abstrakt basis for navngivne objekter, der tilhører en scene. name ejendoms- og scenemedlemskabssporing, der deles af knudepunkter, enheder og objekter på aktivniveau.

A3DOobjekt

Root-basisklassen for alle Aspose.3D-objekter. Tilvejebringer ejendomssystemet (getProperty, setProperty) og den name Det er en del af det offentlige.


Geometri og net

Målnettet

Repræsenterede et polygonnet. controlPoints række af Vector4 De er ikke i stand til at anvende de samme metoder. createPolygon().Ring til mig. triangulate() at konvertere alle polygoner til trekant inden eksport.

Geometri

Baseklasse for alle geometrityper. controlPoints og samling af topelementer (normale, UV-stråler, farver) knyttet til geometrien.

VertexElement

Basisklasse for pervertex-attributkanaler, der er knyttet til en Geometry.Underklasser indeholder typede datamater og mappingMode / referenceMode metadata.

VertexElementNormal

A. Det er ikke muligt. VertexElement Underklasse, der gemmer overfladenormaler. Data lagres internt som: FVector4[] (ervervet fra VertexElementFVector) kræves af de fleste renderere for korrekt belysning.

VertexElementUV

A. Det er ikke muligt. VertexElement En enkelt mask kan have flere UV-sæt for forskellige teksturslag.

VertexElementVertexColor

A. Det er ikke muligt. VertexElement underklasse, der gemmer farveværdier for RGBA per vertex.

VertexElementType

Oplysninger om de kanaltyper, som en VertexElement kan repræsentere (f.eks., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Enumerering, der styrer hvordan elementdata maps til geometri: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,eller ALL_SAME.

ReferenceMode

Enumerering, der styrer elementindekset i referencedata: DIRECT (en mod en) eller INDEX_TO_DIRECT (via et indeksarray).

TextureMapping

Oplysninger om teksturkanalsemantik: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, og mere.


Transform og rumlig

Transformation

Besidder den lokale position (translation), rotation (rotation som: Quaternion), og skala (scaling) af en Node.Ændringer her påvirker knuden og alle dens børn.

GlobalTransform

Kun læsevisning af en nodes verdensrumstransform, beregnet ved at akkumulere alle forfædre Transform Indtastning via node.globalTransform.

BoundingBox

En akselignet afgrænsende kasse defineret ved en minimum og: maximum ØvrigeVector3 Bruges til at beskrive den rumlige udstrækning af et net eller en scene.


Materialer

Materiale, LambertMaterial,PhongMaterial og PbrMaterial

Material er den abstrakte basisklasse for alle materiale typer. Der findes tre konkrete implementeringer:

  • LambertMaterial Kun diffus med omgivende, diffuse og emissionskærmkanaler.
  • PhongMaterial udstrækker sig LambertMaterial med specular farve og glans egenskaber for Phong skygge.
  • PbrMaterial Fysisk baseret renderingsmateriale med metal-, grovheds-, basisfarve- og normalkartransportkanaler. Kortlægning direkte til glTF 2.0 PBR-materialsmodellen.

Kamera og belysning

Kameraer

En synspunktsknude enhed med projektionstype, synsfelt, nær/lang klip afstand og sideforholdsegenskaber.

Lys

En lyskilde-nodes enhed. Typen styres af den LightType opgørelse.

LightType

Oplysninger om de understøttede lystyper: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Opgørelse af kameraets projektionstilstande: PERSPECTIVE og: ORTHOGRAPHIC.


Matematiske værktøjer

Vector3

En trekomponent flyvende punktvektor med x, y, z Feltet og de almindelige aritmetiske metoder (dot, cross, normalize, minus, times) Eksporteret fra @aspose/3d/utilities.

Vector4

En firekomponent flyvende punktvektor med x, y, z, w Feltet anvendes som typeindtægter i Mesh.controlPoints.

Vector2

En to-komponent dobbeltpræcisionsvektor med x og: y Bruges til at bestemme UV-strukturkoordinater.

Fvektor3

En kompakt trekomponent enkelpræcision float-vektor, der anvendes i topelementdataarrays til normaler og tangenter.

Matrix4

En 4×4 transformationsmatrix. Understøtter sammenkædning, inversion, transposition og nedbrydning til translation, rotation og skala komponenter. Eksporteret fra @aspose/3d/utilities.

Kvaternjon

En enhedskvaternjon til repræsentation af rotationer uden gimballås. slerp() til glat interpolation og omregning fra/til Eulers vinkler, samt Matrix4.Eksport fra: @aspose/3d/utilities.


Animation

AnimationClip

En navngivet, tidsbegrænset samling af AnimationNode Den primære container til keyframe animationsdata, der er indlæst fra FBX- eller COLLADA-filer.

AnimationNode

Et navngivet animationsspor, der målretter en specifik ejendomsvej på et sceneobjekt. Indeholder ét eller flere AnimationChannel genstande.

AnimationChannel

En enkelt animeret ejendomskanal inden for en AnimationNode.- Hænder en … KeyframeSequence af tids-/værdipar.

KeyFrame

En enkelt tid/værdiprøve i en KeyframeSequence.Medfører tidsstemplet (i sekunder), værdien og tangenten information til interpolering.

KeyframeSequence

En rækkefølge over: KeyFrame Prøverne for en ejendomskanal sammen med den Interpolation og: Extrapolation indstillinger, der regulerer afspilning.

Interpolering

Oplysninger om keyframe interpoleringsmodusser. Kendte medlemmer omfatter: LINEAR og: CONSTANT.Yderligere medlemmer som f.eks. BEZIER kan være tilgængelige.

Ekstrapolation

Definerer adfærd uden for nøgleframe-området (før den første og efter den sidste nøgleslængde). Kontrolleres af ExtrapolationType.

StepMode

En opgørelse, der styrer, hvordan trinvis (konstant) interpolering anvendes ved grænser.

WeightedMode

Antal for håndtering af Bezier tangentvægt: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT,eller BOTH.

ExtrapolationType

Overskuddsforekomster: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, og OSCILLATE.


Format I/O

FileFormat

Basiskritikør for et 3D-filformat. Hvert understøttet format giver en konkret singleton via getInstance().

Importør

Basisklasse til format-specifikke importimplementeringer. Ikke direkte instancieret; indkaldt internt af scene.open().

Eksporterende producent

Basisklasse for format-specifikke eksportimplementeringer. Ikke direkte instancieret; indkaldt internt af scene.save().

LoadOptions

Basisklasse for format-specifikke indlæsesmuligheder. Overfør en underklasseinstans til scene.open() eller en anden scene.openFromBuffer().

SaveOptions

Basisklasse for format-specifikke opslagsalternativobjekter. Pass en underklasseinstance til scene.save().

- Jeg er ikke i gang.

Interne servicestjenester, der giver et abstrakt filsystem og bufferind-/udgående oplysninger til importører og eksportører.


OBJ-format

OBJ understøtter både import og eksport. Når man gemmer som OB J, kan materialet biblioteket (.mtl) skrives automatisk sammen med den .obj - Filer.

ObjImporter

Interne importører, der læser Wavefront-OBJ-filer, løser .mtl Det er et vigtigt element i den europæiske integration. Scene.Automatisk indkaldt, når: ObjLoadOptions er overført til: scene.open().

ObjExporter

En intern eksportør, der skriver Wavefront OBJ-filer. .mtl Det er et vigtigt element i den europæiske forskningsproces, at man kan gøre det muligt for alle. scene.save() mål og .obj vej.

ObjLoadOptions

Optioner til indlæse af OBJ-filer.: enableMaterials (boolean, standard) true), flipCoordinateSystem (boolean), normalizeNormal (boolean, standard) true), scale (nummer) Se Format indlæse og gemme muligheder for alle detaljer.

ObjSaveOptions

Optimering til OBJ-eksport. scene.save() til at styre OBJ-udgangsadfærd. Se Format indlæse og gemme muligheder for alle detaljer.

ObjFormat

Format descriptor singleton for OBJ. Begge dele canImport og: canExport er: true.


glTF-format

GltfImporter

Læser glTF 2.0 JSON (.gltf) og binær GLB (.glbDet er en del af et system, der kan bruges til at få indbyggede og eksterne bufferreferencer, PBR-materialer, skins og animationsklipp.

GltfExporter

Skrive glTF 2.0 udgang. GltfSaveOptions.binaryMode er: true, producerer en selvstændig GLB; ellers skriver den et JSON-program. .gltf med en ven, .bin - Buffer.

GltfLoadOptions

Ladeindstillinger for glTF/GLB-filer. Kontrollerer bufferopløsning og tekstur indlæses adfærd.

GltfSaveOptions

Optimering til eksport af glTF/GLB: Bemærkelsesværdige egenskaber: binaryMode (boolean, true → GLB, standard false), flipTexCoordV (boolean, skifter UV-linjeaksen som standard) true) Se også: Format indlæse og gemme muligheder for alle detaljer.

GltfFormat

Format descriptor singleton. Få via GltfFormat.getInstance() og overgå til: scene.save() som det andet argument.


STL-format

StlImporter

Læser både ASCII og binære STL-filer i en Scene med et enkelt indhold af: Mesh enhed.

StlExporter

Skriv binær STL. Udgangen indeholder den triangulerede mesh fra scenen; ikke-triangel polygoner trianguleres automatisk.

StlLoadOptions

Lådeindstillinger for STL: Kontrolleres, om importøren vender normalen under importen.

StlSaveOptions

Optimering til STL-eksport.: binaryMode (boolean, standard) false) Kontrollerer, om output er ASCII eller binær STL. Se Format indlæse og gemme muligheder for alle detaljer.

StlFormat

Format descriptor singleton. Få via StlFormat.getInstance().


3MF Format

ThreeMfImporter

Læser 3MF-arkiver og fylder en Scene med nettobjekter, farver og materialeegenskaber.

ThreeMfExporter

Skrive et gyldigt 3MF-arkiv fra den aktuelle scene.

ThreeMfLoadOptions

Indlæsningsalternativer for 3MF-filer.

ThreeMfSaveOptions

Optioner til 3MF-eksport.

ThreeMfFormat

Format descriptor singleton. Få via ThreeMfFormat.getInstance().


FBX-format

FbxImporter

Læser ASCII FBX-filer, herunder geometri, materialer og animationsklipp. Kun AS CII fbx; binær fbX er endnu ikke implementeret Skeleton og blendform import også ikke er implementerede i den nuværende version.

FbxExporter

Skrive ASCII FBX-udgang kun fra den aktuelle scene. Binær FBx-eksport er ikke tilgængelig i den nuværende version.

FbxLoadOptions

Ladeindstillinger til FBX. I den nuværende version er der ingen konfiguration af format-specifikke indlæsningsmuligheder (skin og blend-form import ikke implementeret).

FbxSaveOptions

Optimering til FBX-eksport.: embedTextures (boolean, standard) false) Se også: Format indlæse og gemme muligheder for alle detaljer.

FbxFormat

Format descriptor singleton. Få via FbxFormat.getInstance().


COLLADA Format

COLLADA indførsel og eksport kræver, at de nationale myndigheder skal udarbejde en oversigt over alle de relevante oplysninger. xmldom Peer-afhængighed, som installeres automatisk med @aspose/3d.

ColladaImporter

Det lyder COLLADA (.dae) XML-filer, der bruger xmldom.Hanterer geometri, materialer, kameraer, lys og animation.

ColladaExporter

Skrive COLLADA XML-udgang fra den aktuelle scene. Velegnet til udveksling med DCC værktøjer (Blender, Maya osv.).

ColladaFormat

Format descriptor singleton. Få via ColladaFormat.getInstance().


Egenskabernes system

Ejendomme

Et indskrevet navn/værdipar, der kan vedhæftes til enhver A3DObject.Understøtter skalær- og vektorværdietyper.

PropertyCollection

En bestilt beholder af: Property Tilgængelig på alle sider. A3DObject via den properties Tilbehør.

CustomObject

En friformet ejendomspose, der strækker sig over A3DObject.Bruges til at gemme vilkårlige metadata, der ikke er tilpasset en standardklasse.


Aktivinformation

AssetInfo

Medfører metadata på scenen niveau, der er indlæst fra kildedataen: forfatter, applikationsnavn, oprettelsesdato, enhedsskala og koordinatakse-oplysninger.

ImageRenderOptions

Alternativer til styring af, hvordan teksturer og billeder opløses og kodes, når de gemmes i formater, der indlejrer billeddata (f.eks. GLB med binaryMode: true).


Se også:

 Dansk