Utvecklarguide

Aspose.3D FOSS för Python är ett open-source, MIT-licensed bibliotek som låter Python-utvecklare ladda, konstruera, transformera och exportera 3D‑scener utan några externa runtime‑beroenden. Oavsett om du bygger en asset‑pipeline, ett valideringsverktyg, ett geometriprocesserings‑skript eller en format‑konverteringstjänst, så tillhandahåller detta bibliotek ett rent, konsekvent API som stöds av en scene-graph‑modell som speglar branschstandardens 3D‑koncept.

Denna utvecklarguide täcker allt du behöver för att gå förbi den snabba installationsguiden och skriva 3D‑processkod av produktionskvalitet.

Vad du hittar i detta avsnitt

Funktioner och funktionalitet

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

  • Formatstöd: OBJ (med .mtl-material), STL (binär och ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, och den pågående FBX-tokenizern, med per-format laddnings- och sparalternativklasser.
  • Scengraf: Hur Scene, Node, Entity, Transform, och GlobalTransform komponera till en fullständig scenhierarki, inklusive traverseringsmönster för barnnoder.
  • Mesh API: Arbeta med control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, och VertexElementSmoothingGroup för geometrisk bearbetning.
  • Materialsystem: Applicering av LambertMaterial och PhongMaterial till scennoder och läsa materialegenskaper som laddas från .mtl-filer.
  • Matematiska verktyg: Använder Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, och BoundingBox för transformationer, förfrågningar om begränsningsrutor och geometriska beräkningar.
  • Animation: Skapa och läsa AnimationClip, AnimationNode, KeyFrame, och KeyframeSequence data.
  • Ladda och spara alternativ: Per-format alternativklasser såsom ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Fullständiga exempel på användning: End-to-end Python-skript för att läsa in OBJ, exportera STL, round-tripping av glTF och traversera scengrafer.
  • Tips, vanliga problem och FAQ: Praktisk vägledning för att undvika vanliga fallgropar i produktionsanvändning.
  • Sammanfattning av API-referens: Snabbreferenslista över alla nyckelklasser.

Nyckelkoncept

Scengraf: Allt 3D-innehåll i Aspose.3D FOSS representeras som ett träd av Node objekt med roten i scene.root_node. Varje nod kan bära en Entity (till exempel en Mesh, Camera, eller Light) och en Transform som placerar den i hierarkin.

Format-agnostiskt API: Du öppnar vilket som helst stödformat genom Scene.open() eller Scene.from_file() och spara till vilket som helst stödformat genom Scene.save(). Samma scene-graph-objekt används oavsett källa eller målformat.

Noll beroenden: Biblioteket är rent Python. Det finns ingen native extension att kompilera, inget systempaket att installera och inget tredjepartsbibliotek att hantera.

Komma igång

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

Tillgängliga ämnen

 Svenska