Udviklerguide

Aspose.3D FOSS for Python er et open‑source, MIT‑licenseret bibliotek, der giver Python-udviklere mulighed for at indlæse, konstruere, transformere og eksportere 3D‑scener uden eksterne runtime‑afhængigheder. Uanset om du bygger en asset‑pipeline, et valideringsværktøj, et geometribehandlings‑script eller en format‑konverteringstjeneste, leverer dette bibliotek et rent, konsistent API understøttet af en scene‑graf‑model, der afspejler branchestandard‑3D‑koncepter.

Denne udviklerguide dækker alt, hvad du behøver for at gå ud over den hurtige installationsguide og skrive produktionsklar 3D‑behandlingskode.

Hvad du vil finde i dette afsnit

Funktioner og funktionaliteter

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

  • Formatunderstøttelse: OBJ (med .mtl-materialer), STL (binær og ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, og den igangværende FBX-tokenizer, med per-format indlæsnings- og gemme‑optionsklasser.
  • Scenegraf: Hvordan Scene, Node, Entity, Transform, og GlobalTransform sammensæt til en fuld scenehierarki, inklusive mønstre for gennemløb af underknuder.
  • Mesh API: Arbejder med control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, og VertexElementSmoothingGroup til geometribehandling.
  • Materialesystem: Anvendelse af LambertMaterial og PhongMaterial til scenenoder, og læser materialegenskaber indlæst fra .mtl-filer.
  • Matematiske værktøjer: Brug af Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, og BoundingBox til transformationer, forespørgsler på afgrænsningsbokse og geometriske beregninger.
  • Animation: Oprettelse og læsning AnimationClip, AnimationNode, KeyFrame, og KeyframeSequence data.
  • Indlæsnings- og gemmeindstillinger: Per-format indstillingsklasser såsom ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Komplette brugseksempler: End-to-end Python scripts til indlæsning af OBJ, eksport af STL, round-tripping af glTF og gennemløb af scene‑grafer.
  • Tips, almindelige problemer og FAQ: Praktisk vejledning til at undgå almindelige faldgruber i produktionsbrug.
  • Opsummering af API‑referencen: Hurtigreference med en liste over alle nøgleklasser.

Nøglebegreber

Scene‑graf: Alt 3D-indhold i Aspose.3D FOSS er repræsenteret som et træ af Node objekter med roden i scene.root_node. Hver node kan bære en Entity (såsom en Mesh, Camera, eller Light) og en Transform der placerer den i hierarkiet.

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

Ingen afhængigheder: Biblioteket er ren Python. Der er ingen native udvidelse at kompilere, ingen systempakke at installere, og intet tredjepartsbibliotek at håndtere.

Getting Started

Hvis du endnu ikke har installeret biblioteket, se Getting Started afsnit og Installation vejledning, før du læser videre.

Available Topics

 Dansk