Aspose.3D FOSS for Java

API-viite kohteelle aspose-3d-foss 26.1.0 (Java 21+, MIT-lisenssi).

Kaikki luokat sijaitsevat com.aspose.threed juuripaketissa. Juurin tuonti on:

import com.aspose.threed.*;

Pakettirakenne: Lähes kaikki julkiset luokat ovat com.aspose.threed. Ainoa alipaketti, jota yleensä käytetään, on com.aspose.threed.shading (kohteelle PbrMaterial). com.aspose.threed.formats alipaketti sisältää sisäisiä tuonti-/vientitoimintoja, eikä sitä yleensä tuoda suoraan.

Java nimeämiskäytäntö: Kaikki ominaisuudet käyttävät getter-/setter-metodeja. Esimerkiksi käytä node.getTransform() sen sijaan node.transform, ja transform.setTranslation(...) sen sijaan transform.translation = .... Huomaa, että Vector3, Vector4, Quaternion, Matrix4, ja FVector tyypit käyttävät julkisia kenttiä (v.x, v.y, v.z) sen sijaan että käytettäisiin getterejä komponenttien hakemiseen.

Ydinkohtausgrafi

EnumerationsEnumerations
SceneYlätason säiliö kaikille 3D‑kohtausdatalle. Sisältää juurisolmun, resurssien metatiedot ja animaatioleikkeet. Paljastaa fromFile(), open(), ja save() ensisijaisina I/O‑sisääntulopisteinä.
NodeNimetty solmu kohtaushierarkiassa. Omistaa luettelon alisolmuista ja luettelon liitetyistä Entity objekteista, kuten verkkojen, kameroiden ja valojen. Sisältää paikallisen Transform.
EntityAbstrakti perusluokka kaikille objekteille, jotka voidaan liittää Node. Tarjoaa nimen ja identiteetin, mutta ei omaa geometriaa.
SceneObjectPerusluokka, jota jakavat Node ja Entity.
A3DObjectJuuri‑perusluokka kaikille Aspose.3D hallinnoimille objekteille. Paljastaa nimiominaisuuden ja Properties kokoelman.
INamedObjectRajapinta, joka takaa getName() menetelmän. Toteutettu Node, Entity, ja useita formaatti‑spesifisiä kuvaustyyppejä.

Geometria ja verkko

EnumerationsEnumerations
MeshPolygoniverkko-olio. Tallentaa ohjauspisteet (solmupisteet muodossa Vector4), polygonin kasvotlistat (ohjauspisteindeksien listat), ja solmu-elementtikerrokset (normaalit, UV:t, solmujen värit).
GeometryAbstrakti perusluokka verkkomaisille geometrialajeille. Määrittelee ohjauspiste-taulukon ja kokoelman VertexElement kerroksia. Mesh perii luokasta Geometry.
VertexElementAbstrakti perusluokka geometriassa (normaaleja, UV:ita, värejä jne.) liitetylle datakerrokselle. Sisältää getMappingMode(), getReferenceMode(), ja datalista.
VertexElementNormalTallentaa yhden normaalivektorin per kärki tai per polygonin kulma, riippuen kartoitustilasta. Datarivit ovat Vector4 instansseja, joissa on w käyttämättömiä.
VertexElementUVTallentaa tekstuurikoordinaattiparit (Vector2) per kärki tai per polygonin kulma. Verkko voi sisältää useita UV-kerroksia eri tekstuurikanaville.
VertexElementVertexColorTallentaa per‑kärki tai per‑kulma RGBA‑väridataa muodossa Vector4 (r, g, b, a välillä 0–1).
VertexElementTypeLuettelo, joka määrittää solmu‑elementtikerroksen semanttisen roolin: NORMAL, UV, VERTEX_COLOR, ja muita. Syötä arvot Mesh.getElement().
MappingModeLuettelo, joka ohjaa, mihin primitiiviin solmu‑elementin arvo kartoitetaan: CONTROL_POINT, POLYGON_VERTEX, tai POLYGON.
ReferenceModeLuettelo, joka ohjaa, miten arvot indeksoidaan: DIRECT (yksi arvo per kartoitusprimitiivi) tai INDEX_TO_DIRECT (arvojen taulukko plus erillinen indeksitaulukko).

Transformaatio ja spatiaalinen

EnumerationsEnumerations
TransformPaikallinen muunnos liitetty Node. Tarjoaa siirtymän, kierron (kuten Quaternion), ja skaalauskomponentit, sekä kätevät metodit Euler-kulmille.
GlobalTransformVain luku -näkymä solmun maailmanavaruuden muunnoksesta sen jälkeen, kun kaikki vanhempien muunnokset on yhdistetty. Käytettävissä kautta node.getGlobalTransform().
AssetInfoMetatietolohko, joka on liitetty Scene.Tallentaa tekijäohjelman nimen, yksikön nimen, yksikön skaalauskerroin, koordinaatistojärjestelmän akselien määritelmät sekä luonti-/muokkausaikaleimat.

Materiaalit ja varjostus

EnumerationsEnumerations
MaterialAbstrakti perusluokka kaikille materiaalityypeille. Tarjoaa nimen ja ominaisuuskokoelman numeerisille ja väri‑parametreille.
PbrMaterialFysiikassa perustuva renderöintimateriaali. Tallentaa albedon, metallisuuden kertoimen, karheuden kertoimen, emissiivisen värin, läpinäkyvyyden ja siihen liittyvät tekstuurit. Käytetään glTF 2.0:ssa ja muissa PBR-yhteensopivissa formaateissa. Tuonti: com.aspose.threed.shading.PbrMaterial.

Enumerations

EnumerationsEnumerations
CameraKamera‑entiteetti. Perii Entity. Mikään formaattikohtainen ominaisuus ei ole näkyvissä Java FOSS -versiossa perityn nimen ja ominaisuuskokoelman lisäksi. Liitetty Node määrittämään näkökulman muunnokset.

Huomautus: Enumerations Light luokka ei ole saatavilla Java -versiossa Aspose.3D FOSS:issa. Tuodusta tiedostosta peräisin oleva kohtauksen valaistustieto tallennetaan geneerisinä Entity objekteina.

Matematiikkatyökalut

EnumerationsEnumerations
Vector2Kaksoistarkkuuden 2-komponenttinen vektori (x, y). Käytetään UV-tekstuurikoordinaatteihin.
Vector3Kaksoistarkkuuden 3-komponenttinen vektori (x, y, z). Käytetään sijainteihin, suuntiin ja skaalaamiseen.
Vector4Kaksoistarkkuuden 4-komponenttinen vektori (x, y, z, w). Käytetään ohjauspisteisiin (homogeeniset sijainnit) ja normaalidataan.
FVector3Yhden tarkkuuden 3-komponenttinen liukulukuvektori. Esiintyy vertex-elementtien data-taulukoissa normaalien ja tangenttien osalta.
FVector4Yhden tarkkuuden 4-komponenttinen liukulukuvektori. Tallennustyyppi VertexElementFVector data.
QuaternionYksikkökvaternion kiertojen esittämiseen (w, x, y, z). Käytetään Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxAkselien suuntaama rajaava laatikko määritelty getMinimum() ja getMaximum() Vector3 kulmista. Käytetään spatiaalisiin kyselyihin ja näkökentän leikkausapureihin.

Enumerations

EnumerationsEnumerations
AnimationClipNimetty säiliö animaatioalueelle. A Scene voi sisältää useita leikkejä (esim. “Walk”, “Run”). Ilmoituksen runko — avainruutujen dataa ja toistoa ei ole vielä toteutettu.

Formaatti I/O

EnumerationsEnumerations
Scene.fromFile(path)Staattinen metodi. Avaa tiedoston osoitteessa path, havaitsee formaatin tiedostopäätteestä ja palauttaa täytetyn Scene. Heittää poikkeuksen, jos tiedostoa ei löydy tai formaatti ei ole tuettu.
Scene.open(path, options)Instanssimetodi. Avaa tiedoston olemassa olevaan Scene instanssiin, valinnaisesti käyttäen formaattiin perustuvaa LoadOptions aliluokkaa.
Scene.save(path, options)Instanssimetodi. Sarjoittaa kohtauksen kohteeseen path käyttäen tiedostopäätteestä pääteltyä formaattia, valinnaisesti käyttäen formaattiin perustuvaa SaveOptions aliluokka.
FileFormatTuettujen tiedostomuotojen rekisteri. Sisältää merkintöjä kuten FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceSisäinen I/O-abstraktio, jota käyttävät formaattien tuonti- ja vientitoiminnot. Sitä ei yleensä käytetä suoraan sovelluskoodissa.
LoadOptionsPerusluokka kaikille formaattiin spesifisille latausvaihtoehto-objekteille. Aliluokkana on ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsPerusluokka kaikille formaattiin spesifisille tallennusvaihtoehto-objekteille. Aliluokkana on ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ‑formaatti

EnumerationsEnumerations
ObjImporterSisäinen tuontiluokka, joka jäsentää Wavefront OBJ- ja MTL-tiedostoja. Kutsutaan automaattisesti by Scene.fromFile() kohteelle .obj tiedostopäätteet.
ObjLoadOptionsLatausvaihtoehdot Wavefront OBJ -tiedostoille. Keskeiset ominaisuudet: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsTallennusvaihtoehdot Wavefront OBJ -tulosteelle. Hallitsee normaalivektoreita, UV-koordinaatteja, materiaaliviitteitä ja pistepilvimoodia.
ObjFormatFormaattikuvaus Wavefront OBJ:lle. Käytettävissä muodossa FileFormat.WAVEFRONT_OBJ().

STL‑formaatti

EnumerationsEnumerations
StlImporterSisäinen tuonti, joka lukee sekä binääri- että ASCII STL -tiedostoja. Valitaan automaattisesti tiedostopäätteen perusteella.
StlExporterSisäinen vienti, joka kirjoittaa STL:n.
StlLoadOptionsLatausvaihtoehdot STL-tiedostoille. Tukee setFlipCoordinateSystem(), setRecalculateNormal(), ja setContentType().
StlSaveOptionsTallennusvaihtoehdot STL-tulosteelle. Hallitsee setFlipCoordinateSystem(), setAxisSystem(), ja setContentType().
StlFormatFormaattikuvaus STL:lle.

glTF‑formaatti

EnumerationsEnumerations
GltfLoadOptionsLataa asetukset glTF 2.0- ja GLB-tiedostoille. Keskeiset ominaisuudet: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsTallenna asetukset glTF 2.0- ja GLB-tulosteelle. Käytä setContentType(FileContentType.BINARY) tuottamaan itsenäisen .glb paketin.
GltfFormatMuodon kuvaus glTF 2.0 / GLB. Käytettävissä muodossa FileFormat.GLTF2().

FBX-muoto

FBX on tuettu vain tuonti. FBX-vienti ei ole saatavilla Java FOSS -versiossa.

EnumerationsEnumerations
FbxLoadOptionsLatausasetukset FBX-tiedostoille. Keskeinen ominaisuus: setFlipCoordinateSystem().
FbxFormatMuodon kuvaus FBX:lle. Käytettävissä muodossa FileFormat.FBX7400ASCII().

Enumerations

EnumerationsEnumerations
AxisMäärittää koordinaattiakselin: X_AXIS, Y_AXIS, Z_AXIS. Käytetään koordinaattijärjestelmän uudelleenmääritysvalinnoissa.
CoordinateSystemMäärittää kädenkäsittelyn konvention: RIGHT_HANDED tai LEFT_HANDED.
TextureMappingMäärittää, miten tekstuuri on kartoitettu geometriaan: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, jne.
BooleanOperationCSG Boolean -operaatiotyyppi: UNION, DIFFERENCE, INTERSECTION.

Ominaisuuksien järjestelmä

EnumerationsEnumerations
PropertyYksittäinen nimetty tyyppinen ominaisuus A3DObject. Tallentaa ominaisuuden nimen, tyyppikuvauksen ja nykyisen arvon.
PropertyCollectionIteroitava kokoelma Property objekteja liitettynä A3DObject. Tukee hakua nimen perusteella ja iteraatiota kaikkien määriteltyjen ominaisuuksien yli.
CustomObjectKevyt A3DObject aliluokka, joka sisältää vain nimen ja mielivaltaisen PropertyCollection. Käytetään käyttäjän määrittelemän metatiedon tallentamiseen kohtauksen objekteihin.

Kuva ja renderöinti

EnumerationsEnumerations
ImageRenderOptionsOhjelmistorasteroinnin asetukset, kun renderöidään kohtaus kuvapuskuriin. Tallentaa taustavärin, kuvan mitat ja kameraviitteen. Tämä ominaisuus on saatavilla tuetuissa kokoonpanoissa.

Katso myös

 Suomi