Udviklerguide

Aspose.3D FOSS for TypeScript er et open source, MIT-licenseret bibliotek, der giver Node.js-udviklere mulighed for at indlæse, konstruere, transformere og eksportere 3D-scener med fuld TypeScript-type sikkerhed.Uanset om du bygger en aktivpipeline, en formatkonverteringstjeneste, et geometri valideringsværktøj eller et 3D-indholdsoprettelsesskript, giver dette bibliotek en ren, konsistent API understøttet af en scene-grafmodel, der afspejler branchestandard 3D-koncepter.

Denne udviklervejledning dækker alt, hvad du behøver for at gå ud over hurtigstartinstallationen og skrive produktionskvalitets 3D-bearbejdningskode.

Hvad du finder i denne sektion

Funktioner og funktionaliteter

Den Funktioner siden er den primære reference for at arbejde med Aspose.3D FOSS for TypeScript. Den dækker:

  • Formatunderstøttelse: OBJ (med .mtl-materialer), glTF 2.0 / GLB binær, STL (binær og ASCII), COLLADA (DAE), 3MF og FBX, med per-format indlæsnings- og gemme‑indstillingsklasser inklusive ObjLoadOptions og GltfSaveOptions.
  • Scenegraf: Hvordan Scene, Node, Entity, Transform, og SceneObject sammensættes til en fuld scenehierarki, inklusive traversal‑mønstre for under‑noder.
  • Geometri‑ og mesh‑API: Arbejde med Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode til geometri‑behandling.
  • Materialesystem: Anvendelse LambertMaterial, PhongMaterial, og PbrMaterial (PBR for glTF) til scenenoder, og læsning af materialegenskaber indlæst fra .mtl-filer.
  • Matematiske værktøjer: Bruger Vector3, Vector4, Matrix4, Quaternion, og BoundingBox for transformationer, bounding-box‑forespørgsler og geometriske beregninger.
  • Animation: Konstruering og læsning AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, og Extrapolation data.
  • Stream‑ og bufferunderstøttelse: Indlæsning af 3D‑scener fra hukommelsen Buffer objekter via scene.openFromBuffer() til serverløse og streaming‑brugssager.
  • Komplette brugseksempler: End-to-end TypeScript‑scripts til indlæsning af OBJ, eksport af GLB, round‑tripping af STL og gennemløb af scenegrafer.
  • Tips, almindelige problemer og FAQ: Praktisk vejledning til at undgå almindelige faldgruber i produktionsbrug.
  • API‑referencens oversigt: Hurtigreference med en liste over alle nøgleklasser og deres primære metoder.

Nøglebegreber

Scenegraf: Alt 3D-indhold i Aspose.3D FOSS er repræsenteret som et træ af Node objekter rodfæstet ved scene.rootNode. Hver node kan bære en Entity (såsom en Mesh, Camera, eller Light) Transform der placerer den i hierarkiet.

Format-agnostisk API: Du åbner ethvert understøttet format via scene.open() eller scene.openFromBuffer() og gemmer til ethvert understøttet format via scene.save(). De samme scene‑graf‑objekter bruges uanset kilde‑ eller destinationsformat.

Stærk TypeScript-typning: Biblioteket leveres med strenge kompilatorindstillinger (noImplicitAny, strictNullChecks).

Enkelt afhængighed: Den eneste runtime‑afhængighed er xmldom, som installeres automatisk af npm. Der er ingen native add‑ons at kompilere, og ingen systempakker at installere.

Kom i gang

Hvis du endnu ikke har installeret biblioteket, se den Kom i gang sektion og den Installation vejledning før du læser videre.

Tilgængelige emner

 Dansk