Aspose.3D FOSS for Python

Referência da API para aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, licença MIT).

Todas as classes são importadas de aspose.threed pacote ou de seus subpacotes. A importação raiz é:

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

Grafo de Cena Core

Methods	Methods
`Scene`	Contêiner de nível superior para todos os dados da cena 3D. Contém o nó raiz, metadados de ativos e clipes de animação. Expõe `from_file()`, `open()`, e `save()` como os principais pontos de entrada de E/S.
`Node`	Um nó nomeado na hierarquia da cena. Possui uma lista de nós filhos e uma lista de `Entity` objetos como malhas, câmeras e luzes. Carrega um `Transform`.
`Entity`	Classe base abstrata para todos os objetos que podem ser anexados a um `Node`. Fornece nome e identidade, mas não tem geometria própria.
`SceneObject`	Classe base compartilhada por `Node` e `Entity`. Fornece a interface de coleção de propriedades usada para metadados definidos pelo usuário.
`A3DObject`	Classe base raiz para todos os objetos gerenciados Aspose.3D. Expõe a propriedade de nome e o `Properties` coleção.
`INamedObject`	Interface que garante um `name` propriedade. Implementada por `Node`, `Entity`, e vários tipos de descritores específicos de formato.

Geometria e Malha

Methods	Methods
`Mesh`	Entidade de malha poligonal. Armazena pontos de controle (posições dos vértices como `Vector4`), listas de faces poligonais (listas de índices de pontos de controle) e camadas de elementos de vértice (normais, UVs, cores de vértice).
`Geometry`	Base abstrata para tipos de geometria semelhantes a malha. Define o array de pontos de controle e a coleção de `VertexElement` camadas. `Mesh` herda de `Geometry`.
`VertexElement`	Base abstrata para uma camada de dados anexada à geometria (normais, UVs, cores, etc.). Carrega `mapping_mode`, `reference_mode`, e um `data` lista.
`VertexElementNormal`	Armazena um vetor normal por vértice ou por canto de polígono, dependendo de `mapping_mode`. Os valores de dados são `FVector4` instâncias (precisão simples) com `w` não utilizado.
`VertexElementUV`	Armazena dados de coordenadas de textura como `FVector4` por vértice ou por canto do polígono (apenas `x` e `y` componentes são usados para UV). Uma malha pode conter múltiplas camadas UV para diferentes canais de textura.
`VertexElementVertexColor`	Armazena dados de cor RGBA por vértice ou por canto como `FVector4` (r, g, b, a no intervalo 0–1).
`VertexElementSmoothingGroup`	Armazena IDs inteiros de grupos de suavização por polígono, usados pelo importador OBJ para reproduzir as atribuições originais de grupos de suavização do arquivo fonte.
`VertexElementType`	Enumeração que identifica a função semântica de uma camada de elemento de vértice: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, e outros. Passe valores para `Mesh.get_element()`.
`MappingMode`	Enumeração que controla a qual primitiva um valor de elemento de vértice é mapeado: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, ou `ALL_SAME`.
`ReferenceMode`	Enumeração que controla como os valores são indexados: `DIRECT` (um valor por primitivo de mapeamento) ou `INDEX_TO_DIRECT` (array de valores mais um array de índices separado).
`PolygonModifier`	Classe utilitária estática com métodos para triangular `Mesh` objetos e todo `Scene` grafos.

Transformação e Espacial

Methods	Methods
`Transform`	Transformação local anexada a um `Node`. Fornece translação, rotação (como `Quaternion`), e componentes de escala, além de propriedades convenientes para ângulos de Euler.
`GlobalTransform`	Visão somente leitura da transformação em espaço mundial de um nó após compor todas as transformações ancestrais. Acessada via `Node.global_transform`.
`AssetInfo`	Bloco de metadados anexado a um `Scene`. Armazena o nome da aplicação de autoria, nome da unidade, fator de escala da unidade, definições dos eixos do sistema de coordenadas e timestamps de criação/modificação.

Materiais e Sombreamento

Methods	Methods
`Material`	Classe base abstrata para todos os tipos de material. Fornece um nome e uma coleção de propriedades para parâmetros numéricos e de cor.
`LambertMaterial`	Modelo de material apenas difuso. Armazena cor ambiente, cor difusa, cor emissiva e transparência. Carregado a partir de arquivos OBJ que utilizam básico `Ka`/`Kd`/`Ke` declarações.
`PhongMaterial`	Methods `LambertMaterial` com cor especular e brilho (expoente especular). Carregado a partir de arquivos OBJ que utilizam `Ks`/`Ns` declarações.
`PbrMaterial`	Material Physically Based Rendering. Armazena albedo, fator metálico, fator de rugosidade e texturas associadas. Utilizado por glTF 2.0 e outros formatos compatíveis com PBR.

Câmera e Iluminação

Methods	Methods
`Camera`	Entidade de câmera. Apenas `projection_type` e `name` são funcionais nesta edição; todas as outras propriedades numéricas (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) são stubs que retornam valores padrão. Anexado a um `Node` para definir transformações de ponto de vista.
`Light`	Entidade de fonte de luz. Herda de `Camera` como uma classe stub; o `Light` próprio da classe não expõe propriedades adicionais nesta versão.
`LightType`	Enumeração das categorias de luz suportadas: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumeração dos modos de projeção da câmera: `PERSPECTIVE` e `ORTHOGRAPHIC`.

Utilitários Matemáticos

Methods	Methods
`Vector2`	Vetor de dupla precisão com 2 componentes (`x`, `y`). Usado para coordenadas de textura UV.
`Vector3`	Vetor de dupla precisão com 3 componentes (`x`, `y`, `z`). Usado para posições, direções e escala.
`Vector4`	Vetor de dupla precisão com 4 componentes (`x`, `y`, `z`, `w`). Usado para pontos de controle (posições homogêneas) e dados de normais.
`FVector2`	Vetor float de precisão simples com 2 componentes. Usado internamente para armazenamento compacto em arrays de dados de elementos de vértice.
`FVector3`	Vetor float de precisão simples com 3 componentes. Aparece em arrays de dados de elementos de vértice para normais e tangentes.
`FVector4`	Vetor float de precisão simples com 4 componentes. O tipo de armazenamento de `VertexElementFVector.data`.
`Quaternion`	Quatérnio unitário para representar rotações (`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`	Caixa delimitadora alinhada aos eixos definida por `minimum` e `maximum` `Vector3` cantos. Usado para consultas espaciais e auxiliares de recorte de frustum.

Methods

Methods	Methods
`AnimationClip`	Contêiner nomeado para um conjunto de canais animados que cobrem um intervalo de reprodução. Um `Scene` pode conter vários clipes (por exemplo, “Walk”, “Run”).
`AnimationNode`	Vincula um `AnimationClip` a um nó de cena ou propriedade específico. Atua como a ponte entre os dados do clipe e os objetos do grafo de cena.
`AnimationChannel`	Um único fluxo de propriedade animada dentro de um clipe, direcionado a uma propriedade nomeada em um objeto (por exemplo,., `Transform.translation.x`).
`KeyFrame`	Uma única amostra de tempo–valor dentro de um `KeyframeSequence`. Armazena o tempo (em segundos) e o valor naquele instante.
`KeyframeSequence`	Uma lista ordenada de `KeyFrame` objetos para um canal escalar, juntamente com configurações de interpolação e extrapolação.
`Interpolation`	Enumeração dos modos de interpolação entre quadros‑chave: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumeração dos comportamentos além do primeiro e do último quadro‑chave: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

I/O de Formato

Methods	Methods
`Scene.from_file(path)`	Método estático. Abre o arquivo em `path`, detecta o formato a partir da extensão e retorna um preenchido `Scene`. Levanta exceção quando o arquivo não é encontrado ou o formato não é suportado.
`Scene.open(path, options=None)`	Método de instância. Abre um arquivo em uma instância existente `Scene` instância, opcionalmente usando um específico de formato `LoadOptions` subclasse.
`Scene.save(path, options=None)`	Método de instância. Serializa a cena para `path` usando o formato inferido a partir da extensão, opcionalmente usando um específico de formato `SaveOptions` subclasse.
`FileFormat`	Registro de formatos de arquivo suportados. Contém entradas como `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Variantes específicas de formato são acessadas via classes de opção (por exemplo,., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Abstração interna de E/S usada por importadores e exportadores de formato. Normalmente não é usada diretamente pelo código da aplicação.
`LoadOptions`	Classe base para todos os objetos de opções de carregamento específicos de formato. Subclasse de `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Classe base para todos os objetos de opções de salvamento específicos de formato. Subclasse de `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Formato OBJ

Methods	Methods
`ObjImporter`	Classe interna de importação que analisa arquivos Wavefront OBJ e MTL. Invocada automaticamente por `Scene.from_file()` para `.obj` extensões.
`ObjLoadOptions`	Opções de carregamento para arquivos Wavefront OBJ. Propriedades principais: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Opções de salvamento para saída Wavefront OBJ. Controla normais, UVs, referências de material e modo de nuvem de pontos.
`ObjFormat`	Descritor de formato para Wavefront OBJ. Acessível como `FileFormat.WAVEFRONT_OBJ()`.

Formato STL

Methods	Methods
`StlImporter`	Importador interno que lê arquivos STL binários e ASCII. Selecionado automaticamente por extensão.
`StlExporter`	Exportador interno que grava STL.
`StlLoadOptions`	Opções de carregamento para arquivos STL. Suporta `flip_coordinate_system` e `scale`.
`StlSaveOptions`	Opções de salvamento para saída STL. Controles `binary_mode`, `scale`, e `flip_coordinate_system`.
`StlFormat`	Descritor de formato para STL.

Formato glTF

Methods	Methods
`GltfLoadOptions`	Opções de carregamento para arquivos glTF 2.0 e GLB. Propriedade chave: `flip_tex_coord_v`.
`GltfSaveOptions`	Opções de salvamento para saída glTF 2.0. Use `binary_mode=True` para um pacote GLB autônomo.
`GltfFormat`	Descritor de formato para glTF 2.0 / GLB. Acessível como `FileFormat.GLTF2()`.

Formato FBX

Methods	Methods
`FbxLoadOptions`	Opções de carregamento para arquivos FBX. Propriedades chave: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Opções de salvamento para saída FBX. A exportação FBX gera `NotImplementedError` incondicionalmente; `FbxSaveOptions` existe, mas a exportação não está implementada.
`FbxFormat`	Descritor de formato para FBX. Acessível como `FileFormat.FBX7400ASCII()`.

Formato COLLADA

Methods	Methods
`ColladaLoadOptions`	Opções de carregamento para COLLADA (`.dae`) arquivos. Controla o remapeamento de eixos e a escala de unidades na importação.
`ColladaSaveOptions`	Opções de salvamento para saída COLLADA. Controla `indented`, `flip_coordinate_system`, e exportação de material.
`ColladaFormat`	Descritor de formato para COLLADA. Resolvido automaticamente a partir de `.dae` da extensão do arquivo.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Opções de carregamento para 3MF (`.3mf`) arquivos.
`ThreeMfSaveOptions`	Opções de salvamento para saída 3MF. 3MF é o formato preferido para fluxos de trabalho de impressão 3D.
`ThreeMfFormat`	Descritor de formato para 3MF. Acessível como `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Identifica como uma textura é mapeada para a geometria: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, etc.
`BooleanOperation`	Tipo de operação booleana CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistema de Propriedades

Methods	Methods
`Property`	Uma única propriedade tipada nomeada em um `A3DObject`. Armazena o nome da propriedade, o descritor de tipo e o valor atual.
`PropertyCollection`	Coleção iterável de `Property` objetos anexados a um `A3DObject`. Suporta busca por nome e iteração sobre todas as propriedades definidas.
`CustomObject`	Um(a) leve `A3DObject` subclasse que contém apenas um nome e um valor arbitrário `PropertyCollection`. Usado para armazenar metadados definidos pelo usuário em objetos de cena.

Imagem e Renderização

Methods	Methods
`ImageRenderOptions`	Opções para rasterização por software ao renderizar uma cena para um buffer de imagem. Armazena a cor de fundo, as dimensões da imagem e a referência da câmera. `Scene.render()` levanta `NotImplementedError`; a renderização não está implementada nesta versão.

Aspose.3D FOSS for Python

Grafo de Cena Core

Geometria e Malha

Transformação e Espacial

Materiais e Sombreamento

Câmera e Iluminação

Utilitários Matemáticos

Methods

I/O de Formato

Formato OBJ

Formato STL

Formato glTF

Formato FBX

Formato COLLADA

3MF Format

Methods

Sistema de Propriedades

Imagem e Renderização

Veja Também