Referencia de API para aspose-3d-foss 26.1.0 (Java 21+, licencia MIT).
Todas las clases residen en el com.aspose.threed paquete raíz. La importación raíz es:
Estructura del paquete: Casi todas las clases públicas están en com.aspose.threed. El único subpaquete que se usa típicamente es com.aspose.threed.shading (para PbrMaterial). El com.aspose.threed.formats subpaquete contiene importadores/exportadores internos y normalmente no se importa directamente.
Java convención de nombres: Todas las propiedades usan métodos getter/setter. Por ejemplo, use node.getTransform() en lugar de node.transform, y transform.setTranslation(...) en lugar de transform.translation = .... Nota que Vector3, Vector4, Quaternion, Matrix4, y FVector los tipos usan campos públicos (v.x, v.y, v.z) en lugar de getters para el acceso a componentes.
Grafo de escena central
| Enumerations | Enumerations |
|---|
Scene | Contenedor de nivel superior para todos los datos de la escena 3D. Contiene el nodo raíz, los metadatos de los recursos y los clips de animación. Expone fromFile(), open(), y save() como los puntos de entrada principales de I/O. |
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 un 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 la propiedad de nombre y el Properties colección. |
INamedObject | Interfaz que garantiza un getName() método. Implementado por Node, Entity, y varios tipos de descriptor específicos de formato. |
Geometría y malla
| Enumerations | Enumerations |
|---|
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 tipo malla. Define el arreglo 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 getMappingMode(), getReferenceMode(), y una lista de datos. |
VertexElementNormal | Almacena un vector normal por vértice o por esquina de polígono, dependiendo del modo de mapeo. Los valores de datos son Vector4 instancias con w no usado. |
VertexElementUV | Almacena pares de coordenadas de textura (Vector2) por vértice o por esquina de polígono. Una malla puede contener múltiples capas UV para diferentes canales de textura. |
VertexElementVertexColor | Almacena datos de color RGBA por vértice o por esquina como Vector4 (r, g, b, a en el rango 0–1). |
VertexElementType | Enumeración que identifica el rol semántico de una capa de elemento de vértice: NORMAL, UV, VERTEX_COLOR, y otros. Pasa valores a Mesh.getElement(). |
MappingMode | Enumeración que controla a qué primitiva se asigna un valor de elemento de vértice: CONTROL_POINT, POLYGON_VERTEX, o POLYGON. |
ReferenceMode | Enumeración que controla cómo se indexan los valores: DIRECT (un valor por primitiva de mapeo) o INDEX_TO_DIRECT (matriz de valores más una matriz de índices separada). |
Transformación y espacial
| Enumerations | Enumerations |
|---|
Transform | Transformación local adjunta a un Node. Proporciona traslación, rotación (como Quaternion), y componentes de escala, además de métodos convenientes para ángulos de Euler. |
GlobalTransform | Vista de solo lectura de la transformación en espacio mundial de un nodo después de componer todas las transformaciones de los ancestros. Accedido a través de node.getGlobalTransform(). |
AssetInfo | Bloque de metadatos adjunto a un Scene. Almacena el nombre de la aplicación de autoría, el nombre de la unidad, el factor de escala de la unidad, las definiciones de ejes del sistema de coordenadas y las marcas de tiempo de creación/modificación. |
Materiales y sombreado
| Enumerations | Enumerations |
|---|
Material | Clase base abstracta para todos los tipos de material. Proporciona un nombre y una colección de propiedades para parámetros numéricos y de color. |
PbrMaterial | Material de Renderizado Basado en Física. Almacena albedo, factor metálico, factor de rugosidad, color emisivo, transparencia y texturas asociadas. Utilizado por glTF 2.0 y otros formatos compatibles con PBR. Importar: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Entidad de cámara. Hereda de Entity. No se exponen propiedades específicas de formato en la edición FOSS de Java más allá del nombre heredado y la colección de propiedades. Adjunta a un Node para definir transformaciones de punto de vista. |
Nota: Enumerations Light class no está disponible en la edición Java de Aspose.3D FOSS. Los datos de iluminación de la escena de los archivos importados se almacenan como genéricos Entity objetos.
Utilidades matemáticas
| Enumerations | Enumerations |
|---|
Vector2 | Vector de doble precisión de 2 componentes (x, y). Usado para coordenadas de textura UV. |
Vector3 | Vector de doble precisión de 3 componentes (x, y, z). Usado para posiciones, direcciones y escala. |
Vector4 | Vector de doble precisión de 4 componentes (x, y, z, w). Usado para puntos de control (posiciones homogéneas) y datos de normales. |
FVector3 | Vector de punto flotante de precisión simple de 3 componentes. Aparece en los arreglos de datos de elementos de vértice para normales y tangentes. |
FVector4 | Vector de punto flotante de precisión simple de 4 componentes. El tipo de almacenamiento de VertexElementFVector datos. |
Quaternion | Cuaternión unitario para representar rotaciones (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 | Caja delimitadora alineada a los ejes definida por getMinimum() y getMaximum() Vector3 esquinas. Utilizado para consultas espaciales y asistentes de recorte de frustum. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Contenedor con nombre para un rango de animación. Un Scene puede contener varios clips (p.ej., “Walk”, “Run”). Boceto de declaración — los datos de fotogramas clave y la reproducción aún no están implementados. |
Entrada/Salida de formatos
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Método estático. Abre el archivo en path, detecta el formato a partir de la extensión y devuelve un Scene. Lanza una excepción si el archivo no se encuentra o el formato no es compatible. |
Scene.open(path, options) | Método de instancia. Abre un archivo en una existente Scene instancia, opcionalmente usando un específico del formato LoadOptions subclase. |
Scene.save(path, options) | Método de instancia. Serializa la escena a path usando el formato inferido de la extensión, opcionalmente usando un específico del formato SaveOptions subclase. |
FileFormat | Registro de formatos de archivo compatibles. Contiene entradas como FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Abstracción interna de E/S utilizada por importadores y exportadores de formatos. No suele ser utilizada directamente por el código de la aplicación. |
LoadOptions | Clase base para todos los objetos de opciones de carga específicos de formato. Subclase de ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Clase base para todos los objetos de opciones de guardado específicos de formato. Subclase de ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Formato OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Clase importadora interna que analiza archivos Wavefront OBJ y MTL. Invocada automáticamente por Scene.fromFile() para .obj extensiones. |
ObjLoadOptions | Opciones de carga para archivos Wavefront OBJ. Propiedades clave: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Opciones de guardado para la salida Wavefront OBJ. Controla normales, UVs, referencias de materiales y modo de nube de puntos. |
ObjFormat | Descriptor de formato para Wavefront OBJ. Accesible como FileFormat.WAVEFRONT_OBJ(). |
Formato STL
| Enumerations | Enumerations |
|---|
StlImporter | Importador interno que lee archivos STL tanto binarios como ASCII. Seleccionado automáticamente por extensión. |
StlExporter | Exportador interno que escribe STL. |
StlLoadOptions | Opciones de carga para archivos STL. Soporta setFlipCoordinateSystem(), setRecalculateNormal(), y setContentType(). |
StlSaveOptions | Opciones de guardado para la salida STL. Controla setFlipCoordinateSystem(), setAxisSystem(), y setContentType(). |
StlFormat | Descriptor de formato para STL. |
Formato glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Opciones de carga para archivos glTF 2.0 y GLB. Propiedades clave: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Opciones de guardado para la salida glTF 2.0 y GLB. Utilice setContentType(FileContentType.BINARY) para producir un autocontenido .glb paquete. |
GltfFormat | Descriptor de formato para glTF 2.0 / GLB. Accesible como FileFormat.GLTF2(). |
Formato FBX
FBX es compatible para solo importación. La exportación a FBX no está disponible en la edición FOSS de Java.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Opciones de carga para archivos FBX. Propiedad clave: setFlipCoordinateSystem(). |
FbxFormat | Descriptor de formato para FBX. Accesible como FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identifica un eje de coordenadas: X_AXIS, Y_AXIS, Z_AXIS. Utilizado en opciones de remapeo del sistema de coordenadas. |
CoordinateSystem | Especifica la convención de mano: RIGHT_HANDED o LEFT_HANDED. |
TextureMapping | Identifica cómo se asigna una textura a la geometría: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, etc. |
BooleanOperation | Tipo de operación booleana CSG: UNION, DIFFERENCE, INTERSECTION. |
Sistema de Propiedades
| Enumerations | Enumerations |
|---|
Property | Una única propiedad tipada y nombrada en un A3DObject. Almacena el nombre de la propiedad, el descriptor de tipo y el valor actual. |
PropertyCollection | Colección iterable de Property objetos adjuntos a un A3DObject. Soporta búsqueda por nombre e iteración sobre todas las propiedades definidas. |
CustomObject | Una ligera A3DObject subclase que solo lleva un nombre y un arbitrario PropertyCollection. Utilizada para almacenar metadatos definidos por el usuario en objetos de escena. |
Imagen y Renderizado
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Opciones para la rasterización por software al renderizar una escena a un búfer de imagen. Almacena el color de fondo, las dimensiones de la imagen y la referencia de la cámara. Esta característica está disponible en configuraciones compatibles. |
Ver también
