Aspose.3D FOSS for .NET

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:

using Aspose.ThreeD;

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

MethodsMethods
SceneContenedor 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.
NodeUn 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.
EntityClase base abstracta para todos los objetos que pueden adjuntarse a un Node. Proporciona nombre e identidad pero no tiene geometría propia.
SceneObjectClase base compartida por Node y Entity. Proporciona la interfaz de colección de propiedades utilizada para metadatos definidos por el usuario.
A3DObjectClase base raíz para todos los objetos gestionados Aspose.3D. Expone el Name propiedad y el Properties colección.
INamedObjectInterfaz que garantiza un Name propiedad. Implementada por Node, Entity, y varios tipos de descriptores específicos de formato.

Geometría y Malla

MethodsMethods
MeshEntidad 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).
GeometryBase 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.
VertexElementBase abstracta para una capa de datos adjunta a la geometría (normales, UVs, colores, etc.). Lleva MappingMode, ReferenceMode, y una lista de datos.
VertexElementNormalAlmacena un vector normal por vértice o por esquina de polígono, según el modo de mapeo.
VertexElementUVAlmacena pares de coordenadas de textura (Vector2) por vértice o por esquina de polígono.
VertexElementVertexColorAlmacena datos de color RGBA por vértice o por esquina como Vector4.

Primitivas Incorporadas

MethodsMethods
BoxCaja 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().
SphereEsfera paramétrica con radio configurable. Soporta ToMesh() conversión.
CylinderCilindro paramétrico con radio superior, radio inferior y altura configurables. Soporta ToMesh() conversión.

Transformación y Espacial

MethodsMethods
TransformTransformación local adjunta a un Node. Proporciona Translation (FVector3), Rotation (Quaternion), Scale (FVector3), y Matrix (Matrix4) propiedades.
GlobalTransformVista 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.
AssetInfoBloque 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

MethodsMethods
MaterialClase base abstracta para todos los tipos de material. Proporciona un nombre y una colección de propiedades.
LambertMaterialMaterial clásico solo difuso con Ambient, Diffuse, Emissive, Reflective, Transparency, y Texture propiedades. Espacio de nombres: Aspose.ThreeD.Shading.
PhongMaterialAmplía Lambert con Specular, Shininess, y SpecularPower propiedades. Espacio de nombres: Aspose.ThreeD.Shading.
PbrMaterialMaterial 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

MethodsMethods
CameraEntidad 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

MethodsMethods
Vector2Precisión doble 2-component vector (lowercase fields: x, y). Espacio de nombres: Aspose.ThreeD.Utilities. Usado para coordenadas de textura UV.
Vector3Precisió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.
Vector4Precisió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.
FVector3Vector de punto flotante de precisión simple de 3 componentes (campos en mayúsculas: X, Y, Z). Usado por Transform.Translation y Transform.Scale.
FVector4Vector de punto flotante de precisión simple de 4 componentes (campos en mayúsculas: X, Y, Z, W).
QuaternionCuaternión unitario para representar rotaciones (W, X, Y, Z). Usado por Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxCaja delimitadora alineada a los ejes definida por Minimum y Maximum FVector3 esquinas.

Methods

MethodsMethods
AnimationClipContenedor 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

MethodsMethods
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.
FileFormatRegistro 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.
IOServiceAbstracción interna de E/S. Proporciona DetectFormat() para la detección de formatos basada en flujos.
LoadOptionsClase base para opciones de carga específicas de formato.
SaveOptionsClase base para opciones de guardado específicas de formato.

Formato OBJ

MethodsMethods
ObjLoadOptionsOpciones de carga para archivos Wavefront OBJ.
ObjSaveOptionsOpciones de guardado para la salida Wavefront OBJ.

Formato STL

MethodsMethods
StlLoadOptionsCargar opciones para archivos STL.
StlSaveOptionsGuardar opciones para la salida STL.

Formato glTF

MethodsMethods
GltfLoadOptionsCargar opciones para archivos glTF 2.0 y GLB.
GltfSaveOptionsGuardar 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

MethodsMethods
FbxLoadOptionsCargar opciones para archivos FBX.
FbxSaveOptionsGuardar 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

MethodsMethods
TmfLoadOptionsCargar opciones para archivos 3MF.
TmfSaveOptionsGuardar opciones para la salida 3MF.

Methods

MethodsMethods
FileContentTypeDescriptor de tipo de contenido: ASCII, Binary. Disponible como una propiedad en FileFormat.
AxisIdentifica un eje de coordenadas: XAxis, YAxis, ZAxis.
CoordinateSystemEspecifica la convención de mano: RightHand o LeftHand.

Sistema de Propiedades

MethodsMethods
PropertyUna única propiedad tipada con nombre en un A3DObject.
PropertyCollectionColección iterable de Property objetos adjuntos a un A3DObject.

Ver también

 Español