Utviklerguide

Aspose.3D FOSS for Python er et åpen kildekode‑bibliotek med MIT‑lisens som lar Python-utviklere laste inn, konstruere, transformere og eksportere 3D‑scener uten eksterne kjøretidsavhengigheter. Enten du bygger en asset‑pipeline, et valideringsverktøy, et geometri‑behandlingsskript eller en format‑konverteringstjeneste, gir dette biblioteket et rent, konsistent API støttet av en scene‑graf‑modell som speiler bransjestandard 3D‑konsepter.

Denne utviklerveiledningen dekker alt du trenger for å gå utover den raske installasjonsveiledningen og skrive 3D‑behandlingskode av produksjonskvalitet.

Hva du vil finne i denne seksjonen

Funksjoner og funksjonalitet

Den Funksjoner siden er den primære referansen for å arbeide med Aspose.3D FOSS for Python. Den dekker:

  • Formatstøtte: OBJ (med .mtl-materialer), STL (binær og ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, og den pågående FBX-tokenizeren, med per-format last- og lagre-alternativklasser.
  • Scenegraf: Hvordan Scene, Node, Entity, Transform, og GlobalTransform sammensettes til et fullstendig scenehierarki, inkludert traverseringsmønstre for undernoder.
  • Mesh API: Arbeider med control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, og VertexElementSmoothingGroup for geometribehandling.
  • Materialsystem: Påfører LambertMaterial og PhongMaterial til scenenoder, og lese materialegenskaper lastet fra .mtl-filer.
  • Matematikkverktøy: Bruker Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, og BoundingBox for transformasjoner, spørringer med avgrensningsboks og geometriske beregninger.
  • Animasjon: Konstruksjon og lesing AnimationClip, AnimationNode, KeyFrame, og KeyframeSequence data.
  • Laste- og lagrealternativer: Per-format alternativklasser som ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Fullstendige bruks­eksempler:End-to-end Python-skript for lasting av OBJ, eksportering av STL, rundtur i glTF, og traversering av scenegrafer.
  • Tips, vanlige problemer og FAQ: Praktisk veiledning for å unngå vanlige fallgruver i produksjonsbruk.
  • Sammendrag av API-referanse: Hurtigreferanse med oversikt over alle nøkkelklasser.

Nøkkelbegreper

Scenegraf: Alt 3D-innhold i Aspose.3D FOSS er representert som et tre av Node objekter med rot i scene.root_node. Hver node kan bære en Entity (som en Mesh, Camera, eller Light) og en Transform som plasserer den i hierarkiet.

Format-agnostisk API: Du åpner ethvert støttet format gjennom Scene.open() eller Scene.from_file() og lagrer til ethvert støttet format gjennom Scene.save(). De samme scene‑graf‑objektene brukes uavhengig av kilde‑ eller målformatet.

Ingen avhengigheter: Biblioteket er rent Python. Det finnes ingen native‑utvidelse å kompilere, ingen systempakke å installere, og ingen tredjepartsbibliotek å håndtere.

Getting Started

Hvis du ennå ikke har installert biblioteket, se Getting Started seksjon og Installasjon veiledning før du leser videre.

Available Topics

 Norsk