Utvecklarguide

Aspose.3D FOSS för TypeScript är ett open‑source‑bibliotek med MIT‑licens som låter Node.js‑utvecklare ladda, konstruera, transformera och exportera 3D‑scener med full TypeScript‑typsäkerhet. Oavsett om du bygger en tillgångspipeline, en format‑konverteringstjänst, ett geometrivalideringsverktyg eller ett 3D‑innehållsskapande skript, så erbjuder detta bibliotek ett rent, konsekvent API som stöds av en scen‑graf‑modell som speglar branschstandardens 3D‑koncept.

Denna utvecklarguide täcker allt du behöver för att gå bortom snabbstartinstallationen och skriva 3D‑bearbetningskod av produktionskvalitet.

Vad du kommer att hitta i detta avsnitt

Funktioner och funktionaliteter

Den Funktioner sidan är den primära referensen för att arbeta med Aspose.3D FOSS för TypeScript. Den täcker:

  • Formatstöd: OBJ (med .mtl-material), glTF 2.0 / GLB binär, STL (binär och ASCII), COLLADA (DAE), 3MF och FBX, med per-format laddnings- och sparalternativklasser inklusive ObjLoadOptions och GltfSaveOptions.
  • Scengraf: Hur Scene, Node, Entity, Transform, och SceneObject sammansätts till en fullständig scenhierarki, inklusive traverseringsmönster för barnnoder.
  • Geometri- och mesh-API: Arbeta med Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode för geometriprocessering.
  • Materialsystem: Applicering LambertMaterial, PhongMaterial, och PbrMaterial (PBR för glTF) till scennoder, och läsa materialegenskaper som laddas från .mtl-filer.
  • Matematiska verktyg: Användning Vector3, Vector4, Matrix4, Quaternion, och BoundingBox för transformationer, bounding-box‑frågor och geometriska beräkningar.
  • Animation: Skapa och läsa AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, och Extrapolation data.
  • Ström- och buffertstöd: Laddar 3D‑scener från minnet Buffer objekt via scene.openFromBuffer() för serverlösa och strömmande användningsfall.
  • Fullständiga användningsexempel: End-to-end TypeScript‑skript för att ladda OBJ, exportera GLB, round‑trippa STL och traversera scen‑grafer.
  • Tips, vanliga problem och FAQ: Praktisk vägledning för att undvika vanliga fallgropar i produktionsanvändning.
  • API‑referenssammanfattning: Snabbreferenslista över alla nyckelklasser och deras primära metoder.

Viktiga begrepp

Scengraf: All 3D-innehåll i Aspose.3D FOSS representeras som ett träd av Node objekt med rot i scene.rootNode. Varje nod kan bära ett Entity (t.ex. en Mesh, Camera, eller Light) Transform som placerar den i hierarkin.

Formatagnostiskt API: Du öppnar vilket stödformat som helst via scene.open() eller scene.openFromBuffer() och sparar till vilket stödformat som helst via scene.save(). Samma scen‑grafobjekt används oavsett källa‑ eller destinationsformat.

Stark TypeScript‑typning: Biblioteket levereras med strikta kompilatorinställningar (noImplicitAny, strictNullChecks) och kompletta typdefinitioner. Varje klass, metod och alternativ‑egenskap är fullständigt typad, vilket ger dig IDE‑autokomplettering och kompileringstidssäkerhet genom hela din 3D‑bearbetningskod.

Enkelt beroende: Det enda körningsberoendet är xmldom, som installeras automatiskt av npm. Det finns inga inhemska tillägg att kompilera och inga systempaket att installera.

Komma igång

Om du ännu inte har installerat biblioteket, se den Komma igång avsnitt och Installation guide innan du läser vidare.

Tillgängliga ämnen

 Svenska