Aspose.3D FOSS for Python

Referència de l’API per a aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, llicència MIT).

Totes les classes s’importen des del aspose.threed paquet o dels seus subpaquets. La importació arrel és:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

Graf de l’escena principal

Methods	Methods
`Scene`	Contenidor de nivell superior per a totes les dades d’escena 3D. Conté el node arrel, les metadades dels actius i els clips d’animació. Exposa `from_file()`, `open()`, i `save()` com a punts d’entrada principals d’E/S.
`Node`	Un node anomenat a la jerarquia de l’escena. Posseeix una llista de nodes fills i una llista d’objectes adjuntats `Entity` objectes com ara malles, càmeres i llums. Porta una `Transform`.
`Entity`	Classe base abstracta per a tots els objectes que es poden adjuntar a un `Node`. Proporciona nom i identitat però cap geometria pròpia.
`SceneObject`	Classe base compartida per `Node` i `Entity`. Proporciona la interfície de col·lecció de propietats utilitzada per a metadades definides per l’usuari.
`A3DObject`	Classe base arrel per a tots els objectes gestionats Aspose.3D. Exposa la propietat de nom i el `Properties` col·lecció.
`INamedObject`	Interfície que garanteix una `name` propietat. Implementada per `Node`, `Entity`, i diversos tipus de descriptor específics del format.

Geometria i malla

Methods	Methods
`Mesh`	Entitat de malla de polígons. Emmagatzema punts de control (posicions de vèrtex com a `Vector4`), llistes de cares de polígons (llistes d’índexs de punts de control) i capes d’elements de vèrtex (normals, UVs, colors de vèrtex).
`Geometry`	Base abstracta per a tipus de geometria semblants a malles. Defineix la matriu de punts de control i la col·lecció de `VertexElement` capes. `Mesh` hereta de `Geometry`.
`VertexElement`	Base abstracta per a una capa de dades adjunta a la geometria (normals, UVs, colors, etc.). Porta `mapping_mode`, `reference_mode`, i una `data` llista.
`VertexElementNormal`	Emmagatzema un vector normal per vèrtex o per cantonada de polígon, depenent de `mapping_mode`. Els valors de dades són `FVector4` instàncies (precisió simple) amb `w` sense ús.
`VertexElementUV`	Emmagatzema dades de coordenades de textura com a `FVector4` per vèrtex o per cantonada de polígon (només `x` i `y` components s’utilitzen per a UV). Una malla pot portar diverses capes UV per a diferents canals de textura.
`VertexElementVertexColor`	Emmagatzema dades de color RGBA per vèrtex o per cantonada com a `FVector4` (r, g, b, a en el rang 0–1).
`VertexElementSmoothingGroup`	Emmagatzema IDs enters de grup de suavitzat per polígon, utilitzats per l’importador OBJ per reproduir les assignacions originals de grup de suavitzat del fitxer font.
`VertexElementType`	Enumeració que identifica el rol semàntic d’una capa d’element de vèrtex: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, i altres. Passa valors a `Mesh.get_element()`.
`MappingMode`	Enumeració que controla a quina primitiva es mapen els valors d’element de vèrtex: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, o `ALL_SAME`.
`ReferenceMode`	Enumeració que controla com s’indexen els valors: `DIRECT` (un valor per cada primitiva de mapatge) o `INDEX_TO_DIRECT` (matriu de valors més una matriu d’índexs separada).
`PolygonModifier`	Classe d’utilitat estàtica amb mètodes per a triangul·lar `Mesh` objectes i tot `Scene` grafs.

Transformació i espacial

Methods	Methods
`Transform`	Transformació local adjunta a un `Node`. Proporciona translació, rotació (com `Quaternion`), i components d’escala, més propietats de conveniència per a angles d’Euler.
`GlobalTransform`	Vista de només lectura de la transformació d’espai mundial d’un node després de composar totes les transformacions dels avantpassats. Accedit via `Node.global_transform`.
`AssetInfo`	Bloc de metadades adjunt a un `Scene`. Emmagatzema el nom de l’aplicació d’autor, el nom de la unitat, el factor d’escala de la unitat, les definicions d’eixos del sistema de coordenades i les marques de temps de creació/modificació.

Materials i ombrejat

Methods	Methods
`Material`	Classe base abstracta per a tots els tipus de material. Proporciona un nom i una col·lecció de propietats per a paràmetres numèrics i de color.
`LambertMaterial`	Model de material només difús. Emmagatzema el color ambient, el color difús, el color emès i la transparència. Carregat des de fitxers OBJ que utilitzen bàsic `Ka`/`Kd`/`Ke` declaracions.
`PhongMaterial`	Methods `LambertMaterial` amb color especular i lluïssor (exponent especular). Carregat des de fitxers OBJ que utilitzen `Ks`/`Ns` declaracions.
`PbrMaterial`	Material Physically Based Rendering. Emmagatzema albedo, factor metàl·lic, factor de rugositat i textures associades. Utilitzat per glTF 2.0 i altres formats compatibles amb PBR.

Càmera i il·luminació

Methods	Methods
`Camera`	Entitat càmera. Només `projection_type` i `name` són funcionals en aquesta edició; totes les altres propietats numèriques (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) són esquelets que retornen valors per defecte. Adjuntat a un `Node` per definir transformacions del punt de vista.
`Light`	Entitat de font de llum. Hereta de `Camera` com a classe esbós; la `Light` classe en si no exposa propietats addicionals en aquesta versió.
`LightType`	Enumeració de les categories de llum compatibles: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumeració dels modes de projecció de càmera: `PERSPECTIVE` i `ORTHOGRAPHIC`.

Utilitats matemàtiques

Methods	Methods
`Vector2`	Vector de doble precisió de 2 components (`x`, `y`). S’utilitza per a coordenades de textura UV.
`Vector3`	Vector de doble precisió de 3 components (`x`, `y`, `z`). S’utilitza per a posicions, direccions i escala.
`Vector4`	Vector de doble precisió de 4 components (`x`, `y`, `z`, `w`). Utilitzat per punts de control (posicions homogènies) i dades normals.
`FVector2`	Vector de coma flotant de precisió simple de 2 components. Utilitzat internament per a emmagatzematge compacte en les matrius de dades d’elements de vèrtex.
`FVector3`	Vector de coma flotant de precisió simple de 3 components. Apareix a les matrius de dades d’elements de vèrtex per a normals i tangents.
`FVector4`	Vector de coma flotant de precisió simple de 4 components. El tipus d’emmagatzematge de `VertexElementFVector.data`.
`Quaternion`	Quaternió unitari per representar rotacions (`w`, `x`, `y`, `z`). Utilitzat per `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Caixa delimitadora alineada amb els eixos definida per `minimum` i `maximum` `Vector3` cantonades. Utilitzada per a consultes espacials i ajudes de recull de frustum.

Methods

Methods	Methods
`AnimationClip`	Contenidor anomenat per a un conjunt de canals animats que cobreixen un interval de reproducció. Un `Scene` pot contenir diversos clips (p. ex., “Walk”, “Run”).
`AnimationNode`	Enllaça un `AnimationClip` a un node d’escena o propietat específica. Actua com a pont entre les dades del clip i els objectes del gràfic d’escena.
`AnimationChannel`	Un flux de propietat animada únic dins d’un clip, que apunta a una propietat anomenada d’un objecte (p. ex., `Transform.translation.x`).
`KeyFrame`	Una única mostra de temps–valor dins d’un `KeyframeSequence`. Emmagatzema el temps (en segons) i el valor en aquest moment.
`KeyframeSequence`	Una llista ordenada de `KeyFrame` objectes per a un canal escalar, juntament amb la configuració d’interpolació i extrapolació.
`Interpolation`	Enumeració dels modes d’interpolació entre fotogrames clau: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumeració dels comportaments més enllà del primer i darrer fotograma clau: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

E/S de format

Methods	Methods
`Scene.from_file(path)`	Mètode estàtic. Obre el fitxer a `path`, detecta el format a partir de l’extensió i retorna una poblada `Scene`. Llença una excepció si el fitxer no es troba o el format no és compatible.
`Scene.open(path, options=None)`	Mètode d’instància. Obre un fitxer en una instància existent `Scene` instància, opcionalment utilitzant un format específic `LoadOptions` subclasse.
`Scene.save(path, options=None)`	Mètode d’instància. Serialitza l’escena a `path` utilitzant el format deduït de l’extensió, opcionalment utilitzant un format específic `SaveOptions` subclasse.
`FileFormat`	Registre de formats de fitxer compatibles. Conté entrades com ara `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Les variants específiques de format s’accedeixen a través de classes d’opció (p. ex., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Abstracció interna d’E/S utilitzada per importadors i exportadors de formats. Normalment no s’utilitza directament des del codi de l’aplicació.
`LoadOptions`	Classe base per a tots els objectes d’opcions de càrrega específiques de format. Subclasse de `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Classe base per a tots els objectes d’opcions de desament específiques de format. Subclasse de `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Format OBJ

Methods	Methods
`ObjImporter`	Classe d’importador intern que analitza fitxers Wavefront OBJ i MTL. Invocat automàticament per `Scene.from_file()` per a `.obj` extensions.
`ObjLoadOptions`	Opcions de càrrega per a fitxers Wavefront OBJ. Propietats clau: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Opcions de desament per a la sortida Wavefront OBJ. Controla les normals, UVs, referències de material i el mode de núvol de punts.
`ObjFormat`	Descriptor de format per a Wavefront OBJ. Accessible com a `FileFormat.WAVEFRONT_OBJ()`.

Format STL

Methods	Methods
`StlImporter`	Importador intern que llegeix fitxers STL tant binaris com ASCII. Seleccionat automàticament per extensió.
`StlExporter`	Exportador intern que escriu STL.
`StlLoadOptions`	Opcions de càrrega per a fitxers STL. Suporta `flip_coordinate_system` i `scale`.
`StlSaveOptions`	Opcions de desament per a la sortida STL. Controls `binary_mode`, `scale`, i `flip_coordinate_system`.
`StlFormat`	Descriptor de format per a STL.

Format glTF

Methods	Methods
`GltfLoadOptions`	Opcions de càrrega per a fitxers glTF 2.0 i GLB. Propietat clau: `flip_tex_coord_v`.
`GltfSaveOptions`	Opcions de desament per a la sortida glTF 2.0. Utilitzeu `binary_mode=True` per a un paquet GLB autònom.
`GltfFormat`	Descriptor de format per a glTF 2.0 / GLB. Accessible com a `FileFormat.GLTF2()`.

Format FBX

Methods	Methods
`FbxLoadOptions`	Opcions de càrrega per a fitxers FBX. Propietats clau: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Opcions de desament per a la sortida FBX. L’exportació FBX genera `NotImplementedError` incondicionalment; `FbxSaveOptions` existeix però l’exportació no està implementada.
`FbxFormat`	Descriptor de format per a FBX. Accessible com a `FileFormat.FBX7400ASCII()`.

Format COLLADA

Methods	Methods
`ColladaLoadOptions`	Opcions de càrrega per a COLLADA (`.dae`) fitxers. Controla el reassignament d’eixos i l’escala d’unitats en la importació.
`ColladaSaveOptions`	Opcions de desament per a la sortida COLLADA. Controla `indented`, `flip_coordinate_system`, i l’exportació de materials.
`ColladaFormat`	Descriptor de format per a COLLADA. Resolt automàticament des de `.dae` l’extensió del fitxer.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Opcions de càrrega per a 3MF (`.3mf`) fitxers.
`ThreeMfSaveOptions`	Opcions de desament per a la sortida 3MF. 3MF és el format preferit per a fluxos de treball d’impressió 3D.
`ThreeMfFormat`	Descriptor de format per a 3MF. Accessible com a `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Identifica com es mapeja una textura a la geometria: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, etc.
`BooleanOperation`	Tipus d’operació booleana CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistema de propietats

Methods	Methods
`Property`	Una única propietat tipada amb nom en un `A3DObject`. Emmagatzema el nom de la propietat, el descriptor de tipus i el valor actual.
`PropertyCollection`	Col·lecció iterable de `Property` objectes adjunts a un `A3DObject`. Admet la cerca per nom i la iteració sobre totes les propietats definides.
`CustomObject`	Una lleugera `A3DObject` subclasse que només porta un nom i un arbitrari `PropertyCollection`. S’utilitza per emmagatzemar metadades definides per l’usuari en objectes de l’escena.

Imatge i renderització

Methods	Methods
`ImageRenderOptions`	Opcions per a la rasterització per programari en renderitzar una escena a un buffer d’imatge. Emmagatzema el color de fons, les dimensions de la imatge i la referència de la càmera. `Scene.render()` llança `NotImplementedError`; el renderitzat no està implementat en aquesta versió.

Aspose.3D FOSS for Python

Graf de l’escena principal

Geometria i malla

Transformació i espacial

Materials i ombrejat

Càmera i il·luminació

Utilitats matemàtiques

Methods

E/S de format

Format OBJ

Format STL

Format glTF

Format FBX

Format COLLADA

3MF Format

Methods

Sistema de propietats

Imatge i renderització

Vegeu també