Ontwikkelaarsgids

Aspose.3D FOSS voor Python is een open-source, MIT-gelicentieerde bibliotheek die Python ontwikkelaars in staat stelt 3D‑scènes te laden, te construeren, te transformeren en te exporteren zonder externe runtime‑afhankelijkheden. Of je nu een asset‑pipeline, een validatietool, een geometrieverwerkingsscript of een format‑conversieservice 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

Functies en functionaliteiten

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

  • Formaatondersteuning: OBJ (met .mtl-materialen), STL (binair en ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, en de FBX-tokenizer in ontwikkeling, met per-formaat laad- en opslaanoptieklassen.
  • Scènegraph: Hoe Scene, Node, Entity, Transform, en GlobalTransform samenstellen tot een volledige scènehiërarchie, inclusief traversiepatronen voor kindknooppunten.
  • Mesh API: Werken met control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, en VertexElementSmoothingGroup voor geometrische verwerking.
  • Materiaal systeem: Toepassen LambertMaterial en PhongMaterial naar scèneknooppunten, en het lezen van materiaaleigenschappen die geladen zijn uit .mtl‑bestanden.
  • Wiskundige hulpprogramma’s: Gebruik van Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, en BoundingBox voor transformaties, bounding-box‑query’s en geometrische berekeningen.
  • Animatie: Constructie en lezen AnimationClip, AnimationNode, KeyFrame, en KeyframeSequence gegevens.
  • Laad- en opslaanopties: Per-formaat optieklassen zoals ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Volledige gebruiksvoorbeelden: End-to-end Python scripts voor het laden van OBJ, exporteren van STL, round-tripping van glTF en het doorlopen van scene graphs.
  • Tips, veelvoorkomende problemen en FAQ: Praktische richtlijnen om veelvoorkomende valkuilen bij productiegebruik te vermijden.
  • Samenvatting van API-referentie: Snelreferentie met een overzicht van alle belangrijke klassen.

Belangrijke concepten

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

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

Geen afhankelijkheden: De bibliotheek is pure Python. Er is geen native extensie om te compileren, geen systeempakket om te installeren, en geen externe bibliotheek om te beheren.

Aan de slag

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

Beschikbare onderwerpen

 Nederlands