Guia del desenvolupador

Aspose.3D FOSS for Python és una biblioteca de codi obert, amb llicència MIT, que permet als desenvolupadors Python carregar, construir, transformar i exportar escenes 3D sense cap dependència d’execució externa. Tant si esteu construint una canalització d’actius, una eina de validació, un script de processament geomètric o un servei de conversió de formats, aquesta biblioteca ofereix una API neta i coherent, recolzada per un model de graf de escena que reflecteix els conceptes 3D estàndard de la indústria.

Aquesta Guia del desenvolupador cobreix tot el que necessiteu per anar més enllà de la instal·lació ràpida i escriure codi de processament 3D de qualitat de producció.

Què trobareu en aquesta secció

Característiques i funcionalitats

El Funcionalitats La pàgina és la referència principal per treballar amb Aspose.3D FOSS per a Python. Cobreix:

  • Suport de formats: OBJ (amb materials .mtl), STL (binari i ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF i el tokenitzador FBX en desenvolupament, amb classes d’opcions de càrrega i desament per format.
  • Graf de l’escena: Com Scene, Node, Entity, Transform, i GlobalTransform composar una jerarquia completa d’escena, incloent patrons de recorregut de nodes fills.
  • Mesh API: Treballant amb control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, i VertexElementSmoothingGroup per al processament geomètric.
  • Sistema de materials: Aplicant LambertMaterial i PhongMaterial als nodes de l’escena, i llegint les propietats del material carregades des de fitxers .mtl.
  • Utilitats matemàtiques: Utilitzant Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, i BoundingBox per a transformacions, consultes de caixes delimitadores i càlculs geomètrics.
  • Animació:Construint i llegint AnimationClip, AnimationNode, KeyFrame, i KeyframeSequence dades.
  • Carrega i desa opcions: Classes d’opcions per format com ara ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Exemples d’ús complets: Scripts Python de principi a fi per a carregar OBJ, exportar STL, round-tripping glTF, i recórrer grafs d’escena.
  • Consells, problemes comuns i FAQ: Guia pràctica per evitar els errors comuns en l’ús en producció.
  • Resum de la referència de l’API: Llistat de referència ràpida de totes les classes clau.

Conceptes clau

Scene graph: Tot el contingut 3D a Aspose.3D FOSS es representa com un arbre de Node objectes arrelats a scene.root_node. Cada node pot portar un Entity (com ara un Mesh, Camera, o Light) Transform que el posiciona a la jerarquia.

API agnòstica de format: Obriu qualsevol format compatible a través de Scene.open() o Scene.from_file() i desa a qualsevol format compatible a través de Scene.save(). Els mateixos objectes del gràfic d’escena s’utilitzen independentment del format d’origen o de destinació.

Zero dependències: La biblioteca és purament Python. No hi ha cap extensió nativa per compilar, cap paquet del sistema per instal·lar i cap biblioteca de tercers per gestionar.

Començar

Si encara no heu instal·lat la biblioteca, consulteu el Començar secció i el Instal·lació guia abans de llegir més.

Temes disponibles

 Català