Ontwikkelaarsgids

Aspose.3D FOSS voor TypeScript is een open‑source, MIT‑gelicentieerde bibliotheek die Node.js‑ontwikkelaars in staat stelt 3D‑scènes te laden, te construeren, te transformeren en te exporteren met volledige TypeScript‑typeveiligheid. Of je nu een asset‑pipeline, een format‑conversieservice, een geometrie‑validatietool of een 3D‑content‑authoringscript bouwt, deze bibliotheek biedt een schone, consistente API ondersteund door een scene‑graph‑model dat de industriestandaard 3D‑concepten weerspiegelt.

Deze ontwikkelaarsgids behandelt alles wat je nodig hebt om verder te gaan dan de snelle installatie en productie‑kwaliteit 3D‑verwerkingscode te schrijven.

Wat je in dit gedeelte zult vinden

Kenmerken en functionaliteiten

De Functies pagina is de primaire referentie voor het werken met Aspose.3D FOSS voor TypeScript. Het behandelt:

  • Ondersteuning van formaten: OBJ (met .mtl-materialen), glTF 2.0 / GLB-binair, STL (binair en ASCII), COLLADA (DAE), 3MF en FBX, met per-formaat laad- en opslaanoptieklassen inclusief ObjLoadOptions en GltfSaveOptions.
  • Scenegraph:Hoe Scene, Node, Entity, Transform, en SceneObject samenstellen tot een volledige scènehiërarchie, inclusief traversiepatronen voor kindknooppunten.
  • Geometrie- en mesh-API: Werken met Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, en ReferenceMode voor geometrische verwerking.
  • Materiaalssysteem: Toepassen LambertMaterial, PhongMaterial, en PbrMaterial (PBR for glTF) naar scene nodes, en het lezen van materiaaleigenschappen geladen uit .mtl files.
  • Wiskundige hulpprogramma’s: Gebruik Vector3, Vector4, Matrix4, Quaternion, en BoundingBox voor transformaties, bounding-box queries en geometrische berekeningen.
  • Animatie: Constructie en lezen AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, en Extrapolation data.
  • Stream- en bufferondersteuning: Laden van 3D-scènes vanuit het geheugen Buffer objecten via scene.openFromBuffer() voor serverless- en streamingtoepassingen.
  • Complete gebruiksvoorbeelden: End-to-end TypeScript‑scripts voor het laden van OBJ, exporteren van GLB, round‑tripping van STL en het doorlopen van scene‑graphs.
  • Tips, veelvoorkomende problemen en FAQ: Praktische richtlijnen om veelvoorkomende valkuilen in productie te vermijden.
  • Samenvatting van API-referentie: Snelreferentie met een overzicht van alle belangrijke klassen en hun primaire methoden.

Belangrijke concepten

Scènegraph: Alle 3D-inhoud in Aspose.3D FOSS wordt weergegeven als een boom van Node objecten met wortel op scene.rootNode. Elke knoop kan een Entity (zoals een Mesh, Camera, of Light) Transform die het in de hiërarchie positioneert.

Formaat-agnostische API: Je opent elk ondersteund formaat via scene.open() of scene.openFromBuffer() en sla je op naar elk ondersteund formaat via scene.save(). Dezelfde scene‑graph objecten worden gebruikt, ongeacht het bron- of doelformaat.

Sterke TypeScript-typisering: De bibliotheek wordt geleverd met strikte compilerinstellingen (noImplicitAny, strictNullChecks) en volledige type-definities. Elke klasse, methode en optiereigenschap is volledig getypeerd, waardoor je IDE‑auto-aanvulling en compile‑tijd veiligheid krijgt gedurende je 3D‑verwerkingscode.

Enkele afhankelijkheid: De enige runtime‑afhankelijkheid is xmldom, die automatisch wordt geïnstalleerd door npm. Er zijn geen native add‑ons om te compileren en er zijn geen systeem‑pakketten om te installeren.

Aan de slag

Als je de bibliotheek nog niet hebt geïnstalleerd, zie de Aan de slag sectie en de Installatie gids voordat u verder leest.

Beschikbare onderwerpen

 Nederlands