Aspose.3D FOSS for Python

Referencia de API para aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, licencia MIT).

Todas las clases se importan desde el aspose.threed paquete o sus subpaquetes. La importación raíz es:

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

Núcleo del Grafo de Escena

Methods	Methods
`Scene`	Contenedor de nivel superior para todos los datos de la escena 3D. Contiene el nodo raíz, los metadatos de los recursos y los clips de animación. Expone `from_file()`, `open()`, y `save()` como los puntos de entrada principales de I/O.
`Node`	Un nodo con nombre en la jerarquía de la escena. Posee una lista de nodos hijos y una lista de adjuntos `Entity` objetos como mallas, cámaras y luces. Lleva un local `Transform`.
`Entity`	Clase base abstracta para todos los objetos que pueden adjuntarse a un `Node`. Proporciona nombre e identidad pero no tiene geometría propia.
`SceneObject`	Clase base compartida por `Node` y `Entity`. Proporciona la interfaz de colección de propiedades utilizada para metadatos definidos por el usuario.
`A3DObject`	Clase base raíz para todos los objetos gestionados Aspose.3D. Expone la propiedad de nombre y el `Properties` colección.
`INamedObject`	Interfaz que garantiza un `name` propiedad. Implementada por `Node`, `Entity`, y varios tipos de descriptor específicos de formato.

Geometría y Malla

Methods	Methods
`Mesh`	Entidad de malla poligonal. Almacena puntos de control (posiciones de vértices como `Vector4`), listas de caras de polígonos (listas de índices de puntos de control) y capas de elementos de vértice (normales, UVs, colores de vértice).
`Geometry`	Base abstracta para tipos de geometría tipo malla. Define la matriz de puntos de control y la colección de `VertexElement` capas. `Mesh` hereda de `Geometry`.
`VertexElement`	Base abstracta para una capa de datos adjunta a la geometría (normales, UVs, colores, etc.). Lleva `mapping_mode`, `reference_mode`, y una `data` lista.
`VertexElementNormal`	Almacena un vector normal por vértice o por esquina del polígono, dependiendo de `mapping_mode`. Los valores de datos son `FVector4` instancias (precisión simple) con `w` sin usar.
`VertexElementUV`	Almacena datos de coordenadas de textura como `FVector4` por vértice o por esquina del polígono (solo `x` y `y` componentes se usan para UV). Una malla puede contener múltiples capas UV para diferentes canales de textura.
`VertexElementVertexColor`	Almacena datos de color RGBA por vértice o por esquina como `FVector4` (r, g, b, a en el rango 0–1).
`VertexElementSmoothingGroup`	Almacena IDs enteros de grupos de suavizado por polígono, usados por el importador OBJ para reproducir las asignaciones originales de grupos de suavizado del archivo fuente.
`VertexElementType`	Enumeración que identifica el rol semántico de una capa de elemento de vértice: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, y otros. Pasa valores a `Mesh.get_element()`.
`MappingMode`	Enumeración que controla a qué primitiva se asigna un valor de elemento de vértice: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, o `ALL_SAME`.
`ReferenceMode`	Enumeración que controla cómo se indexan los valores: `DIRECT` (un valor por primitiva de mapeo) o `INDEX_TO_DIRECT` (matriz de valores más una matriz de índices separada).
`PolygonModifier`	Clase estática de utilidad con métodos para triangular `Mesh` objetos y todo `Scene` grafos.

Transformación y Espacial

Methods	Methods
`Transform`	Transformación local adjunta a un `Node`. Proporciona traslación, rotación (como `Quaternion`), y componentes de escala, además de propiedades de conveniencia para ángulos de Euler.
`GlobalTransform`	Vista de solo lectura de la transformación en espacio mundial de un nodo después de componer todas las transformaciones de los ancestros. Accedido a través de `Node.global_transform`.
`AssetInfo`	Bloque de metadatos adjunto a un `Scene`. Almacena el nombre de la aplicación de autoría, el nombre de la unidad, el factor de escala de la unidad, las definiciones de los ejes del sistema de coordenadas y las marcas de tiempo de creación/modificación.

Materiales y Sombreado

Methods	Methods
`Material`	Clase base abstracta para todos los tipos de material. Proporciona un nombre y una colección de propiedades para parámetros numéricos y de color.
`LambertMaterial`	Modelo de material solo difuso. Almacena color ambiental, color difuso, color emisivo y transparencia. Cargado de archivos OBJ que utilizan básico `Ka`/`Kd`/`Ke` declaraciones.
`PhongMaterial`	Methods `LambertMaterial` con color especular y brillo (exponente especular). Cargado de archivos OBJ que utilizan `Ks`/`Ns` declaraciones.
`PbrMaterial`	Material de Renderizado Basado en la Física. Almacena albedo, factor metálico, factor de rugosidad y texturas asociadas. Utilizado por glTF 2.0 y otros formatos compatibles con PBR.

Cámara y Iluminación

Methods	Methods
`Camera`	Entidad de cámara. Solo `projection_type` y `name` son funcionales en esta edición; todas las demás propiedades numéricas (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) son stubs que devuelven valores predeterminados. Adjunta a un `Node` para definir transformaciones de punto de vista.
`Light`	Entidad de fuente de luz. Hereda de `Camera` como una clase stub; la `Light` propia clase no expone propiedades adicionales en esta versión.
`LightType`	Enumeración de categorías de luz soportadas: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumeración de modos de proyección de cámara: `PERSPECTIVE` y `ORTHOGRAPHIC`.

Utilidades Matemáticas

Methods	Methods
`Vector2`	Vector de doble precisión de 2 componentes (`x`, `y`). Usado para coordenadas de textura UV.
`Vector3`	Vector de doble precisión de 3 componentes (`x`, `y`, `z`). Usado para posiciones, direcciones y escala.
`Vector4`	Vector de doble precisión de 4 componentes (`x`, `y`, `z`, `w`). Usado para puntos de control (posiciones homogéneas) y datos de normales.
`FVector2`	Vector de punto flotante de precisión simple de 2 componentes. Usado internamente para almacenamiento compacto en matrices de datos de elementos de vértice.
`FVector3`	Vector de punto flotante de precisión simple de 3 componentes. Aparece en matrices de datos de elementos de vértice para normales y tangentes.
`FVector4`	Vector de punto flotante de precisión simple de 4 componentes. El tipo de almacenamiento de `VertexElementFVector.data`.
`Quaternion`	Cuaternión unitario para representar rotaciones (`w`, `x`, `y`, `z`). Usado por `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Caja delimitadora alineada a los ejes definida por `minimum` y `maximum` `Vector3` esquinas. Usado para consultas espaciales y auxiliares de recorte de frustum.

Methods

Methods	Methods
`AnimationClip`	Contenedor nombrado para un conjunto de canales animados que cubren un rango de reproducción. Un `Scene` puede contener varios clips (p. ej., “Walk”, “Run”).
`AnimationNode`	Enlaza un `AnimationClip` a un nodo de escena o propiedad específico. Actúa como el puente entre los datos del clip y los objetos del grafo de escena.
`AnimationChannel`	Un único flujo de propiedad animada dentro de un clip, dirigido a una propiedad con nombre en un objeto (p. ej., `Transform.translation.x`).
`KeyFrame`	Una única muestra de tiempo‑valor dentro de un `KeyframeSequence`. Almacena el tiempo (en segundos) y el valor en ese momento.
`KeyframeSequence`	Una lista ordenada de `KeyFrame` objetos para un canal escalar, junto con la configuración de interpolación y extrapolación.
`Interpolation`	Enumeración de modos de interpolación entre fotogramas clave: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumeración de comportamientos más allá del primer y último fotograma clave: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

E/S de Formatos

Methods	Methods
`Scene.from_file(path)`	Método estático. Abre el archivo en `path`, detecta el formato a partir de la extensión y devuelve un objeto poblado `Scene`.Lanza una excepción si el archivo no se encuentra o el formato no es compatible.
`Scene.open(path, options=None)`	Método de instancia. Abre un archivo en una instancia existente, `Scene` instancia, opcionalmente usando un formato específico `LoadOptions` subclase.
`Scene.save(path, options=None)`	Método de instancia. Serializa la escena a `path` usando el formato inferido de la extensión, opcionalmente usando un formato específico `SaveOptions` subclase.
`FileFormat`	Registro de formatos de archivo compatibles. Contiene entradas como `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Las variantes específicas de formato se acceden a través de clases de opciones (p.ej., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Abstracción interna de E/S utilizada por importadores y exportadores de formatos. No suele usarse directamente en el código de la aplicación.
`LoadOptions`	Clase base para todos los objetos de opciones de carga específicos de formato. Subclase de `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Clase base para todos los objetos de opciones de guardado específicos de formato. Subclase de `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Formato OBJ

Methods	Methods
`ObjImporter`	Clase interna de importador que analiza archivos Wavefront OBJ y MTL. Invocada automáticamente por `Scene.from_file()` para `.obj` extensiones.
`ObjLoadOptions`	Opciones de carga para archivos Wavefront OBJ. Propiedades clave: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Opciones de guardado para la salida Wavefront OBJ. Controla normales, UVs, referencias de material y modo de nube de puntos.
`ObjFormat`	Descriptor de formato para Wavefront OBJ. Accesible como `FileFormat.WAVEFRONT_OBJ()`.

Formato STL

Methods	Methods
`StlImporter`	Importador interno que lee archivos STL tanto binarios como ASCII. Seleccionado automáticamente por extensión.
`StlExporter`	Exportador interno que escribe STL.
`StlLoadOptions`	Opciones de carga para archivos STL. Soporta `flip_coordinate_system` y `scale`.
`StlSaveOptions`	Opciones de guardado para la salida STL. Controles `binary_mode`, `scale`, y `flip_coordinate_system`.
`StlFormat`	Descriptor de formato para STL.

Formato glTF

Methods	Methods
`GltfLoadOptions`	Opciones de carga para archivos glTF 2.0 y GLB. Propiedad clave: `flip_tex_coord_v`.
`GltfSaveOptions`	Opciones de guardado para la salida glTF 2.0. Usar `binary_mode=True` para un paquete GLB autocontenido.
`GltfFormat`	Descriptor de formato para glTF 2.0 / GLB. Accesible como `FileFormat.GLTF2()`.

Formato FBX

Methods	Methods
`FbxLoadOptions`	Opciones de carga para archivos FBX. Propiedades clave: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Opciones de guardado para la salida FBX. La exportación FBX genera `NotImplementedError` incondicionalmente; `FbxSaveOptions` existe pero la exportación no está implementada.
`FbxFormat`	Descriptor de formato para FBX. Accesible como `FileFormat.FBX7400ASCII()`.

Formato COLLADA

Methods	Methods
`ColladaLoadOptions`	Opciones de carga para COLLADA (`.dae`) archivos. Controla el remapeo de ejes y la escala de unidades al importar.
`ColladaSaveOptions`	Opciones de guardado para la salida COLLADA. Controla `indented`, `flip_coordinate_system`, y la exportación de materiales.
`ColladaFormat`	Descriptor de formato para COLLADA. Resuelto automáticamente a partir de `.dae` la extensión del archivo.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Opciones de carga para 3MF (`.3mf`) archivos.
`ThreeMfSaveOptions`	Opciones de guardado para la salida 3MF. 3MF es el formato preferido para flujos de trabajo de impresión 3D.
`ThreeMfFormat`	Descriptor de formato para 3MF. Accesible como `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Identifica cómo se asigna una textura a la geometría: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, etc.
`BooleanOperation`	Tipo de operación booleana CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistema de Propiedades

Methods	Methods
`Property`	Una única propiedad tipada con nombre en un `A3DObject`. Almacena el nombre de la propiedad, el descriptor de tipo y el valor actual.
`PropertyCollection`	Colección iterable de `Property` objetos adjuntos a un `A3DObject`. Soporta búsqueda por nombre e iteración sobre todas las propiedades definidas.
`CustomObject`	Una versión ligera `A3DObject` subclase que solo lleva un nombre y un arbitrario `PropertyCollection`. Utilizado para almacenar metadatos definidos por el usuario en objetos de escena.

Imagen y Renderizado

Methods	Methods
`ImageRenderOptions`	Opciones para la rasterización por software al renderizar una escena a un búfer de imagen. Almacena el color de fondo, las dimensiones de la imagen y la referencia de la cámara. `Scene.render()` lanza `NotImplementedError`; el renderizado no está implementado en esta versión.

Aspose.3D FOSS for Python

Núcleo del Grafo de Escena

Geometría y Malla

Transformación y Espacial

Materiales y Sombreado

Cámara y Iluminación

Utilidades Matemáticas

Methods

E/S de Formatos

Formato OBJ

Formato STL

Formato glTF

Formato FBX

Formato COLLADA

3MF Format

Methods

Sistema de Propiedades

Imagen y Renderizado

Ver también