Aspose.3D FOSS for Java

Referència API per a: aspose-3d-foss 26.1.0 (Java 21+, llicència MIT).

Totes les classes resideixen en el centre de la Universitat. com.aspose.threed El paquet raí és:

import com.aspose.threed.*;

Layout del paquet: Gairebé totes les classes públiques estan en com.aspose.threed.L’únic subpaquet que s’utilitza habitualment és el de la “Porta” (plataforma). com.aspose.threed.shading (per a PbrMaterial) El com.aspose.threed.formats El subpaquet conté importadors/exportadors interns i normalment no s’importa directament.

Convenció de nomenclatura Java: Totes les propietats utilitzen mètodes de getter/setter. Per exemple, utilitzar node.getTransform() en lloc de: node.transform, i transform.setTranslation(...) en lloc de: transform.translation = ....Nota que: Vector3, Vector4, Quaternion, Matrix4, i FVector tipus d’ús camps públics (v.x, v.y, v.z) en comptes de getters per a l’accés als components.

Grau de la escena principal

Classe	Descripció
`Scene`	Contenidor de primer nivell per a totes les dades de la escena 3D. Conté el node raí, metadades d’actius i clips d ‘animació. Exponen `fromFile()`, `open()`, i `save()` com a punts d’entrada i sortida primaris.
`Node`	Un nod nomenat en la jerarquia de l’escena. Poseix una llista de nodes fills i una lista d’apostos `Entity` Els objectes com ara màxines, càmeres i llums. `Transform`.
`Entity`	Clase de base abstracta per a tots els objectes que es poden fixar a un `Node`.Proporciona nom i identitat però no té geometria pròpia.
`SceneObject`	Classe base compartida per: `Node` i de la `Entity`.Proporciona la interfície de recopilació de propietats utilitzada per a metadades definides per l’usuari.
`A3DObject`	Classe base de raí per a tots els objectes gestionats en Aspose.3D. Exposen la propietat nom i el nombre d’objectes que han estat administrats. `Properties` col·lecció.
`INamedObject`	Interfície que garanteix una `getName()` Metodologia. Implementada per: `Node`, `Entity`, i diversos tipus de descriptors específics per a formats.

Geometria i malla

Classe	Descripció
`Mesh`	Entitat de malla poligonal. Almacena punts de control (posicions del vèrtex com a `Vector4`), llistes de cares dels polígons (listes d’índex del punt de control) i capes d"elements verticals (normales, UVs, colors de vèrtex).
`Geometry`	Base abstracta per a tipus de geometria similar a les mescles. Defineix l’array de punts de control i la col·lecció d’arxius de punt de comanda, amb un valor total de 10 × 100 mm. `VertexElement` capes. `Mesh` hereta de `Geometry`.
`VertexElement`	Base abstracta per a una capa de dades adjunta a la geometria (normales, UVs, colors, etc.). `getMappingMode()`, `getReferenceMode()`, i una llista de dades.
`VertexElementNormal`	Emmagatzemen un vector normal per vèrtex o per cantó de polígon, depenent del mode d’imatge. Els valors de dades són: `Vector4` instàncies amb `w` no utilitzat.
`VertexElementUV`	Emmagatzemar parells de coordenades de textura (`Vector2`Una malla pot portar múltiples capes UV per a diferents canals de textura.
`VertexElementVertexColor`	Amortiza dades de color per vèrtex o per cantó RGBA com: `Vector4` (r, g, b, a en el rang 0-1.).
`VertexElementType`	Enumeració que identifica el paper semàntic d’una capa de elements del vèrtex: `NORMAL`, `UV`, `VERTEX_COLOR`, i altres. Passar valors a `Mesh.getElement()`.
`MappingMode`	Enumeració que controla quin primitivo un valor de vertex d’element correspon a: `CONTROL_POINT`, `POLYGON_VERTEX`, o `POLYGON`.
`ReferenceMode`	Enumeració que controla com s’indexen els valors: `DIRECT` (un valor per primitiva de mapeig) o `INDEX_TO_DIRECT` (array de valors més un array d’índex separats).

Transformació i espacial.

Classe	Descripció
`Transform`	Transformació local adjunta a una empresa de transformació. `Node`.• Translació, rotació (com a `Quaternion`), i components d’escala, més mètodes de conveniència per als angles d"Euler.
`GlobalTransform`	Vista de lectura única de la transformació d’un nod en l’espai mundial després de compondre totes les transformacions ancestrals. Accés a través del canal Web: http://www.crowd-review.com/index.php?id=3146184 `node.getGlobalTransform()`.
`AssetInfo`	Bloc de metadades adjunt a un bloc d’informació. `Scene`.Emmagatzemen el nom de l’aplicació autor, el nombre d’unitat, factor d ’escala unitària, definicions dels eixos del sistema de coordenades i timestamps de creació/modificació.

Materials i ombres

Classe	Descripció
`Material`	Classe de base abstracta per a tots els tipus de materials. Proporciona un nom i una col·lecció de propietats per als paràmetres numèrics i color.
`PbrMaterial`	Material de renderizació basat en física. Almacena albedo, factor metàl·lic, factors d’arrogància, color emissiu, transparència i textures associades. Utilitzat per glTF 2.0 i altres formats compatibles amb PBR. Importació: `com.aspose.threed.shading.PbrMaterial`.

càmera de fotografies

Classe	Descripció
`Camera`	Entitat amb càmera. `Entity`.No s’exposen propietats específiques de format en l’edició Java FOSS més enllà del nom i la col·lecció de propietat heretat. Atxada a un `Node` per definir la transformació de punt de vista.

Nota: El Light classe no està disponible en l’edició Java d’Aspose.3D FOSS. Les dades de llums de escena dels arxius importats s’emmagatzemen com a genèric Entity objectes.

Utilitats de matemàtiques

Classe	Descripció
`Vector2`	Vector de doble precisió amb dos components (`x`, `y`) Utilitzat per a les coordenades de textura UV.
`Vector3`	Vector de doble precisió amb 3 components (`x`, `y`, `z`). Utilitzat per a posicions, direccions i escala.
`Vector4`	Vector de doble precisió amb 4 components (`x`, `y`, `z`, `w`) Utilitzat per als punts de control (posicions homogènies) i dades normals.
`FVector3`	Vector flotador de tres components d’una precisió única. Apareix en matrius de dades dels elements del vèrtex per a normals i tangents.
`FVector4`	Vector flotador de 4 components d’una sola precisió. `VertexElementFVector` dades.
`Quaternion`	Unitat de quaterni per a la representació de rotacions (`w`, `x`, `y`, `z`) Utilitzats per: `Transform.getRotation()`.
`Matrix4`	4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Casella delimitació alineada a l’eix definida per: `getMinimum()` i de la `getMaximum()` El dia de la mort.`Vector3` Utilitzats per a consultes espacials i ajudants de frustum.

Animació

Classe	Descripció
`AnimationClip`	Contenidor anomenat per a una gamma d’animació. A `Scene` pot contenir múltiples pinces (per exemple, “Caminar”, “Correr”). Estoc de la declaració les dades de quadres clau i la reproducció encara no s’han implementat.

Format d’entrada i sortida

Símbol	Descripció
`Scene.fromFile(path)`	Metode estàtic. Obre el fitxer en `path`, detecta el format de l’extensió, i torna un omplert `Scene`. Arriba en format de fitxer no trobat o sense suport.
`Scene.open(path, options)`	Metode d’instància. Obre un fitxer en una instància existent `Scene` instància, opcionalment utilitzant un format específic de la pàgina web. `LoadOptions` subclasse.
`Scene.save(path, options)`	Mètode d’instància. Serialitza la escena a `path` utilitzant el format inferit de l’extensió, opcionalment usant un format específic. `SaveOptions` subclasse.
`FileFormat`	Registre de formats de fitxer suportats. Conté entrades com ara: `FileFormat.WAVEFRONTOBJ`, `FileFormat.GLTF2`, `FileFormat.FBX7400ASCII`.
`IOService`	Abstracció interna d’E/S utilitzada pels importadors i exportadors de format. Normalment no s’utilitza directament pel codi de l’aplicació.
`LoadOptions`	Classe base per a tots els objectes d’opció de càrrega específics del format. Subclassificada pel `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`.
`SaveOptions`	Clasa base per a tots els objectes d’opció de guarda específics del format. Subclassificada per `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`.

Format OBJ

Classe	Descripció
`ObjImporter`	Clase d’importador intern que analisa els arxius Wavefront OBJ i MTL. Invocat automàticament per `Scene.fromFile()` per a: `.obj` extensions.
`ObjLoadOptions`	Opcions de càrrega per als arxius Wavefront OBJ. Propietats clau: `setFlipCoordinateSystem()`, `setScale()`, `setEnableMaterials()`, `setNormalizeNormal()`.
`ObjSaveOptions`	Salva opcions per a la sortida de Wavefront OBJ. Controla normales, UVs, referències de materials i mode núvol puntal.
`ObjFormat`	Descriptor de format per a Wavefront OBJ. Accessible com `FileFormat.WAVEFRONTOBJ`.

Format STL

Classe	Descripció
`StlImporter`	Importador intern que llegeix tant arxius STL binaris com ASCII. Seleccionat automàticament per extensió.
`StlExporter`	Exportador intern que escriu STL.
`StlLoadOptions`	Opcions de càrrega per a arxius STL. Suport `setFlipCoordinateSystem()`, `setRecalculateNormal()`, i `setContentType()`.
`StlSaveOptions`	Salvar opcions per a la sortida STL. Controles `setFlipCoordinateSystem()`, `setAxisSystem()`, i `setContentType()`.
`StlFormat`	Descriptor de format per a STL.

Format glTF

Classe	Descripció
`GltfLoadOptions`	Opcions de càrrega per a fitxers glTF 2.0 i GLB. Propietats clau: `setFlipCoordinateSystem()`, `setPrettyPrint()`.
`GltfSaveOptions`	Salvar opcions per a glTF 2.0 i GLB. Utilitzar `setContentType(FileContentType.BINARY)` per produir un autocontenit `.glb` paquet.
`GltfFormat`	Descriptor de format per a glTF 2.0 / GLB. Accessible com: `FileFormat.GLTF2`.

Format FBX

FBX està compatible amb: Només importació..L’exportació a FBX no està disponible en l’edició Java FOSS.

Classe	Descripció
`FbxLoadOptions`	Opcions de càrrega per a arxius FBX.: `setFlipCoordinateSystem()`.
`FbxFormat`	Descriptor de format per FBX. Accessible com a `FileFormat.FBX7400ASCII`.

Enumeracions

Enumeració	Descripció
`Axis`	Identifica un eix de coordenades: `X_AXIS`, `Y_AXIS`, `Z_AXIS`.Utilitzat en opcions de remapatge del sistema de coordenades.
`CoordinateSystem`	Especifica la convenció de man: `RIGHT_HANDED` o de la seva `LEFT_HANDED`.
`TextureMapping`	Identifica com es mapà una textura a la geometria: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, etc.
`BooleanOperation`	CSG Tipus d’operació booleana: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistema de propietats

Classe	Descripció
`Property`	Una propietat típica amb un sol nom en una `A3DObject`.Emmagatzemar el nom de la propietat, descriptor del tipus i valor actual.
`PropertyCollection`	Recopilació iterable de `Property` objectes adjuntats a un `A3DObject`.Suporta la recerca per nom i iteració sobre totes les propietats definides.
`CustomObject`	Un lleuger. `A3DObject` Subclasse que només porta un nom i una arbitrària `PropertyCollection`.Utilitzat per emmagatzemar metadades definides per l’usuari sobre objectes de escena.

Imatge i renderi

Classe	Descripció
`ImageRenderOptions`	Opcions per a la rasterització de programari quan es retrata una escena en un buffer d’imatge. Almacena el color del fons, les dimensions de l’image i la referència de la càmera. Nota: Tots els mètodes de renderizació lancen `UnsupportedOperationException` en l’edició FOSS; no hi ha cap renderi disponible.