Aspose.3D FOSS for Java

API reference pro aspose-3d-foss 26.1.0 (Java 21+, licence MIT).

Všechny třídy se nacházejí v com.aspose.threed kořenovém balíčku. Kořenový import je:

import com.aspose.threed.*;

Rozvržení balíčků: Téměř všechny veřejné třídy jsou v com.aspose.threed. Jediný podbalíček, který se obvykle používá, je com.aspose.threed.shading (pro PbrMaterial). com.aspose.threed.formats Podbalíček obsahuje interní importéry/exportéry a obvykle se neimportuje přímo.

Java konvence pojmenování: Všechny vlastnosti používají metody getter/setter. Například použijte node.getTransform() namísto node.transform, a transform.setTranslation(...) namísto transform.translation = .... Všimněte si, že Vector3, Vector4, Quaternion, Matrix4, a FVector typy používají veřejná pole (v.x, v.y, v.z) spíše než gettery pro přístup ke komponentám.

Základní graf scény

EnumerationsEnumerations
SceneKontejner nejvyšší úrovně pro všechna 3D data scény. Obsahuje kořenový uzel, metadata assetů a animační klipy. Exponuje fromFile(), open(), a save() jako hlavní vstupní/výstupní body.
NodePojmenovaný uzel v hierarchii scény. Vlastní seznam poduzlů a seznam připojených Entity objektů, jako jsou sítě, kamery a světla. Nese lokální Transform.
EntityAbstraktní základní třída pro všechny objekty, které mohou být připojeny k Node. Poskytuje název a identitu, ale nemá vlastní geometrii.
SceneObjectZákladní třída sdílená mezi Node a Entity. Poskytuje rozhraní kolekce vlastností používané pro uživatelem definovaná metadata.
A3DObjectKořenová základní třída pro všechny Aspose.3D spravované objekty. Exponuje vlastnost name a Properties kolekci.
INamedObjectRozhraní, které zaručuje getName() metodu. Implementováno v Node, Entity, a několika formátově specifických typů deskriptorů.

Geometrie a síť

EnumerationsEnumerations
MeshEntita polygonové sítě. Ukládá řídicí body (pozice vrcholů jako Vector4), seznamy polygonových ploch (seznamy indexů řídicích bodů) a vrstvy elementů vrcholů (normály, UV, barvy vrcholů).
GeometryAbstraktní základ pro typy geometrie podobné sítím. Definuje pole řídicích bodů a kolekci VertexElement vrstev. Mesh dědí z Geometry.
VertexElementAbstraktní základna pro datovou vrstvu připojenou k geometrii (normály, UV, barvy atd.). Nese getMappingMode(), getReferenceMode(), a seznam dat.
VertexElementNormalUkládá jeden normálový vektor na vrchol nebo na roh polygonu, v závislosti na režimu mapování. Hodnoty dat jsou Vector4 instance s w nepoužito.
VertexElementUVUkládá páry texturovacích souřadnic (Vector2) na vrchol nebo na roh polygonu. Síť může nést více UV vrstev pro různé texturové kanály.
VertexElementVertexColorUkládá RGBA barevná data na vrchol nebo na roh jako Vector4 (r, g, b, a v rozsahu 0–1).
VertexElementTypeVýčtový typ identifikující sémantickou roli vrstvy prvku vrcholu: NORMAL, UV, VERTEX_COLOR, a další. Předávejte hodnoty do Mesh.getElement().
MappingModeVýčtový typ řídící, ke které primitivě se hodnota prvku vrcholu mapuje: CONTROL_POINT, POLYGON_VERTEX, nebo POLYGON.
ReferenceModeVýčtový typ řídící, jak jsou hodnoty indexovány: DIRECT (jedna hodnota na mapovací primitivu) nebo INDEX_TO_DIRECT (pole hodnot plus samostatné pole indexů).

Transformace a prostor

EnumerationsEnumerations
TransformLokální transformace připojená k Node. Poskytuje translaci, rotaci (jako Quaternion), komponenty měřítka a pohodlné metody pro Eulerovy úhly.
GlobalTransformZobrazení pouze pro čtení transformace uzlu ve světovém prostoru po složení všech transformací předků. Přístupné přes node.getGlobalTransform().
AssetInfoBlok metadat připojený k Scene. Ukládá název autorovací aplikace, název jednotky, faktor měřítka jednotky, definice os souřadnicového systému a časové značky vytvoření/úpravy.

Materiály a stínování

EnumerationsEnumerations
MaterialAbstraktní základní třída pro všechny typy materiálů. Poskytuje název a kolekci vlastností pro číselné a barevné parametry.
PbrMaterialMateriál založený na fyzikálně založeném renderování (Physically Based Rendering). Ukládá albedo, kovový faktor, faktor drsnosti, emisní barvu, průhlednost a související textury. Používá se v glTF 2.0 a dalších formátech podporujících PBR. Import: com.aspose.threed.shading.PbrMaterial.

Enumerations

EnumerationsEnumerations
CameraEntita kamery. Dědí z Entity. V edici Java FOSS nejsou k dispozici žádné formátově specifické vlastnosti kromě zděděného názvu a kolekce vlastností. Připojeno k Node pro definování transformací pohledu.

Poznámka: Enumerations Light třída není k dispozici v edici Java Aspose.3D FOSS. Data osvětlení scény z importovaných souborů jsou uložena jako obecné Entity objekty.

Matematické utility

EnumerationsEnumerations
Vector2Dvojitá přesnost 2‑komponentový vektor (x, y). Používá se pro UV souřadnice textur.
Vector3Dvojitá přesnost 3‑komponentový vektor (x, y, z). Používá se pro pozice, směry a měřítko.
Vector4Dvojitá přesnost 4‑komponentový vektor (x, y, z, w). Používá se pro řídicí body (homogenní pozice) a normálová data.
FVector3Jednoduchá přesnost, 3‑složkový float vektor. Objevuje se v polích dat vrcholových elementů pro normály a tangenty.
FVector4Jednoduchá přesnost, 4‑složkový float vektor. Typ úložiště VertexElementFVector data.
QuaternionJednotkový kvaternion pro reprezentaci rotací (w, x, y, z). Používá se v Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxOsa‑zarovnaný ohraničující kvádr definovaný getMinimum() a getMaximum() Vector3 rohy. Používá se pro prostorové dotazy a pomocníky pro ořezávání frustru.

Enumerations

EnumerationsEnumerations
AnimationClipPojmenovaný kontejner pro rozsah animace. A Scene může obsahovat více klipů (např. „Walk“, „Run“). Deklarace šablony — data klíčových snímků a přehrávání ještě nejsou implementovány.

Formát I/O

EnumerationsEnumerations
Scene.fromFile(path)Statická metoda. Otevře soubor na path, detekuje formát podle přípony a vrátí naplněný Scene. Vyvolá výjimku při nenalezení souboru nebo nepodporovaném formátu.
Scene.open(path, options)Instanční metoda. Otevře soubor do existující Scene instance, volitelně s použitím formátově specifického LoadOptions podtřídy.
Scene.save(path, options)Instanční metoda. Serializuje scénu do path používá formát odvozený od přípony, volitelně s formátově specifickým SaveOptions podtřída.
FileFormatRegistr podporovaných formátů souborů. Obsahuje položky jako FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceInterní abstrakce I/O používaná importéry a exportéry formátů. Obvykle se nepoužívá přímo v aplikačním kódu.
LoadOptionsZákladní třída pro všechny objekty specifické pro načítání podle formátu. Podtřídou je ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsZákladní třída pro všechny objekty specifické pro ukládání podle formátu. Podtřídou je ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

Formát OBJ

EnumerationsEnumerations
ObjImporterInterní třída importéru, která parsuje soubory Wavefront OBJ a MTL. Automaticky volána Scene.fromFile() pro .obj rozšíření.
ObjLoadOptionsMožnosti načítání pro soubory Wavefront OBJ. Klíčové vlastnosti: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsMožnosti ukládání pro výstup Wavefront OBJ. Ovládá normály, UV souřadnice, odkazy na materiály a režim bodového mraku.
ObjFormatPopis formátu pro Wavefront OBJ. Přístupný jako FileFormat.WAVEFRONT_OBJ().

Formát STL

EnumerationsEnumerations
StlImporterInterní importér, který čte jak binární, tak ASCII soubory STL. Automaticky vybrán podle rozšíření.
StlExporterInterní exportér, který zapisuje STL.
StlLoadOptionsMožnosti načítání pro soubory STL. Podporuje setFlipCoordinateSystem(), setRecalculateNormal(), a setContentType().
StlSaveOptionsMožnosti ukládání pro výstup STL. Ovládá setFlipCoordinateSystem(), setAxisSystem(), a setContentType().
StlFormatPopis formátu pro STL.

Formát glTF

EnumerationsEnumerations
GltfLoadOptionsNačíst možnosti pro soubory glTF 2.0 a GLB. Klíčové vlastnosti: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsUložit možnosti pro výstup glTF 2.0 a GLB. Použijte setContentType(FileContentType.BINARY) k vytvoření samostatného .glb balíčku.
GltfFormatPopis formátu pro glTF 2.0 / GLB. Přístupný jako FileFormat.GLTF2().

Formát FBX

FBX je podporováno pro pouze import. Export do FBX není k dispozici v edici Java FOSS.

EnumerationsEnumerations
FbxLoadOptionsMožnosti načítání pro soubory FBX. Klíčová vlastnost: setFlipCoordinateSystem().
FbxFormatPopis formátu pro FBX. Přístupný jako FileFormat.FBX7400ASCII().

Enumerations

EnumerationsEnumerations
AxisIdentifikuje souřadnicovou osu: X_AXIS, Y_AXIS, Z_AXIS. Použito v možnostech přemapování souřadnicového systému.
CoordinateSystemUrčuje konvenci pravotočivosti: RIGHT_HANDED nebo LEFT_HANDED.
TextureMappingIdentifikuje, jak je textura mapována na geometrii: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, atd.
BooleanOperationTyp Booleovské operace CSG: UNION, DIFFERENCE, INTERSECTION.

Systém vlastností

EnumerationsEnumerations
PropertyJedna pojmenovaná typová vlastnost na A3DObject. Ukládá název vlastnosti, popis typu a aktuální hodnotu.
PropertyCollectionIterovatelná kolekce of Property objekty připojené k A3DObject. Podporuje vyhledávání podle názvu a iteraci přes všechny definované vlastnosti.
CustomObjectLehký A3DObject podtřída, která nese pouze název a libovolný PropertyCollection. Používá se k ukládání uživatelem definovaných metadat na objektech scény.

Obrázek a renderování

EnumerationsEnumerations
ImageRenderOptionsMožnosti softwarové rasterizace při vykreslování scény do obrazového bufferu. Ukládá barvu pozadí, rozměry obrazu a referenci kamery. Tato funkce je k dispozici v podporovaných konfiguracích.

Viz také

 Čeština