Referència de l’API per a aspose-3d-foss 26.1.0 (Java 21+, llicència MIT).
Totes les classes resideixen al com.aspose.threed paquet arrel. La importació arrel és:
Estructura del paquet: Gairebé totes les classes públiques són a com.aspose.threed. L’únic subpaquet que s’utilitza típicament és com.aspose.threed.shading (per a PbrMaterial). La com.aspose.threed.formats subpaquet conté importadors/exportadors interns i normalment no s’importa directament.
Java convenció de nomenclatura: Totes les propietats utilitzen mètodes getter/setter. Per exemple, utilitzeu node.getTransform() en lloc de node.transform, i transform.setTranslation(...) en lloc de transform.translation = .... Tingueu en compte que Vector3, Vector4, Quaternion, Matrix4, i FVector tipus utilitzen camps públics (v.x, v.y, v.z) en lloc de getters per a l’accés als components.
Graf de l’escena central
| Enumerations | Enumerations |
|---|
Scene | Contenidor de nivell superior per a totes les dades d’escena 3D. Conté el node arrel, les metadades dels actius i els clips d’animació. Exposa fromFile(), open(), i save() com els punts d’entrada principals d’E/S. |
Node | Un node anomenat a la jerarquia de l’escena. Posseeix una llista de nodes fills i una llista d’adjuntats Entity objectes com malles, càmeres i llums. Porta una local Transform. |
Entity | Classe base abstracta per a tots els objectes que es poden adjuntar a un Node. Proporciona nom i identitat però cap geometria pròpia. |
SceneObject | Classe base compartida per Node i Entity. Proporciona la interfície de col·lecció de propietats utilitzada per a metadades definides per l’usuari. |
A3DObject | Classe base arrel per a tots els objectes gestionats Aspose.3D. Exposa la propietat de nom i el Properties col·lecció. |
INamedObject | Interfície que garanteix una getName() mètode. Implementat per Node, Entity, i diversos tipus de descriptor específics del format. |
Geometria i malla
| Enumerations | Enumerations |
|---|
Mesh | Entitat de malla de polígons. Emmagatzema punts de control (posicions de vèrtex com a Vector4), llistes de cares de polígons (llistes d’índexs de punts de control), i capes d’elements de vèrtex (normals, UVs, colors de vèrtex). |
Geometry | Base abstracta per a tipus de geometria semblants a malles. Defineix la matriu de punts de control i la col·lecció de VertexElement capes. Mesh hereta de Geometry. |
VertexElement | Base abstracta per a una capa de dades adjunta a la geometria (normals, UVs, colors, etc.). Porta getMappingMode(), getReferenceMode(), i una llista de dades. |
VertexElementNormal | Emmagatzema un vector normal per vèrtex o per cantonada de polígon, segons el mode de mapatge. Els valors de dades són Vector4 instàncies amb w no utilitzat. |
VertexElementUV | Emmagatzema parelles de coordenades de textura (Vector2) per vèrtex o per cantonada de polígon. Una malla pot portar diverses capes UV per a diferents canals de textura. |
VertexElementVertexColor | Emmagatzema dades de color RGBA per vèrtex o per cantonada com a Vector4 (r, g, b, a en l’interval 0–1). |
VertexElementType | Enumeració que identifica el rol semàntic d’una capa d’element de vèrtex: NORMAL, UV, VERTEX_COLOR, i altres. Passa valors a Mesh.getElement(). |
MappingMode | Enumeració que controla a quina primitiva es mapegen els valors d’element de vèrtex: CONTROL_POINT, POLYGON_VERTEX, o POLYGON. |
ReferenceMode | Enumeració que controla com s’indexen els valors: DIRECT (un valor per primitiva de mapatge) o INDEX_TO_DIRECT (matriu de valors més una matriu d’índexs separada). |
Transformació i espacial
| Enumerations | Enumerations |
|---|
Transform | Transformació local adjunta a una Node. Proporciona translació, rotació (com a Quaternion), i components d’escala, a més de mètodes de conveniència per a angles d’Euler. |
GlobalTransform | Vista de només lectura de la transformació en l’espai mundial d’un node després de composar totes les transformacions dels avantpassats. Accedit a través de node.getGlobalTransform(). |
AssetInfo | Bloc de metadades adjunt a una Scene. Emmagatzema el nom de l’aplicació d’autor, el nom de la unitat, el factor d’escala de la unitat, les definicions d’eixos del sistema de coordenades i les marques de temps de creació/modificació. |
Materials i ombrejat
| Enumerations | Enumerations |
|---|
Material | Classe base abstracta per a tots els tipus de material. Proporciona un nom i una col·lecció de propietats per a paràmetres numèrics i de color. |
PbrMaterial | Material de renderitzat basat en la física. Emmagatzema albedo, factor metàl·lic, factor de rugositat, color emissiu, transparència i textures associades. Utilitzat per glTF 2.0 i altres formats compatibles amb PBR. Importa: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Entitat de càmera. Hereta de Entity. No s’exposen propietats específiques del format a l’edició Java FOSS més enllà del nom i la col·lecció de propietats heretades. Adjunt a un Node per definir transformacions del punt de vista. |
Nota: Enumerations Light la classe no està disponible a l’edició Java de Aspose.3D FOSS. Les dades d’il·luminació de l’escena dels fitxers importats s’emmagatzemen com a genèriques Entity objectes.
Utilitats matemàtiques
| Enumerations | Enumerations |
|---|
Vector2 | Vector de doble precisió de 2 components (x, y). S’utilitza per a coordenades de textura UV. |
Vector3 | Vector de doble precisió de 3 components (x, y, z). S’utilitza per a posicions, direccions i escala. |
Vector4 | Vector de doble precisió de 4 components (x, y, z, w). S’utilitza per a punts de control (posicions homogènies) i dades normals. |
FVector3 | Vector de coma flotant de precisió simple de 3 components. Apareix en les matrius de dades d’elements de vèrtex per a normals i tangents. |
FVector4 | Vector de coma flotant de precisió simple de 4 components. El tipus d’emmagatzematge de VertexElementFVector dades. |
Quaternion | Quaternió unitari per representar rotacions (w, x, y, z). Utilitzat per Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Caixa delimitadora alineada amb els eixos definida per getMinimum() i getMaximum() Vector3 cantonades. Utilitzada per a consultes espacials i ajudes de recortament de frustum. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Contenidor anomenat per a un interval d’animació. Un Scene pot contenir diversos clips (p. ex., “Walk”, “Run”). Esbós de declaració — les dades de fotogrames clau i la reproducció encara no estan implementades. |
Entrada/Sortida de formats
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Mètode estàtic. Obre el fitxer a path, detecta el format a partir de l’extensió i retorna un/a Scene. Llença una excepció si el fitxer no es troba o el format no és compatible. |
Scene.open(path, options) | Mètode d’instància. Obre un fitxer dins d’un/a existent Scene instància, opcionalment utilitzant un/a específic del format LoadOptions subclasse. |
Scene.save(path, options) | Mètode d’instància. Serialitza l’escena a path utilitzant el format deduït de l’extensió, opcionalment utilitzant un/a específic del format SaveOptions subclasse. |
FileFormat | Registre dels formats de fitxer compatibles. Conté entrades com ara FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Abstracció interna d’E/S utilitzada pels importadors i exportadors de formats. Normalment no s’utilitza directament pel codi de l’aplicació. |
LoadOptions | Classe base per a tots els objectes d’opcions de càrrega específiques de format. Subclasse per ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Classe base per a tots els objectes d’opcions de desament específiques de format. Subclasse per ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Format OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Classe d’importador intern que analitza fitxers Wavefront OBJ i MTL. Invocat automàticament per Scene.fromFile() per a .obj extensions. |
ObjLoadOptions | Opcions de càrrega per a fitxers Wavefront OBJ. Propietats clau: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Opcions de desament per a la sortida Wavefront OBJ. Controla les normals, UVs, referències de material i el mode de núvol de punts. |
ObjFormat | Descriptor de format per a Wavefront OBJ. Accessible com a FileFormat.WAVEFRONT_OBJ(). |
Format STL
| Enumerations | Enumerations |
|---|
StlImporter | Importador intern que llegeix fitxers STL tant binaris com ASCII. Seleccionat automàticament per extensió. |
StlExporter | Exportador intern que escriu STL. |
StlLoadOptions | Opcions de càrrega per a fitxers STL. Compatibilitza setFlipCoordinateSystem(), setRecalculateNormal(), i setContentType(). |
StlSaveOptions | Opcions de desament per a la sortida STL. Controla setFlipCoordinateSystem(), setAxisSystem(), i setContentType(). |
StlFormat | Descriptor de format per a STL. |
Format glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Opcions de càrrega per a fitxers glTF 2.0 i GLB. Propietats clau: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Opcions de desament per a la sortida glTF 2.0 i GLB. Utilitzeu setContentType(FileContentType.BINARY) per produir un autocontingut .glb paquet. |
GltfFormat | Descriptor de format per a glTF 2.0 / GLB. Accessible com a FileFormat.GLTF2(). |
Format FBX
FBX és compatible per a només d’importació. L’exportació a FBX no està disponible a l’edició Java FOSS.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Opcions de càrrega per a fitxers FBX. Propietat clau: setFlipCoordinateSystem(). |
FbxFormat | Descriptor de format per a FBX. Accessible com a FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identifica un eix de coordenades: X_AXIS, Y_AXIS, Z_AXIS. Utilitzat en opcions de remapeig del sistema de coordenades. |
CoordinateSystem | Especifica la convenció d’orientació: RIGHT_HANDED o LEFT_HANDED. |
TextureMapping | Identifica com es mapeja una textura a la geometria: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, etc. |
BooleanOperation | Tipus d’operació booleana CSG: UNION, DIFFERENCE, INTERSECTION. |
Sistema de propietats
| Enumerations | Enumerations |
|---|
Property | Una única propietat tipada amb nom en un A3DObject. Emmagatzema el nom de la propietat, el descriptor de tipus i el valor actual. |
PropertyCollection | Col·lecció iterable de Property objectes adjunts a un A3DObject. Admet cerca per nom i iteració sobre totes les propietats definides. |
CustomObject | Una versió lleugera de A3DObject subclasse que només conté un nom i un/a arbitrari/a PropertyCollection. Utilitzada per emmagatzemar metadades definides per l’usuari en objectes d’escena. |
Imatge i renderització
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Opcions per a la rasterització per programari en renderitzar una escena cap a un buffer d’imatge. Emmagatzema el color de fons, les dimensions de la imatge i la referència de la càmera. Aquesta característica està disponible en configuracions compatibles. |
Vegeu també
