Aspose.3D FOSS for Java

API-referencia a aspose-3d-foss 26.1.0 (Java 21+, MIT license).

Minden osztály a com.aspose.threed gyökércsomagban. A gyökérimport:

import com.aspose.threed.*;

Csomag felépítése: Majdnem minden nyilvános osztály a com.aspose.threed. Az egyetlen alcsomag, amelyet általában használnak, a com.aspose.threed.shading (a PbrMaterial). A com.aspose.threed.formats sub-package belső importálókat/exportálókat tartalmaz, és általában nem importálják közvetlenül.

Java elnevezési konvenció: Minden tulajdonság getter/setter metódusokat használ. Például használja node.getTransform() helyett node.transform, és transform.setTranslation(...) helyett transform.translation = .... Vegye figyelembe, hogy Vector3, Vector4, Quaternion, Matrix4, és FVector típusok használják publikus mezőket (v.x, v.y, v.z) a komponens eléréséhez a getterek helyett.

Alap Jelenetgrafikon

EnumerationsEnumerations
SceneA felső szintű tároló az összes 3D jelenet adat számára. Tartalmazza a gyökércsomópontot, az eszköz metaadatait és az animációs klipeket. Elérhetővé teszi fromFile(), open(), és save() mint az elsődleges I/O belépési pontok.
NodeEgy elnevezett csomópont a jelenet hierarchiájában. Tartalmaz egy listát a gyermekcsomópontokról és egy listát a csatolt Entity objektumokról, például hálók, kamerák és fények. Hordoz egy helyi Transform.
EntityAbsztrakt alaposztály minden olyan objektum számára, amely csatolható egy Node. Biztosítja a nevet és az azonosítót, de saját geometriát nem tartalmaz.
SceneObjectAlaposztály, amelyet megoszt Node és Entity. Biztosítja a tulajdonsággyűjtemény interfészt, amelyet a felhasználó által definiált metaadatokhoz használnak.
A3DObjectGyökér alaposztály minden Aspose.3D által kezelt objektum számára. Elérhetővé teszi a név tulajdonságot és a Properties gyűjteményt.
INamedObjectInterfész, amely garantál egy getName() metódust. Implementálja Node, Entity, és több formátum-specifikus leíró típust.

Geometria és háló

EnumerationsEnumerations
MeshPoligon háló entitás. Tárolja a vezérlőpontokat (csúcspozíciókat mint Vector4), poligon felületlistákat (vezérlőpont-indexek listái), és csúcs elem rétegeket (normálok, UV-k, csúcs színek).
GeometryAbsztrakt alap a háló-szerű geometriai típusokhoz. Meghatározza a vezérlőpont tömböt és a gyűjteményt a VertexElement rétegeket. Mesh örökli a Geometry.
VertexElementAbsztrakt alap egy adatréteghez, amely a geometriához (normals, UVs, colours, stb.) van csatolva. Tartalmazza getMappingMode(), getReferenceMode(), és egy adatlistát.
VertexElementNormalTárol egy normálvektort csúcsonként vagy sokszög-sarokként, a leképezési módtól függően. Az adatértékek Vector4 példányok a w nem használt.
VertexElementUVTárolja a textúra-koordináta párokat (Vector2) csúcsonként vagy sokszög-sarokként. Egy háló több UV réteget is tartalmazhat különböző textúra csatornákhoz.
VertexElementVertexColorTárolja csúcsonként vagy sarokként az RGBA színadatokat mint Vector4 (r, g, b, a a 0–1 tartományban).
VertexElementTypeFelsorolás, amely azonosítja a csúcs elem réteg szemantikai szerepét: NORMAL, UV, VERTEX_COLOR, és egyebek. Értékeket ad át a Mesh.getElement().
MappingModeFelsorolás, amely szabályozza, hogy mely primitívhez térképezi a csúcs elem értékét: CONTROL_POINT, POLYGON_VERTEX, vagy POLYGON.
ReferenceModeFelsorolás, amely szabályozza, hogyan indexelik az értékeket: DIRECT (egy érték leképezési primitívként) vagy INDEX_TO_DIRECT (értékek tömbje plusz egy különálló index tömb).

Transzformáció és térbeli

EnumerationsEnumerations
TransformHelyi transzformáció csatolva egy Node. Biztosít eltolást, forgást (mint Quaternion), és méretezési komponensek, plusz kényelmi metódusok Euler-szögekhez.
GlobalTransformCsak olvasható nézet egy csomópont világkoordináta-transzformációjáról, miután az összes ős transzformációt összeállították. Elérhető a következőn keresztül node.getGlobalTransform().
AssetInfoMetaadatblokk csatolva egy Scene. Tárolja a szerzői alkalmazás nevét, az egység nevét, az egység skálafaktorát, a koordináta‑rendszer tengelydefiníciókat, valamint a létrehozási/módosítási időbélyegeket.

Anyagok és árnyalás

EnumerationsEnumerations
MaterialAbsztrakt alaposztály minden anyagtípushoz. Nevet és egy tulajdonsággyűjteményt biztosít numerikus és színparaméterekhez.
PbrMaterialFizikailag alapú renderelés (PBR) anyag. Tárolja az albedót, a fémességi tényezőt, a durvasági tényezőt, az emisszív színt, az átlátszóságot és a kapcsolódó textúrákat. A glTF 2.0 és más PBR‑képes formátumok használják. Importálás: com.aspose.threed.shading.PbrMaterial.

Enumerations

EnumerationsEnumerations
CameraKamera entitás. Örökli a Entity. A Java FOSS kiadásban nincsenek formátum‑specifikus tulajdonságok, csak az örökölt név és a tulajdonsággyűjtemény. Csatolva egy Node a nézőpont transzformációk meghatározásához.

Megjegyzés: Enumerations Light osztály nem érhető el a Java kiadásban a Aspose.3D FOSS-ban. A importált fájlokból származó jelenetvilágítási adatok általános Entity objektumok.

Matematikai segédeszközök

EnumerationsEnumerations
Vector2Dupla pontosságú 2 komponensű vektor (x, y). UV textúra koordinátákhoz használják.
Vector3Dupla pontosságú 3 komponensű vektor (x, y, z). Pozíciókhoz, irányokhoz és méretezéshez használják.
Vector4Dupla pontosságú 4 komponensű vektor (x, y, z, w). Használják vezérlőpontok (homogén pozíciók) és normál adatok esetén.
FVector3Egyszeres pontosságú, 3 komponensű lebegőpontos vektor. Megjelenik a csúcselem adat tömbökben a normálok és a tangensek számára.
FVector4Egyszeres pontosságú, 4 komponensű lebegőpontos vektor. A tárolási típusa a VertexElementFVector adat.
QuaternionEgységkvaternion a forgatások ábrázolásához (w, x, y, z). Használja Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxTengelyekhez igazított határoló doboz, amelyet definiál getMinimum() és getMaximum() Vector3 sarkok. Térbeli lekérdezésekhez és frustum culling segédeszközökhöz használják.

Enumerations

EnumerationsEnumerations
AnimationClipElnevezett tároló egy animációs tartományhoz. Egy Scene több klipet is tartalmazhat (pl. "Walk", "Run"). Deklarációs váz — a kulcskocka adatok és a lejátszás még nincs megvalósítva.

Formátum I/O

EnumerationsEnumerations
Scene.fromFile(path)Statikus metódus. Megnyitja a fájlt a path, felismeri a formátumot a kiterjesztés alapján, és visszaad egy feltöltött Scene. Kivételt dob, ha a fájl nem található vagy a formátum nem támogatott.
Scene.open(path, options)Példány metódus. Megnyit egy fájlt egy meglévő Scene példányba, opcionálisan egy formátum-specifikus LoadOptions subclass.
Scene.save(path, options)Példány metódus. Serializálja a jelenetet a path a kiterjesztésből következtetett formátum használatával, opcionálisan egy formátum-specifikus SaveOptions subclass.
FileFormatA támogatott fájlformátumok nyilvántartása. Olyan bejegyzéseket tartalmaz, mint FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceBelső I/O absztrakció, amelyet a formátum importálók és exportálók használnak. Általában nem használják közvetlenül az alkalmazáskód.
LoadOptionsAlaposztály minden formátum-specifikus betöltési opció objektumhoz. Származtatva a ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsAlaposztály minden formátum-specifikus mentési opció objektumhoz. Származtatva a ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ formátum

EnumerationsEnumerations
ObjImporterBelső importáló osztály, amely a Wavefront OBJ és MTL fájlokat dolgozza fel. Automatikusan meghívja a Scene.fromFile() a .obj kiterjesztéseket.
ObjLoadOptionsBetöltési opciók a Wavefront OBJ fájlokhoz. Kulcsfontosságú tulajdonságok: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsMentési opciók a Wavefront OBJ kimenethez. Szabályozza a normálvektorokat, UV-ket, anyagreferenciákat és a pontfelhő módot.
ObjFormatFormátumleíró a Wavefront OBJ-hez. Elérhető mint FileFormat.WAVEFRONT_OBJ().

STL formátum

EnumerationsEnumerations
StlImporterBelső importáló, amely mind bináris, mind ASCII STL fájlokat olvas. Automatikusan kiválasztja a kiterjesztés alapján.
StlExporterBelső exportáló, amely STL-t ír.
StlLoadOptionsBetöltési opciók az STL fájlokhoz. Támogatja a setFlipCoordinateSystem(), setRecalculateNormal(), és setContentType().
StlSaveOptionsMentési opciók az STL kimenethez. Szabályozza a setFlipCoordinateSystem(), setAxisSystem(), és setContentType().
StlFormatFormátumleíró az STL-hez.

glTF formátum

EnumerationsEnumerations
GltfLoadOptionsBetöltési beállítások a glTF 2.0 és GLB fájlokhoz. Kulcsfontosságú tulajdonságok: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsMentési beállítások a glTF 2.0 és GLB kimenethez. Használja setContentType(FileContentType.BINARY) egy önálló .glb csomag.
GltfFormatFormátumleíró a glTF 2.0 / GLB-hez. Elérhető mint FileFormat.GLTF2().

FBX formátum

Az FBX támogatott a csak importáláshoz. Az FBX exportálása nem érhető el a Java FOSS kiadásban.

EnumerationsEnumerations
FbxLoadOptionsBetöltési beállítások FBX fájlokhoz. Kulcsfontosságú tulajdonság: setFlipCoordinateSystem().
FbxFormatFormátumleíró az FBX-hez. Elérhető mint FileFormat.FBX7400ASCII().

Enumerations

EnumerationsEnumerations
AxisAzonosít egy koordináta tengelyt: X_AXIS, Y_AXIS, Z_AXIS. Koordináta-rendszer átképzési beállításokban használatos.
CoordinateSystemMegadja a jobb-/balkezes konvenciót: RIGHT_HANDED vagy LEFT_HANDED.
TextureMappingAzonosítja, hogyan van a textúra leképezve a geometriára: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, stb.
BooleanOperationCSG logikai művelet típusa: UNION, DIFFERENCE, INTERSECTION.

Tulajdonságok rendszere

EnumerationsEnumerations
PropertyEgyetlen névvel ellátott típusú tulajdonság egy A3DObject. Tárolja a tulajdonság nevét, típusleíróját és a jelenlegi értékét.
PropertyCollectionIterálható gyűjtemény a Property objektumok csatolva egy A3DObject. Támogatja a név szerinti keresést és az összes definiált tulajdonságon való iterációt.
CustomObjectEgy könnyű A3DObject származtatott osztály, amely csak egy nevet és egy tetszőleges PropertyCollection. Felhasználó által definiált metaadatok tárolására szolgál a jelenet objektumain.

Kép és renderelés

EnumerationsEnumerations
ImageRenderOptionsOpciók a szoftveres rasterizációhoz, amikor egy jelenetet képpufferbe renderelünk. Tárolja a háttérszínt, a kép méreteit és a kamera referenciát. Ez a funkció elérhető a támogatott konfigurációkban.

Lásd még

 Magyar