Utviklerguide

Aspose.3D FOSS for TypeScript er et åpen kildekode‑bibliotek med MIT‑lisens som lar Node.js‑utviklere laste inn, konstruere, transformere og eksportere 3D‑scener med full TypeScript‑type‑sikkerhet. Enten du bygger en asset‑pipeline, en format‑konverteringstjeneste, et geometri‑valideringsverktøy eller et 3D‑innholds‑skript, gir dette biblioteket et rent, konsistent API støttet av en scene‑graf‑modell som speiler bransjestandard 3D‑konsepter.

Denne utviklerguiden dekker alt du trenger for å gå utover den raske installasjonen og skrive 3D‑behandlingskode av produksjonskvalitet.

Hva du vil finne i dette avsnittet

Funksjoner og funksjonalitet

Den Funksjoner siden er den primære referansen for å arbeide med Aspose.3D FOSS for TypeScript. Den dekker:

  • Formatstøtte: OBJ (med .mtl-materialer), glTF 2.0 / GLB-binær, STL (binær og ASCII), COLLADA (DAE), 3MF og FBX, med per-format last‑ og lagre‑alternativklasser inkludert ObjLoadOptions og GltfSaveOptions.
  • Scenegraf: Hvordan Scene, Node, Entity, Transform, og SceneObject sammensettes til et fullstendig scenehierarki, inkludert traverseringsmønstre for undernoder.
  • Geometri og mesh‑API: Arbeide med Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode for geometri‑behandling.
  • Materialsystem: Påføring av LambertMaterial, PhongMaterial, og PbrMaterial (PBR for glTF) til scenenoder, og lese materialegenskaper lastet fra .mtl-filer.
  • Matematikkverktøy: Bruke Vector3, Vector4, Matrix4, Quaternion, og BoundingBox for transformasjoner, spørringer med begrensningsboks, og geometriske beregninger.
  • Animasjon: Bygge og lese AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, og Extrapolation data.
  • Strøm- og bufferstøtte: Laste 3D‑scener fra minne Buffer objekter via scene.openFromBuffer() for serverløse og strømmings‑brukstilfeller.
  • Fullstendige bruks­eksempler: End‑to‑end TypeScript‑skript for lasting inn OBJ, eksportere GLB, runde‑trippe STL, og traversere scenegrafer.
  • Tips, vanlige problemer, og FAQ: Praktisk veiledning for å unngå vanlige fallgruver i produksjonsbruk.
  • API‑referansesammendrag: Hurtigreferanse med oversikt over alle nøkkelklasser og deres primære metoder.

Nøkkelbegreper

Scene graph: All 3D-innhold i Aspose.3D FOSS er representert som et tre av Node objekter med rot i scene.rootNode. Hver node kan bære en Entity (for eksempel en Mesh, Camera, eller Light) og en Transform som plasserer den i hierarkiet.

Format-agnostisk API: Du åpner ethvert støttet format gjennom scene.open() eller scene.openFromBuffer() og lagrer til ethvert støttet format gjennom scene.save(). De samme scene‑graf‑objektene brukes uavhengig av kilde‑ eller destinasjonsformatet.

Sterk TypeScript‑typisering: Biblioteket leveres med strenge kompilatorinnstillinger (noImplicitAny, strictNullChecks) og komplette type‑definisjoner. Hver klasse, metode og alternativ‑egenskap er fullt typet, noe som gir deg IDE‑autofullføring og kompileringstidssikkerhet gjennom hele 3D‑behandlingskoden din.

Enkelt avhengighet: Den eneste kjøretidsavhengigheten er xmldom, som installeres automatisk av npm. Det finnes ingen native‑tillegg som må kompileres og ingen systempakker som må installeres.

Kom i gang

Hvis du ennå ikke har installert biblioteket, se the Kom i gang seksjon og den Installasjon veiledning før du leser videre.

Tilgjengelige emner

 Norsk