API atsauce uz aspose-3d-foss 26.1.0 (Java 21+, MIT licence).
Visas klases atrodas com.aspose.threed saknes pakotnē. Saknes imports ir:
Pakotnes struktūra: Gandrīz visas publiskās klases atrodas com.aspose.threed. Vienīgais apakšpakete, ko parasti izmanto, ir com.aspose.threed.shading (priekš PbrMaterial). Tas com.aspose.threed.formats apakšpakete satur iekšējos importētājus/eksportētājus un parasti netiek importēta tieši.
Java nosaukšanas konvencija: Visām īpašībām tiek izmantotas getter/setter metodes. Piemēram, lietojiet node.getTransform() nevis node.transform, un transform.setTranslation(...) nevis transform.translation = .... Ņemiet vērā, ka Vector3, Vector4, Quaternion, Matrix4, un FVector tipi izmanto publiskus laukus (v.x, v.y, v.z) nevis getteri komponentu piekļuvei.
Kodol Scēnas Grafiks
| Enumerations | Enumerations |
|---|
Scene | Augstākā līmeņa konteiner visiem 3D skenes datiem. Satur saknes mezglu, līdzekļu metadatus un animācijas klipus. Nodrošina fromFile(), open(), un save() kā galvenie I/O piekļuves punkti. |
Node | Nosaukts mezgls skenes hierarhijā. Satur sarakstu ar bērnu mezgliem un sarakstu ar pievienoti Entity objekti, piemēram, režģi, kameras un gaismas. Nes vietējo Transform. |
Entity | Abstrakta pamata klase visiem objektiem, kas var tikt pievienoti Node. Nodrošina nosaukumu un identitāti, bet neapraksta pašu ģeometriju. |
SceneObject | Pamatforma, ko koplieto Node un Entity. Nodrošina īpašību kolekcijas interfeisu, ko izmanto lietotāja definētām metadatiem. |
A3DObject | Saknes pamata klase visiem Aspose.3D pārvaldītajiem objektiem. Atklāj name īpašību un the Properties kolekcija. |
INamedObject | Interfeiss, kas garantē a getName() metodi. Implementēts ar Node, Entity, un vairāki formāta specifiski aprakstītāji. |
Ģeometrija un Tīkls
| Enumerations | Enumerations |
|---|
Mesh | Poligona režģa vienība. Saglabā kontroles punktus (virsotnes pozīcijas kā Vector4), poligona seju saraksti (kontroles punktu indeksu saraksti), un virsotnes elementu slāņi (normāles, UV, virsotnes krāsas). |
Geometry | Abstrakta bāze režģveida ģeometrijas tipiem. Definē kontroles punktu masīvu un kolekciju VertexElement slāņi. Mesh manto no Geometry. |
VertexElement | Abstrakta bāze datu slānim, kas pievienots ģeometrijai (normāles, UV, krāsas utt.). Nēsā getMappingMode(), getReferenceMode(), un datu sarakstu. |
VertexElementNormal | Saglabā vienu normālu vektoru katram virsotnei vai katram daudzstūra stūrim, atkarībā no kartēšanas režīma. Datu vērtības ir Vector4 instancēm ar w neizmantots. |
VertexElementUV | Saglabā tekstūras koordinātu pārus (Vector2) uz katras virsotnes vai katra poligona stūra. Tīkls var saturēt vairākus UV slāņus dažādiem tekstūras kanāliem. |
VertexElementVertexColor | Saglabā katras virsotnes vai katra stūra RGBA krāsu datus kā Vector4 (r, g, b, a diapazonā 0–1). |
VertexElementType | Uzskaitījums, kas identificē semantisko lomu virsotnes elementa slānī: NORMAL, UV, VERTEX_COLOR, un citi. Pārsūtiet vērtības uz Mesh.getElement(). |
MappingMode | Uzskaitījums, kas kontrolē, uz kuru primitīvu virsotnes elementa vērtība tiek kartēta: CONTROL_POINT, POLYGON_VERTEX, vai POLYGON. |
ReferenceMode | Uzskaitījums, kas kontrolē, kā vērtības tiek indeksētas: DIRECT (viena vērtība uz katru kartēšanas primitīvu) vai INDEX_TO_DIRECT (vērtību masīvs plus atsevišķs indeksu masīvs). |
Transformācija un Telpiskie
| Enumerations | Enumerations |
|---|
Transform | Lokāla transformācija, kas pievienota Node. Nodrošina translāciju, rotāciju (kā Quaternion), un mēroga komponentes, kā arī ērtas metodes Eilera leņķiem. |
GlobalTransform | Tikai lasāma skats uz mezgla pasaules telpas transformāciju pēc visu priekšgājēju transformāciju apvienošanas. Piekļūst caur node.getGlobalTransform(). |
AssetInfo | Metadatu bloks, kas pievienots Scene. Saglabā autorēšanas lietojumprogrammas nosaukumu, vienības nosaukumu, vienības mēroga koeficientu, koordinātu sistēmas asu definīcijas un izveides/modifikācijas laika zīmes. |
Materiāli un Ēnošana
| Enumerations | Enumerations |
|---|
Material | Abstrakta pamata klase visiem materiālu tipiem. Nodrošina nosaukumu un īpašību kolekciju skaitliskajiem un krāsu parametriem. |
PbrMaterial | Fiziski balstīta renderēšanas (PBR) materiāls. Saglabā albedo, metāla koeficientu, raupjuma koeficientu, emisijas krāsu, caurspīdīgumu un saistītās tekstūras. Lieto glTF 2.0 un citos PBR spējīgos formātos. Importēšana: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Kameras vienība. Manto no Entity. Formātam specifiskas īpašības nav pieejamas Java FOSS izdevumā, izņemot mantoto nosaukumu un īpašību kolekciju. Pievienots Node lai definētu skatpunktu transformācijas. |
Piezīme: Enumerations Light klase nav pieejama Java izdevumā Aspose.3D FOSS. Ainas apgaismojuma dati no importētām failiem tiek saglabāti kā vispārīgi Entity objekti.
Matemātikas Rīki
| Enumerations | Enumerations |
|---|
Vector2 | Dubultas precizitātes 2-komponentu vektors (x, y). Lietots UV tekstūras koordinātām. |
Vector3 | Dubultas precizitātes 3-komponentu vektors (x, y, z). Lietots pozīcijām, virzieniem un mērogam. |
Vector4 | Dubultas precizitātes 4-komponentu vektors (x, y, z, w). Izmanto kontroles punktiem (homogēnas pozīcijas) un normālu datiem. |
FVector3 | Vienkāršas precizācijas 3-komponentu float vektors. Parādās virsotnes elementu datu masīvos normālēm un tangentiem. |
FVector4 | Vienkāršas precizācijas 4-komponentu float vektors. Glabāšanas tips VertexElementFVector dati. |
Quaternion | Vienības kvaternions rotāciju attēlošanai (w, x, y, z). Lieto Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Ašas‑līdzināta ierobežojoša kaste, kas definēta ar getMinimum() un getMaximum() Vector3 stūriem. Lietots telpiskām vaicājumiem un redzes lauka izgriešanas palīgprogrammu. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Nosaukts konteineris animācijas diapazonam. A Scene var saturēt vairākus klipus (piem., “Walk”, “Run”). Deklarācijas šablons — atslēgkadru dati un atskaņošana vēl nav īstenota. |
Formāta I/O
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Statiskā metode. Atver failu vietā path, noskaidro formātu no paplašinājuma un atgriež aizpildītu Scene. Izmet kļūdu, ja fails nav atrasts vai formāts nav atbalstīts. |
Scene.open(path, options) | Instancēšanas metode. Atver failu esošā Scene instancē, izvēles iespējam, izmantojot formātam specifisku LoadOptions apakšklasi. |
Scene.save(path, options) | Instancēšanas metode. Serializē ainu uz path izmantojot formātu, kas izsecināts no paplašinājuma, izvēles iespēja izmantot formātam specifisku SaveOptions apakšklasi. |
FileFormat | Atbalstīto failu formātu reģistrs. Satur ierakstus, piemēram FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Iekšējā I/O abstrakcija, ko izmanto formāta importētāji un eksportētāji. Parasti netiek izmantota tieši lietojumprogrammas kodā. |
LoadOptions | Bāzes klase visiem formāta specifiskajiem ielādes opciju objektiem. Paplašināta ar ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Bāzes klase visiem formāta specifiskajiem saglabāšanas opciju objektiem. Paplašināta ar ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
OBJ formāts
| Enumerations | Enumerations |
|---|
ObjImporter | Iekšējā importētāja klase, kas parsē Wavefront OBJ un MTL failus. Automātiski izsauc to Scene.fromFile() priekš .obj paplašinājumi. |
ObjLoadOptions | Ielādes iespējas Wavefront OBJ failiem. Galvenās īpašības: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Saglabāšanas iespējas Wavefront OBJ izvadei. Kontrolē normāles, UV koordinātas, materiālu atsauces un punktu mākoņa režīmu. |
ObjFormat | Formāta apraksts Wavefront OBJ. Pieejams kā FileFormat.WAVEFRONT_OBJ(). |
STL formāts
| Enumerations | Enumerations |
|---|
StlImporter | Iekšējais importētājs, kas lasa gan bināros, gan ASCII STL failus. Automātiski izvēlēts pēc paplašinājuma. |
StlExporter | Iekšējais eksportētājs, kas raksta STL. |
StlLoadOptions | Ielādes iespējas STL failiem. Atbalsta setFlipCoordinateSystem(), setRecalculateNormal(), un setContentType(). |
StlSaveOptions | Saglabāšanas iespējas STL izvadei. Kontrolē setFlipCoordinateSystem(), setAxisSystem(), un setContentType(). |
StlFormat | Formāta apraksts STL. |
glTF formāts
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Ielādēšanas iespējas glTF 2.0 un GLB failiem. Galvenās īpašības: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Saglabāšanas iespējas glTF 2.0 un GLB izvadei. Izmantojiet setContentType(FileContentType.BINARY) lai izveidotu pašpietiekamu .glb pakotni. |
GltfFormat | Formāta apraksts glTF 2.0 / GLB. Pieejams kā FileFormat.GLTF2(). |
FBX formāts
FBX tiek atbalstīts tikai importam. Eksports uz FBX nav pieejams Java FOSS izdevumā.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Ielādes iespējas FBX failiem. Galvenā īpašība: setFlipCoordinateSystem(). |
FbxFormat | Formāta apraksts FBX. Pieejams kā FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Identificē koordinātu asi: X_AXIS, Y_AXIS, Z_AXIS. Lietots koordinātu sistēmas pārkartēšanas opcijās. |
CoordinateSystem | Norāda rokas (handedness) konvenciju: RIGHT_HANDED vai LEFT_HANDED. |
TextureMapping | Identificē, kā tekstūra tiek kartēta uz ģeometrijas: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, utt. |
BooleanOperation | CSG Booleānas operācijas veids: UNION, DIFFERENCE, INTERSECTION. |
Īpašību sistēma
| Enumerations | Enumerations |
|---|
Property | Viena nosaukta tipizēta īpašība uz an A3DObject. Saglabā īpašības nosaukumu, tipa aprakstu un pašreizējo vērtību. |
PropertyCollection | Iterējama kolekcija no Property objekti, kas pievienoti an A3DObject. Atbalsta meklēšanu pēc nosaukuma un iterāciju pār visām definētajām īpašībām. |
CustomObject | Viegls A3DObject apakšklase, kas nes tikai nosaukumu un patvaļīgu PropertyCollection. Izmanto, lai saglabātu lietotāja definētus metadatus uz ainas objektiem. |
Attēls un renderēšana
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Opcijas programmatūras rasterizācijai, kad tiek renderēta aina uz attēla bufera. Saglabā fona krāsu, attēla dimensijas un kameras atsauci. Šī funkcija ir pieejama atbalstītajās konfigurācijās. |
Skatīt arī
