Referencia de API para Aspose.3D 26.1.0 (.NET 10.0+, licencia MIT).
Todas las clases se encuentran en el Aspose.ThreeD espacio de nombres raíz. La directiva using raíz es:
Convención de nomenclatura en C#: Todas las propiedades utilizan la sintaxis estándar de propiedades de C#. Por ejemplo, use scene.RootNode en lugar de scene.getRootNode(), y transform.Translation = ... en lugar de transform.setTranslation(...).
Capitalización de campos vectoriales: La biblioteca tiene dos conjuntos de tipos de vectores. Aspose.ThreeD.Utilities.Vector2/3/4 (usado por Mesh.ControlPoints, geometry y la mayoría de las operaciones matemáticas) son doble precisión con minúsculas campos públicos (v.x, v.y, v.z, v.w). Los más simples Aspose.ThreeD.Vector2/3/4 estructuras (en Vector.cs) son precisión simple (float) con mayúsculas campos públicos (v.X, v.Y, v.Z). FVector2/3/4 y Quaternion y Matrix4 utiliza acceso a campos en mayúsculas. Usa Aspose.ThreeD.Utilities tipos para trabajo de geometría.
Grafo de Escena Central
| Methods | Methods |
|---|
Scene | Contenedor de nivel superior para todos los datos de escena 3D. Contiene el nodo raíz, los metadatos de los recursos y los clips de animación. Expone Open() y Save() como los puntos de entrada principales de E/S. |
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 una 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 el Name propiedad y el Properties colección. |
INamedObject | Interfaz que garantiza un Name propiedad. Implementada por Node, Entity, y varios tipos de descriptores 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 similares a mallas. 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 MappingMode, ReferenceMode, y una lista de datos. |
VertexElementNormal | Almacena un vector normal por vértice o por esquina de polígono, según el modo de mapeo. |
VertexElementUV | Almacena pares de coordenadas de textura (Vector2) por vértice o por esquina de polígono. |
VertexElementVertexColor | Almacena datos de color RGBA por vértice o por esquina como Vector4. |
Primitivas Incorporadas
| Methods | Methods |
|---|
Box | Caja paramétrica alineada a los ejes con ancho, alto y profundidad configurables. Puede adjuntarse a un Node directamente o convertirse en Mesh a través de ToMesh(). |
Sphere | Esfera paramétrica con radio configurable. Soporta ToMesh() conversión. |
Cylinder | Cilindro paramétrico con radio superior, radio inferior y altura configurables. Soporta ToMesh() conversión. |
Transformación y Espacial
| Methods | Methods |
|---|
Transform | Transformación local adjunta a un Node. Proporciona Translation (FVector3), Rotation (Quaternion), Scale (FVector3), y Matrix (Matrix4) propiedades. |
GlobalTransform | Vista de solo lectura de la matriz de transformación en espacio mundial de un nodo después de componer todas las transformaciones de los ancestros. Accedido a través de node.GlobalTransform. Expone una única Matrix propiedad. |
AssetInfo | Bloque de metadatos adjunto a un Scene. Hereda de A3DObject que proporciona Name y Properties. No se definen propiedades adicionales en esta edició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. |
LambertMaterial | Material clásico solo difuso con Ambient, Diffuse, Emissive, Reflective, Transparency, y Texture propiedades. Espacio de nombres: Aspose.ThreeD.Shading. |
PhongMaterial | Amplía Lambert con Specular, Shininess, y SpecularPower propiedades. Espacio de nombres: Aspose.ThreeD.Shading. |
PbrMaterial | Material de Renderizado Basado en la Física con BaseColor, Metallic, Roughness, Occlusion, y propiedades de ranura de textura. Espacio de nombres: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entidad de cámara. Hereda de Frustum. Adjunta a una Node para definir transformaciones de punto de vista. No se exponen propiedades específicas del formato en esta edición. |
Utilidades Matemáticas
| Methods | Methods |
|---|
Vector2 | Precisión doble 2-component vector (lowercase fields: x, y). Espacio de nombres: Aspose.ThreeD.Utilities. Usado para coordenadas de textura UV. |
Vector3 | Precisión doble 3-component vector (lowercase fields: x, y, z). Espacio de nombres: Aspose.ThreeD.Utilities. Vector espacial de propósito general para geometría. |
Vector4 | Precisión doble 4-component vector (lowercase fields: x, y, z, w). Espacio de nombres: Aspose.ThreeD.Utilities. Usado para Mesh.ControlPoints y datos de normales. |
FVector3 | Vector de punto flotante de precisión simple de 3 componentes (campos en mayúsculas: X, Y, Z). Usado por Transform.Translation y Transform.Scale. |
FVector4 | Vector de punto flotante de precisión simple de 4 componentes (campos en mayúsculas: X, Y, Z, W). |
Quaternion | Cuaternión unitario para representar rotaciones (W, X, Y, Z). Usado por Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Caja delimitadora alineada a los ejes definida por Minimum y Maximum FVector3 esquinas. |
Methods
| Methods | Methods |
|---|
AnimationClip | Contenedor nombrado para un rango de animación. Un Scene puede contener varios clips. Esqueleto de declaración — los datos de fotogramas clave y la reproducción aún no están implementados. |
Entrada/Salida de Formatos
| Methods | Methods |
|---|
Scene.Open(path) | Abre un archivo, detecta el formato a partir de la extensión y rellena la escena. |
Scene.Open(path, options) | Abre un archivo con formato específico LoadOptions. |
Scene.Open(stream) | Abre desde un flujo, detectando automáticamente el formato a partir del contenido. |
Scene.Open(stream, options) | Abre desde un flujo con formato específico LoadOptions. |
Scene.Save(path) | Guarda la escena en un archivo; el formato se infiere de la extensión. |
Scene.Save(path, options) | Guarda con formato específico SaveOptions. |
Scene.Save(stream, options) | Guarda en un flujo con formato específico SaveOptions. |
FileFormat | Registro de formatos de archivo compatibles. Use FileFormat.Formats (un IList<FileFormat>) para enumerar todos los formatos compatibles, o FileFormat.Detect(fileName) para detectar un formato por nombre de archivo. Las constantes nombradas (ObjFormat, GltfFormat, FbxFormat, etc.) son internal y no son accesibles desde el código del usuario. |
IOService | Abstracción interna de E/S. Proporciona DetectFormat() para la detección de formatos basada en flujos. |
LoadOptions | Clase base para opciones de carga específicas de formato. |
SaveOptions | Clase base para opciones de guardado específicas de formato. |
Formato OBJ
Formato STL
Formato glTF
| Methods | Methods |
|---|
GltfLoadOptions | Cargar opciones para archivos glTF 2.0 y GLB. |
GltfSaveOptions | Guardar opciones para la salida glTF 2.0 y GLB. No se exponen propiedades específicas del formato en esta edición; use .glb extensión para salida binaria. |
Formato FBX
| Methods | Methods |
|---|
FbxLoadOptions | Cargar opciones para archivos FBX. |
FbxSaveOptions | Guardar opciones para la salida FBX. La exportación FBX siempre produce salida binaria; la exportación FBX ASCII no está activa en esta versión. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Descriptor de tipo de contenido: ASCII, Binary. Disponible como una propiedad en FileFormat. |
Axis | Identifica un eje de coordenadas: XAxis, YAxis, ZAxis. |
CoordinateSystem | Especifica la convención de mano: RightHand o LeftHand. |
Sistema de Propiedades
| Methods | Methods |
|---|
Property | Una única propiedad tipada con nombre en un A3DObject. |
PropertyCollection | Colección iterable de Property objetos adjuntos a un A3DObject. |
Ver también