Referência da API para aspose-3d-foss 26.1.0 (Java 21+, licença MIT).
Todas as classes residem em com.aspose.threed pacote raiz. A importação raiz é:
Estrutura de pacotes: Quase todas as classes públicas estão em com.aspose.threed. O único subpacote tipicamente usado é com.aspose.threed.shading (para PbrMaterial). O com.aspose.threed.formats subpacote contém importadores/exportadores internos e normalmente não é importado diretamente.
Convenção de nomenclatura Java: Todas as propriedades utilizam métodos getter/setter. Por exemplo, use node.getTransform() em vez de node.transform, e transform.setTranslation(...) em vez de transform.translation = .... Observe que Vector3, Vector4, Quaternion, Matrix4, e FVector tipos utilizam campos públicos (v.x, v.y, v.z) em vez de getters para acesso a componentes.
Grafo de Cena Central
| Enumerations | Enumerations |
|---|
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 fromFile(), 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 anexados Entity objetos como malhas, câmeras e luzes. Carrega um local Transform. |
Entity | Classe base abstrata para todos os objetos que podem ser anexados a um Node. Fornece nome e identidade, mas nenhuma 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 name e o Properties coleção. |
INamedObject | Interface que garante um getName() método. Implementado por Node, Entity, e vários tipos de descritores específicos de formato. |
Geometria e Malha
| Enumerations | Enumerations |
|---|
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 getMappingMode(), getReferenceMode(), e uma lista de dados. |
VertexElementNormal | Armazena um vetor normal por vértice ou por canto do polígono, dependendo do modo de mapeamento. Os valores de dados são Vector4 instâncias com w não usado. |
VertexElementUV | Armazena pares de coordenadas de textura (Vector2) por vértice ou por canto de polígono. Uma malha pode conter várias camadas UV para diferentes canais de textura. |
VertexElementVertexColor | Armazena dados de cor RGBA por vértice ou por canto como Vector4 (r, g, b, a no intervalo de 0–1). |
VertexElementType | Enumeração que identifica o papel semântico de uma camada de elemento de vértice: NORMAL, UV, VERTEX_COLOR, e outros. Passe valores para Mesh.getElement(). |
MappingMode | Enumeração que controla a qual primitiva um valor de elemento de vértice mapeia: CONTROL_POINT, POLYGON_VERTEX, ou POLYGON. |
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). |
Transformação e Espacial
| Enumerations | Enumerations |
|---|
Transform | Transformação local anexada a um Node. Fornece translação, rotação (como Quaternion), e componentes de escala, além de métodos 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.getGlobalTransform(). |
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
| Enumerations | Enumerations |
|---|
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. |
PbrMaterial | Material de Renderização Baseada em Física. Armazena albedo, fator metálico, fator de rugosidade, cor emissiva, transparência e texturas associadas. Usado por glTF 2.0 e outros formatos compatíveis com PBR. Importar: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Entidade de câmera. Herda de Entity. Nenhuma propriedade específica de formato é exposta na edição FOSS do Java além do nome herdado e da coleção de propriedades. Anexado a um Node para definir transformações de ponto de vista. |
Nota: Enumerations Light classe não está disponível na edição Java do Aspose.3D FOSS. Dados de iluminação da cena de arquivos importados são armazenados como genéricos Entity objetos.
Utilitários Matemáticos
| Enumerations | Enumerations |
|---|
Vector2 | Vetor de 2 componentes de dupla precisão (x, y). Usado para coordenadas de textura UV. |
Vector3 | Vetor de 3 componentes de dupla precisão (x, y, z). Usado para posições, direções e escala. |
Vector4 | Vetor de 4 componentes de dupla precisão (x, y, z, w). Usado para pontos de controle (posições homogêneas) e dados de normais. |
FVector3 | Vetor de ponto flutuante de precisão simples com 3 componentes. Aparece em arrays de dados de elementos de vértice para normais e tangentes. |
FVector4 | Vetor de ponto flutuante de precisão simples com 4 componentes. O tipo de armazenamento de VertexElementFVector dados. |
Quaternion | Quatérnio unitário para representar rotações (w, x, y, z). Usado por Transform.getRotation(). |
Matrix4 | 4x4 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 getMinimum() e getMaximum() Vector3 cantos. Usado para consultas espaciais e auxiliares de recorte de frustum. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Contêiner nomeado para um intervalo de animação. Um Scene pode conter múltiplos clipes (por exemplo, “Walk”, “Run”). Stub de declaração — os dados de keyframe e a reprodução ainda não foram implementados. |
I/O de Formato
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Método estático. Abre o arquivo em path, detecta o formato a partir da extensão e retorna um(a) populado(a) Scene. Lança exceção se o arquivo não for encontrado ou se o formato não for suportado. |
Scene.open(path, options) | Método de instância. Abre um arquivo em uma instância existente Scene , opcionalmente usando um(a) específico(a) de formato LoadOptions subclasse. |
Scene.save(path, options) | Método de instância. Serializa a cena para path usando o formato inferido a partir da extensão, opcionalmente usando um(a) específico(a) de formato SaveOptions subclasse. |
FileFormat | Registro de formatos de arquivo suportados. Contém entradas como FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Abstração interna de E/S usada por importadores e exportadores de formatos. 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. Subclassificada por ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Classe base para todos os objetos de opções de salvamento específicos de formato. Subclassificada por ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Formato OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Classe interna de importação que analisa arquivos Wavefront OBJ e MTL. Invocada automaticamente por Scene.fromFile() para .obj extensões. |
ObjLoadOptions | Opções de carregamento para arquivos Wavefront OBJ. Propriedades principais: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
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
| Enumerations | Enumerations |
|---|
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 setFlipCoordinateSystem(), setRecalculateNormal(), e setContentType(). |
StlSaveOptions | Opções de salvamento para saída STL. Controla setFlipCoordinateSystem(), setAxisSystem(), e setContentType(). |
StlFormat | Descritor de formato para STL. |
Formato glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Opções de carregamento para arquivos glTF 2.0 e GLB. Propriedades principais: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Opções de salvamento para saída glTF 2.0 e GLB. Use setContentType(FileContentType.BINARY) para produzir um autocontido .glb pacote. |
GltfFormat | Descritor de formato para glTF 2.0 / GLB. Acessível como FileFormat.GLTF2(). |
Formato FBX
FBX é suportado para apenas importação. Exportar para FBX não está disponível na edição Java FOSS.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Opções de carregamento para arquivos FBX. Propriedade chave: setFlipCoordinateSystem(). |
FbxFormat | Descritor de formato para FBX. Acessível como FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identifica um eixo de coordenada: X_AXIS, Y_AXIS, Z_AXIS. Usado nas opções de remapeamento de sistema de coordenadas. |
CoordinateSystem | Especifica a convenção de orientação: RIGHT_HANDED ou LEFT_HANDED. |
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
| Enumerations | Enumerations |
|---|
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 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
| Enumerations | Enumerations |
|---|
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. Este recurso está disponível nas configurações suportadas. |
Veja também
