Aspose.3D FOSS for Java

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

Sve klase se nalaze u com.aspose.threed korijenskom paketu. Korijenski uvoz je:

import com.aspose.threed.*;

Raspored paketa: Gotovo sve javne klase su u com.aspose.threed. Jedini pod-paket koji se obično koristi je com.aspose.threed.shading (za PbrMaterial). Ta com.aspose.threed.formats pod-paket sadrži interne uvoznike/izvoznike i obično se ne uvozi izravno.

Java konvencija imenovanja: Sva svojstva koriste getter/setter metode. Na primjer, koristite node.getTransform() umjesto node.transform, i transform.setTranslation(...) umjesto transform.translation = .... Napomena da Vector3, Vector4, Quaternion, Matrix4, i FVector vrste koriste javna polja (v.x, v.y, v.z) umjesto gettera za pristup komponenti.

Osnovni graf scene

EnumerationsEnumerations
SceneKontejner najviše razine za sve 3D podatke scene. Sadrži korijenski čvor, metapodatke sredstava i animacijske isječke. Izlaže fromFile(), open(), i save() kao primarne ulazno/izlazne točke.
NodeImenovani čvor u hijerarhiji scene. Posjeduje popis podčvorova i popis priloženih Entity objekata poput mreža, kamera i svjetala. Nositi lokalni Transform.
EntityApstraktna bazna klasa za sve objekte koji se mogu priložiti na Node. Pruža ime i identitet, ali nema vlastitu geometriju.
SceneObjectBazna klasa koju dijele Node i Entity. Pruža sučelje za kolekciju svojstava koje se koristi za metapodatke definirane od strane korisnika.
A3DObjectKorijenska bazna klasa za sve Aspose.3D upravljane objekte. Izlaže svojstvo ime i Properties kolekciju.
INamedObjectSučelje koje jamči getName() metodu. Implementiraju Node, Entity, i nekoliko tipova opisnika specifičnih za format.

Geometrija i mreža

EnumerationsEnumerations
MeshEntitet poligonalne mreže. Pohranjuje kontrolne točke (pozicije vrhova kao Vector4), popise poligonalnih lica (popisi indeksa kontrolnih točaka), i slojeve elemenata vrhova (normale, UV-ove, boje vrhova).
GeometryApstraktna baza za vrste geometrije nalik mreži. Definira niz kontrolnih točaka i zbirku VertexElement slojeva. Mesh nasljeđuje od Geometry.
VertexElementApstraktna baza za sloj podataka pričvršćen uz geometriju (normale, UV-ove, boje, itd.). Prenosi getMappingMode(), getReferenceMode(), i popis podataka.
VertexElementNormalPohranjuje jedan vektor normale po vrhu ili po kutu poligona, ovisno o načinu mapiranja. Vrijednosti podataka su Vector4 instance s w neiskorišteno.
VertexElementUVPohranjuje parove teksturnih koordinata (Vector2) po vrhu ili po kutu poligona. Mreža može nositi više UV slojeva za različite teksturne kanale.
VertexElementVertexColorPohranjuje RGBA podatke boje po vrhu ili po kutu kao Vector4 (r, g, b, a u rasponu 0–1).
VertexElementTypeEnumeracija koja identificira semantičku ulogu sloja elementa vrha: NORMAL, UV, VERTEX_COLOR, i druge. Proslijedite vrijednosti u Mesh.getElement().
MappingModeEnumeracija koja kontrolira kojem primitivnom elementu vrha vrijednost pripada: CONTROL_POINT, POLYGON_VERTEX, ili POLYGON.
ReferenceModeEnumeracija koja kontrolira kako su vrijednosti indeksirane: DIRECT (jedna vrijednost po primitivnom mapiranju) ili INDEX_TO_DIRECT (niz vrijednosti plus zaseban niz indeksa).

Transformacija i prostorni

EnumerationsEnumerations
TransformLokalna transformacija pridružena nekom Node. Pruža translaciju, rotaciju (kao Quaternion), i komponente skaliranja, plus metode za Eulerove kutove.
GlobalTransformSamo‑za‑čitanje prikaz transformacije čvora u svjetskom prostoru nakon sastavljanja svih transformacija pretka. Pristupa se putem node.getGlobalTransform().
AssetInfoBlok metapodataka priložen Scene. Pohranjuje naziv aplikacije za izradu, naziv jedinice, faktor skaliranja jedinice, definicije osi koordinatnog sustava i vremenske oznake stvaranja/izmjene.

Materijali i sjenčanje

EnumerationsEnumerations
MaterialApstraktna bazna klasa za sve vrste materijala. Omogućuje naziv i kolekciju svojstava za numeričke i parametre boje.
PbrMaterialMaterijal temeljene na fizički zasnovanom renderiranju (Physically Based Rendering). Pohranjuje albedo, metalni faktor, faktor hrapavosti, emisijsku boju, prozirnost i povezane teksture. Koristi se u glTF 2.0 i drugim formatima koji podržavaju PBR. Uvoz: com.aspose.threed.shading.PbrMaterial.

Enumerations

EnumerationsEnumerations
CameraEntitet kamere. Nasljeđuje od Entity. Nema izloženih svojstava specifičnih za format u Java FOSS izdanju osim naslijeđenog naziva i kolekcije svojstava. Priložen je Node za definiranje transformacija pogleda.

Napomena: Enumerations Light klasa nije dostupna u Java izdanju Aspose.3D FOSS. Podaci o osvjetljenju scene iz uvezenih datoteka pohranjuju se kao generički Entity objekti.

Matematički alati

EnumerationsEnumerations
Vector2Dvostruko precizni vektor s 2 komponente (x, y). Koristi se za UV koordinate teksture.
Vector3Dvostruko precizni vektor s 3 komponente (x, y, z). Koristi se za položaje, smjerove i skaliranje.
Vector4Dvostruko precizni vektor s 4 komponente (x, y, z, w). Koristi se za kontrolne točke (homogena položaja) i normalne podatke.
FVector3Float vektor s 3 komponente u jednostrukoj preciznosti. Pojavljuje se u nizovima podataka vršnih elemenata za normale i tangente.
FVector4Float vektor s 4 komponente u jednostrukoj preciznosti. Tip pohrane za VertexElementFVector podatke.
QuaternionJedinični kvaternion za predstavljanje rotacija (w, x, y, z). Koristi se u Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxOkvir ograničenja usklađen s osima definiran od getMinimum() i getMaximum() Vector3 kutova. Koristi se za prostorne upite i pomoćne alate za culling frustuma.

Enumerations

EnumerationsEnumerations
AnimationClipImenovani kontejner za raspon animacije. A Scene može sadržavati više isječaka (npr., “Walk”, “Run”). Deklaracijski stub — podaci ključnih okvira i reprodukcija još nisu implementirani.

U/I formata

EnumerationsEnumerations
Scene.fromFile(path)Statička metoda. Otvara datoteku na path, otkriva format iz ekstenzije i vraća popunjen Scene. Baca iznimku ako datoteka nije pronađena ili format nije podržan.
Scene.open(path, options)Instancijska metoda. Otvara datoteku u postojeći Scene primjerak, opcionalno koristeći format-specifični LoadOptions podklasu.
Scene.save(path, options)Instancijska metoda. Serijalizira scenu u path koristeći format izvučen iz ekstenzije, po želji koristeći format‑specifičan SaveOptions podklasu.
FileFormatRegistar podržanih formata datoteka. Sadrži unose poput FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceInterna I/O apstrakcija koju koriste uvoznici i izvoznici formata. Obično se ne koristi izravno u kodu aplikacije.
LoadOptionsOsnovna klasa za sve objekte opcija učitavanja specifične za format. Podklasa od ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsOsnovna klasa za sve objekte opcija spremanja specifične za format. Podklasa od ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ format

EnumerationsEnumerations
ObjImporterInterna klasa uvoznika koja parsira Wavefront OBJ i MTL datoteke. Automatski se poziva od strane Scene.fromFile() za .obj ekstenzija.
ObjLoadOptionsOpcije učitavanja za Wavefront OBJ datoteke. Ključna svojstva: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsOpcije spremanja za Wavefront OBJ izlaz. Kontrolira normale, UV koordinate, reference materijala i način oblaka točaka.
ObjFormatOpisnik formata za Wavefront OBJ. Dostupan kao FileFormat.WAVEFRONT_OBJ().

STL format

EnumerationsEnumerations
StlImporterInterni uvoznik koji čita i binarne i ASCII STL datoteke. Automatski se odabire prema ekstenziji.
StlExporterInterni izvoznik koji zapisuje STL.
StlLoadOptionsOpcije učitavanja za STL datoteke. Podržava setFlipCoordinateSystem(), setRecalculateNormal(), i setContentType().
StlSaveOptionsOpcije spremanja za STL izlaz. Kontrolira setFlipCoordinateSystem(), setAxisSystem(), i setContentType().
StlFormatOpisnik formata za STL.

glTF format

EnumerationsEnumerations
GltfLoadOptionsUčitaj opcije za glTF 2.0 i GLB datoteke. Ključna svojstva: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsSpremi opcije za glTF 2.0 i GLB izlaz. Koristite setContentType(FileContentType.BINARY) za stvaranje samostalnog .glb paketa.
GltfFormatOpis formata za glTF 2.0 / GLB. Dostupan kao FileFormat.GLTF2().

FBX format

FBX je podržan za samo za uvoz. Izvoz u FBX nije dostupan u Java FOSS izdanju.

EnumerationsEnumerations
FbxLoadOptionsOpcije učitavanja za FBX datoteke. Ključno svojstvo: setFlipCoordinateSystem().
FbxFormatOpis formata za FBX. Dostupan kao FileFormat.FBX7400ASCII().

Enumerations

EnumerationsEnumerations
AxisIdentificira koordinatnu os: X_AXIS, Y_AXIS, Z_AXIS. Koristi se u opcijama premapiranja koordinatnog sustava.
CoordinateSystemOdređuje konvenciju desničarnosti: RIGHT_HANDED ili LEFT_HANDED.
TextureMappingIdentificira kako je tekstura mapirana na geometriju: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, itd.
BooleanOperationTip CSG Boolean operacije: UNION, DIFFERENCE, INTERSECTION.

Sustav svojstava

EnumerationsEnumerations
PropertyJedno imenovano tipizirano svojstvo na A3DObject. Pohranjuje naziv svojstva, opis tipa i trenutnu vrijednost.
PropertyCollectionIterabilna kolekcija od Property objekti priloženi na A3DObject. Podržava pretraživanje po imenu i iteraciju kroz sve definirane svojstva.
CustomObjectLagani A3DObject podklasa koja nosi samo ime i proizvoljno PropertyCollection. Koristi se za pohranu korisnički definiranih metapodataka na objektima scene.

Slika i render

EnumerationsEnumerations
ImageRenderOptionsOpcije za softversku rasterizaciju pri renderiranju scene u slikovni međuspremnik. Pohranjuje boju pozadine, dimenzije slike i referencu kamere. Ova značajka je dostupna u podržanim konfiguracijama.

Vidi također

 Hrvatski