Aspose.3D FOSS for TypeScript

API-referanse for @aspose/3d versjon 24.12.0. Installer via:

npm install @aspose/3d

Kjøretid: Node.js 18, 20, 22+ · Språk: TypeScript 5.0+ / JavaScript (CommonJS) · Lisens: MIT

Kjerne-scengraf

ImageRenderOptions

Rotbeholderen for en 3D-scene. Kall scene.open() eller scene.openFromBuffer() for å laste inn en fil, og scene.save() for å skrive utdata. Eksponerer scene.rootNode som inngangspunktet til nodehierarkiet.

ImageRenderOptions

En navngitt node i scenetreet. Inneholder en Transform, en valgfri entity (mesh, kamera, lys, eller annen SceneObject), og null eller flere undernoder tilgjengelig via childNodes.

ImageRenderOptions

Basisklasse for alle objekter som kan festes til en Node som sin primære enhet. Subklasset av Mesh, Camera, Light, og andre.

SceneObject

Abstrakt base for navngitte objekter som tilhører en scene. Tilbyr den name egenskaps- og scenemedlemskapssporing delt av noder, enheter og asset-level objekter.

A3DObject

Rotbasisklasse for alle Aspose.3D‑objekter. Tilbyr egenskapssystemet (getProperty, setProperty) name felt arvet av alle offentlige klasser.

Geometri og Mesh

ImageRenderOptions

Representerer et polygonnett. Inneholder en controlPoints array av Vector4 vertikser og polygon-definisjoner opprettet via createPolygon(). Kall triangulate() for å konvertere alle polygoner til trekanter før eksport.

ImageRenderOptions

Basisklasse for alle geometrityper. Inneholder controlPoints og samlingen av vertex-elementer (normals, UVs, colors) knyttet til geometrien.

VertexElement

Basisklasse for per-vertex-attributtkanaler knyttet til en Geometry. Subklasser inneholder typede data-arrays og mappingMode / referenceMode metadata.

VertexElementNormal

En VertexElement subklasse som lagrer overflatenormals. Data lagres internt som FVector4[] (arvet fra VertexElementFVector). Påkrevd av de fleste renderere for korrekt belysning.

VertexElementUV

En VertexElement subklasse som lagrer 2D-teksturkoordinater. Et enkelt mesh kan ha flere UV-sett for ulike teksturlag.

VertexElementVertexColor

A VertexElement subklasse som lagrer RGBA-fargeverdier per vertex.

VertexElementType

Oppramsing av attributtkanaltyper som en VertexElement kan representere (f.eks., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Opptelling som styrer hvordan elementdata kartlegges på geometri: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, eller ALL_SAME.

ReferenceMode

Opptelling som styrer hvordan elementindekser refererer til data: DIRECT (en-til-en) eller INDEX_TO_DIRECT (via en indeksarray).

TextureMapping

Opptelling av teksturkanalsemantikk: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, og mer.

Transform og Spatial

ImageRenderOptions

Inneholder den lokale posisjonen (translation), rotasjon (rotation som Quaternion), og skala (scaling) av en Node. Endringer her påvirker noden og alle dens barn.

GlobalTransform

Skrivebeskyttet visning av en nodes verdensromtransformasjon, beregnet ved å akkumulere alle forelder Transform verdier. Tilgang via node.globalTransform.

BoundingBox

En aksejustert avgrensningsboks definert av en minimum og maximum Vector3 hjørne. Brukes til å beskrive det romlige omfanget av et mesh eller en scene.

ImageRenderOptions

Material, LambertMaterial, PhongMaterial, PbrMaterial

Material er den abstrakte basisklassen for alle materialtyper. Tre konkrete implementasjoner er tilgjengelige:

  • LambertMaterial — diffuse-only med ambient, diffuse og emissive fargekanaler. Egnet for ikke-spekulære overflater.
  • PhongMaterial — utvider LambertMaterial med spekulær farge og glans-egenskaper for Phong-shading.
  • PbrMaterial — fysisk-basert renderingsmateriale med metallisk, ruhet, basisfarge, og normalkart-kanaler. Kartlegger direkte til glTF 2.0 PBR-materialmodellen.

Kamera og belysning

ImageRenderOptions

En synspunkt-nodeenhet med projeksjonstype, synsfelt, nær-/fjernklippeavstander og sideforholdsegenskaper.

ImageRenderOptions

En lys-kilde node-enhet. Type styres av den LightType enumerasjonen.

LightType

Opplisting av støttede lystypper: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Opplisting av kamera-projeksjonsmoduser: PERSPECTIVE og ORTHOGRAPHIC.

Matematikkverktøy

ImageRenderOptions

En tre-komponent flyttallsvektor med x, y, z felter og vanlige aritmetiske metoder (dot, cross, normalize, minus, times). Eksportert fra @aspose/3d/utilities.

ImageRenderOptions

En fire-komponent flyttallsvektor med x, y, z, w felter. Brukes som type for oppføringer i Mesh.controlPoints.

ImageRenderOptions

En to-komponent dobbelpresisjonsvektor med x og y felter. Brukes for UV-teksturkoordinater.

FVector3

En kompakt tre‑komponent single-precision float‑vektor som brukes i vertex‑elementdatamatrisene for normaler og tangenter.

ImageRenderOptions

En 4×4 transformation matrix. Støtter concatenation, inversion, transposition, og decomposition into translation, rotation, and scale components. Exported from @aspose/3d/utilities.

ImageRenderOptions

En unit quaternion for representing rotations without gimbal lock. Gir slerp() for smooth interpolation and conversion to/from Euler angles and Matrix4. Eksportert fra @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

En navngitt, tidsbegrenset samling av AnimationNode spor. Den primære beholderen for keyframe‑animasjonsdata lastet fra FBX‑ eller COLLADA‑filer.

AnimationNode

Et navngitt animasjonsspor som retter seg mot en spesifikk egenskapssti på et scenobjekt. Inneholder én eller flere AnimationChannel objekter.

AnimationChannel

En enkelt animert egenskapskanal innenfor en AnimationNode. Inneholder en KeyframeSequence av tids-/verdi-par.

KeyFrame

Et enkelt tids-/verdi‑prøve i en KeyframeSequence. Inneholder tidsstemplet (i sekunder), verdien og tangentinformasjon for interpolasjon.

KeyframeSequence

En ordnet liste over KeyFrame prøver for én egenskapskanal, sammen med den Interpolation og Extrapolation innstillinger som styrer avspilling.

ImageRenderOptions

Oppramsing av keyframe‑interpolasjonsmoduser. Kjente medlemmer inkluderer LINEAR og CONSTANT. Ytterligere medlemmer som BEZIER kan være tilgjengelig.

ImageRenderOptions

Definerer oppførsel utenfor nøkkelrammeområdet (før den første nøkkelen og etter den siste nøkkelen). Kontrolleres av ExtrapolationType.

StepMode

Enumering som styrer hvordan trinnvis (konstant) interpolasjon anvendes ved grenser.

WeightedMode

Oppramsing for håndtering av Bezier-tangentvekt: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, eller BOTH.

ExtrapolationType

Opplisting av oppføringer utenfor gyldig område: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, og OSCILLATE.

Format I/U

FileFormat

Basiskategori for et 3D‑filformat. Hvert støttet format gir en konkret singleton via getInstance().

ImageRenderOptions

Basisklasse for formatspesifikke importimplementasjoner. Ikke instansiert direkte; kalles internt av scene.open().

ImageRenderOptions

Basisklasse for formatspesifikke eksportimplementasjoner. Ikke instansiert direkte; kalles internt av scene.save().

LoadOptions

Basisklasse for formatspesifikke lastingsalternativ‑objekter. Send en underklasseinstans til scene.open() eller scene.openFromBuffer().

SaveOptions

Basisklasse for formatspesifikke lagringsalternativ‑objekter. Send en underklasseinstans til scene.save().

IOService

Intern tjenestegrensesnitt som abstrakterer filsystem- og buffer‑I/O for importører og eksportører.

OBJ Format

OBJ støtter både import og eksport. Når du lagrer som OBJ, skrives materialbiblioteket (.mtl) skrives automatisk ved siden av .obj filen.

ObjImporter

Intern importør som leser Wavefront OBJ‑filer, løser .mtl materialbiblioteker, og fyller en Scene. ObjLoadOptions Kalles automatisk når scene.open().

ObjExporter

Intern eksportør som skriver Wavefront OBJ‑filer. En følgesvenn .mtl materialbiblioteket skrives automatisk. Kalles når scene.save() målretter en .obj sti.

ObjLoadOptions

Last inn alternativer for OBJ-filer. Nøkkelegenskaper: enableMaterials (boolsk, standard true), flipCoordinateSystem (boolsk), normalizeNormal (boolsk, standard true), scale (tall). Se Alternativer for lasting og lagring av format for fullstendige detaljer.

ObjSaveOptions

Lagre alternativer for OBJ-eksport. Send til scene.save() for å kontrollere OBJ-utdataoppførsel. Se Alternativer for lasting og lagring av format for fullstendige detaljer.

ObjFormat

Formatbeskrivelses‑singleton for OBJ. Begge canImport og canExport er true.

glTF-format

GltfImporter

Leser glTF 2.0 JSON (.gltf) og binær GLB (.glb) filer. Håndterer innebygde og eksterne bufferreferanser, PBR-materialer, skinn og animasjonsklipp.

GltfExporter

Skriver glTF 2.0-utdata. Når GltfSaveOptions.binaryMode er true, produserer en selvstendig GLB; ellers skriver den en JSON .gltf med en tilhørende .bin buffer.

GltfLoadOptions

Lastingsalternativer for glTF/GLB‑filer. Kontrollerer bufferoppløsning og teksturlastingsoppførsel.

GltfSaveOptions

Lagre alternativer for glTF/GLB-eksport. Merkbare egenskaper: binaryMode (boolsk, true → GLB, standard false), flipTexCoordV (boolsk, snur UV-vertikalakse, standard true). Se Alternativer for lasting og lagring av format for fullstendige detaljer.

GltfFormat

Formatbeskriver singleton. Hent via GltfFormat.getInstance() og send til scene.save() som det andre argumentet.

STL-format

StlImporter

Leser både ASCII- og binære STL-filer inn i en Scene som inneholder en enkelt Mesh entitet.

StlExporter

Skriver binær STL. Utdataene inneholder det triangulerte nettet fra scenen; polygoner som ikke er trekanter blir automatisk triangulert.

StlLoadOptions

Lastalternativer for STL. Kontrollerer om importøren snur normaler under import.

StlSaveOptions

Lagringsalternativer for STL-eksport. Nøkkel‑egenskap: binaryMode (boolsk, standard false). Styrer om utdata er ASCII eller binær STL. Se Alternativer for lasting og lagring av format for fullstendige detaljer.

StlFormat

Formatbeskriver singleton. Hent via StlFormat.getInstance().

3MF Format

ThreeMfImporter

Leser Open Packaging Convention 3MF-arkiver og fyller en Scene med mesh-objekter, farger og materialegenskaper.

ThreeMfExporter

Skriver et gyldig 3MF-arkiv fra den nåværende scenen. Egnet for 3D‑utskriftsarbeidsflyter.

ThreeMfLoadOptions

Last inn alternativer for 3MF-filer.

ThreeMfSaveOptions

Lagre alternativer for 3MF-eksport.

ThreeMfFormat

Formatbeskriver singleton. Hent via ThreeMfFormat.getInstance().

FBX-format

FbxImporter

Leser FBX binære og ASCII-filer, inkludert geometri, materialer, skjeletter, blend shapes og animasjonsklipp.

FbxExporter

Skriver FBX-filer fra den nåværende scenen. Både binær og ASCII FBX-utdata støttes avhengig av innstillinger.

FbxLoadOptions

Last inn alternativer for FBX. Kontrollerer om animasjon, skins og blend shapes importeres.

FbxSaveOptions

Lagringsalternativer for FBX-eksport. Nøkkel‑egenskap: embedTextures (boolsk, standard false) Alternativer for lasting og lagring av format for fullstendige detaljer.

FbxFormat

Formatbeskriver singleton. Hent via FbxFormat.getInstance().

COLLADA-format

COLLADA-import og -eksport krever den xmldom peer-avhengighet, som installeres automatisk med @aspose/3d.

ColladaImporter

Leser COLLADA (.dae) XML-filer ved hjelp av xmldom. Håndterer geometri, materialer, kameraer, lys og animasjon.

ColladaExporter

Skriver COLLADA XML‑utdata fra den nåværende scenen. Egnet for utveksling med DCC‑verktøy (Blender, Maya osv.).

ColladaFormat

Formatbeskriver singleton. Hent via ColladaFormat.getInstance().

Egenskapssystem

ImageRenderOptions

Et typet navn/verdi-par som kan festes til enhver A3DObject. Støtter skalar- og vektorverdityper.

PropertyCollection

En ordnet beholder av Property objekter. Tilgjengelig på enhver A3DObject via properties tilgangsmetode.

CustomObject

En fri‑form egenskapspose som utvider A3DObject. Brukes til å lagre vilkårlig metadata som ikke kartlegges til en standardklasse.

Asset‑informasjon

AssetInfo

Bærer scenenivå-metadata lastet fra kildefilen: forfatter, programnavn, opprettelsesdato, enhetsskala og koordinatakseinformasjon.

ImageRenderOptions

Alternativer som styrer hvordan teksturer og bilder løses opp og kodes når de lagres til formater som innebygger bildedata (f.eks. GLB med binaryMode: true).

Se også

 Norsk