Referência da API para Aspose.3D 26.1.0 (.NET 10.0+, licença MIT).
Todas as classes residem no Aspose.ThreeD namespace raiz. A diretiva using raiz é:
Convenção de nomenclatura C#: Todas as propriedades utilizam a sintaxe padrão de propriedades C#. Por exemplo, use scene.RootNode em vez de scene.getRootNode(), e transform.Translation = ... em vez de transform.setTranslation(...).
Capitalização de campos vetoriais: A biblioteca tem dois conjuntos de tipos de vetor. Aspose.ThreeD.Utilities.Vector2/3/4 (usado por Mesh.ControlPoints, geometry e a maioria das operações matemáticas) são precisão dupla com minúsculas campos públicos (v.x, v.y, v.z, v.w). Os mais simples Aspose.ThreeD.Vector2/3/4 structs (em Vector.cs) são precisão simples (float) com maiúsculas campos públicos (v.X, v.Y, v.Z). FVector2/3/4 e Quaternion e Matrix4 use acesso a campos em maiúsculas. Use Aspose.ThreeD.Utilities tipos para trabalho de geometria.
Grafo de Cena Central
| Methods | Methods |
|---|
Scene | Contêiner de nível superior para todos os dados de cena 3D. Contém o nó raiz, metadados de ativos e clipes de animação. Expõe 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 não possui 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 o Name propriedade e o Properties coleção. |
INamedObject | Interface que garante um Name propriedade. Implementado 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 MappingMode, ReferenceMode, e uma lista de dados. |
VertexElementNormal | Armazena um vetor normal por vértice ou por canto do polígono, dependendo do modo de mapeamento. |
VertexElementUV | Armazena pares de coordenadas de textura (Vector2) por vértice ou por canto do polígono. |
VertexElementVertexColor | Armazena dados de cor RGBA por vértice ou por canto como Vector4. |
Primitivas Incorporadas
| Methods | Methods |
|---|
Box | Caixa paramétrica alinhada aos eixos com largura, altura e profundidade configuráveis. Pode ser anexada a um Node diretamente ou convertida para Mesh via ToMesh(). |
Sphere | Esfera paramétrica com raio configurável. Suporta ToMesh() conversão. |
Cylinder | Cilindro paramétrico com raio superior, raio inferior e altura configuráveis. Suporta ToMesh() conversão. |
Transformação e Espacial
| Methods | Methods |
|---|
Transform | Transformação local anexada a um Node.Fornece Translation (FVector3), Rotation (Quaternion), Scale (FVector3), and Matrix (Matrix4) properties. |
GlobalTransform | Visão somente leitura da matriz de transformação no espaço mundial de um nó após compor todas as transformações dos ancestrais. Acessado via node.GlobalTransform. Expõe um único Matrix propriedade. |
AssetInfo | Bloco de metadados anexado a um Scene. Herda de A3DObject fornecendo Name e Properties. Nenhuma propriedade adicional é definida nesta ediçã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. |
LambertMaterial | Material clássico apenas difuso com Ambient, Diffuse, Emissive, Reflective, Transparency, e Texture propriedades. Namespace: Aspose.ThreeD.Shading. |
PhongMaterial | Estende Lambert com Specular, Shininess, e SpecularPower propriedades. Namespace: Aspose.ThreeD.Shading. |
PbrMaterial | Material de Renderização Baseada em Física com BaseColor, Metallic, Roughness, Occlusion, e propriedades de slot de textura. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entidade de câmera. Herda de Frustum. Anexado a um Node para definir transformações de ponto de vista. Nenhuma propriedade específica de formato é exposta nesta edição. |
Utilitários Matemáticos
| Methods | Methods |
|---|
Vector2 | Precisão dupla 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Usado para coordenadas de textura UV. |
Vector3 | Precisão dupla 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Vetor espacial de uso geral para geometria. |
Vector4 | Precisão dupla 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. Usado para Mesh.ControlPoints e dados normais. |
FVector3 | Vetor de ponto flutuante de precisão simples com 3 componentes (campos em maiúsculas: X, Y, Z) Transform.Translation e Transform.Scale. |
FVector4 | Vetor de ponto flutuante de precisão simples com 4 componentes (campos em maiúsculas: X, Y, Z, W). |
Quaternion | Quaternión unitário para representar rotações (W, X, Y, Z). Usado por Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Caixa delimitadora alinhada aos eixos definida por Minimum e Maximum FVector3 cantos. |
Methods
| Methods | Methods |
|---|
AnimationClip | Contêiner nomeado para um intervalo de animação. Um Scene pode conter vários clipes. Stub de declaração — os dados de keyframe e a reprodução ainda não foram implementados. |
Entrada/Saída de Formato
| Methods | Methods |
|---|
Scene.Open(path) | Abre um arquivo, detecta o formato a partir da extensão e preenche a cena. |
Scene.Open(path, options) | Abre um arquivo com formato específico LoadOptions. |
Scene.Open(stream) | Abre a partir de um fluxo, detectando automaticamente o formato a partir do conteúdo. |
Scene.Open(stream, options) | Abre a partir de um fluxo com formato específico LoadOptions. |
Scene.Save(path) | Salva a cena em um arquivo; formato inferido a partir da extensão. |
Scene.Save(path, options) | Salva com formato específico SaveOptions. |
Scene.Save(stream, options) | Salva em um fluxo com formato específico SaveOptions. |
FileFormat | Registro de formatos de arquivo suportados. Use FileFormat.Formats (um IList<FileFormat>) para enumerar todos os formatos suportados, ou FileFormat.Detect(fileName) para detectar um formato pelo nome do arquivo. As constantes nomeadas (ObjFormat, GltfFormat, FbxFormat, etc.) são internal e não são acessíveis a partir do código do usuário. |
IOService | Abstração interna de E/S. Fornece DetectFormat() para detecção de formato baseada em fluxo. |
LoadOptions | Classe base para opções de carregamento específicas de formato. |
SaveOptions | Classe base para opções de salvamento específicas de formato. |
Formato OBJ
Formato STL
Formato glTF
| Methods | Methods |
|---|
GltfLoadOptions | Carregar opções para arquivos glTF 2.0 e GLB. |
GltfSaveOptions | Salvar opções para saída glTF 2.0 e GLB. Nenhuma propriedade específica de formato é exposta nesta edição; use .glb extensão para saída binária. |
Formato FBX
| Methods | Methods |
|---|
FbxLoadOptions | Carregar opções para arquivos FBX. |
FbxSaveOptions | Salvar opções para saída FBX. A exportação FBX sempre produz saída binária; a exportação FBX ASCII não está ativa nesta versão. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Descritor de tipo de conteúdo: ASCII, Binary. Disponível como uma propriedade em FileFormat. |
Axis | Identifica um eixo de coordenadas: XAxis, YAxis, ZAxis. |
CoordinateSystem | Especifica a convenção de orientação: RightHand ou LeftHand. |
Sistema de Propriedades
| Methods | Methods |
|---|
Property | Uma única propriedade tipada nomeada em um A3DObject. |
PropertyCollection | Coleção iterável de Property objetos anexados a um A3DObject. |
Veja Também
