Aspose.3D FOSS for Python

API-referencia a aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT licenc).

Minden osztály importálva van a aspose.threed csomagból vagy annak alcsomagjaiból. A gyökérimport:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

Alap Jelenetgrafikon

MethodsMethods
SceneA legfelső szintű tároló minden 3D jelenet adat számára. Tartalmazza a gyökércsomópontot, az eszköz metaadatait és az animációs klipeket. Kitetti from_file(), 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 objektumok, 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. Név és azonosító biztosítja, de saját geometriát nem tartalmaz.
SceneObjectAlap osztá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. Kitetti a név tulajdonságot és a Properties gyűjteményt.
INamedObjectInterfész, amely garantál egy name tulajdonságot. Implementálja Node, Entity, valamint több formátum-specifikus leíró típust.

Geometria és háló

MethodsMethods
MeshPoligon háló entitás. Tárolja a vezérlőpontokat (csúcspont pozí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óhoz hasonló geometria típusokhoz. Meghatározza a vezérlőpont tömböt és a gyűjteményt a VertexElement rétegeket. Mesh örököl a Geometry.
VertexElementAbsztrakt alap egy adat réteghez, amely a geometriához van csatolva (normálok, UV-k, színek, stb.). Tartalmazza mapping_mode, reference_mode, és egy data listát.
VertexElementNormalTárol egy normál vektort csúcsonként vagy poligon sarokként, attól függően, hogy mapping_mode. Az adatértékek FVector4 példányok (egyes pontosságú) a w fel nem használt.
VertexElementUVTárolja a textúra-koordináta adatokat mint FVector4 csúcsonként vagy poligon sarokként (csak x és y komponensek használatosak UV-hez). Egy háló több UV réteget is tartalmazhat különböző textúra csatornákhoz.
VertexElementVertexColorPer-vertex vagy per-corner RGBA színadatokat tárolja, mint FVector4 (r, g, b, a a 0–1 tartományban).
VertexElementSmoothingGroupPer-polygon simítási csoport egész számú azonosítókat tárol, amelyeket az OBJ importáló használ az eredeti simítási csoport hozzárendelések visszaállításához a forrásfájlból.
VertexElementTypeFelsorolás, amely meghatározza egy csúcselem réteg szemantikai szerepét: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, és mások. Értékeket ad át a Mesh.get_element().
MappingModeFelsorolás, amely szabályozza, hogy mely primitívhez térképzi a csúcselem értékét: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, vagy ALL_SAME.
ReferenceModeFelsorolás, amely szabályozza, hogyan indexelik az értékeket: DIRECT (egy érték minden leképezési primitívhez) vagy INDEX_TO_DIRECT (értékek tömbje plusz egy külön indexek tömbje).
PolygonModifierStatikus segédosztály, amely módszereket tartalmaz a háromszögeléshez Mesh objektumok és teljes Scene gráfok.

Transzformáció és térbeli

MethodsMethods
TransformHelyi transzformáció, amely egy Node. Fordítást, forgást (mint Quaternion), és méretezési komponenseket, valamint kényelmi tulajdonságokat az 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 Node.global_transform.
AssetInfoMetaadat-blokk, amely egy Scene. Tárolja a szerzői alkalmazás nevét, az egység nevét, az egység méretezési tényezőjét, a koordináta-rendszer tengelydefiníciókat, valamint a létrehozási/módosítási időbélyegeket.

Anyagok és árnyalás

MethodsMethods
MaterialAbsztrakt alaposztály minden anyagtípushoz. Nevet és egy tulajdonsággyűjteményt biztosít numerikus és színparaméterekhez.
LambertMaterialCsak diffúz anyagmodell. Tárolja a környezeti szín, a diffúz szín, az emisszív szín és az átlátszóság értékét. Betöltve OBJ fájlokból, amelyek alapvető Ka/Kd/Ke deklarációkat.
PhongMaterialMethods LambertMaterial speculáris színnel és fényességgel (speculáris exponens). Betöltve OBJ fájlokból, amelyek használják Ks/Ns deklarációkat.
PbrMaterialFizikai alapú renderelés anyag. Tárolja az albedót, a fémességi tényezőt, a durvasági tényezőt és a kapcsolódó textúrákat. A glTF 2.0 és más PBR-képes formátumok használják.

Kamera és megvilágítás

MethodsMethods
CameraKamera entitás. Csak projection_type és name működnek ebben a kiadásban; minden más numerikus tulajdonság (near_plane, far_plane, field_of_view, aspect_ratio) csak helyőrzők, amelyek alapértelmezett értékeket adnak vissza. Csatolva egy Node a nézőpont transzformációk meghatározásához.
LightFényforrás entitás. Örökli a Camera osztályt helyőrzőként; a Light osztály önmagában nem tesz közzé további tulajdonságokat ebben a kiadásban.
LightTypeA támogatott fénykategóriák felsorolása: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeA kamera projekciós módok felsorolása: PERSPECTIVE és ORTHOGRAPHIC.

Matematikai segédeszközök

MethodsMethods
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őpontokhoz (homogén pozíciók) és normál adatokhoz.
FVector2Egyszeres pontosságú, 2 komponensű lebegőpontos vektor. Belsőleg használják tömör tárolásra a vertex elem adat tömbökben.
FVector3Egyszeres pontosságú, 3 komponensű lebegőpontos vektor. Megjelenik a vertex elem adat tömbökben a normálok és tangensek számára.
FVector4Egyszeres pontosságú, 4 komponensű float vektor. A tárolási típusa VertexElementFVector.data.
QuaternionEgységkvaternion a forgatások ábrázolásához (w, x, y, z). Használja Transform.rotation.
Matrix44×4 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 minimum és maximum Vector3 sarkok. Térbeli lekérdezésekhez és látószög-levágás segédeszközökhöz használják.

Methods

MethodsMethods
AnimationClipNevet kapott tároló egy animált csatornák halmazához, amely egy lejátszási tartományt fed le. Egy Scene több klipet is tartalmazhat (pl. „Walk”, „Run”).
AnimationNodeÖsszekapcsol egy AnimationClip egy adott jelenetcsomóponthoz vagy tulajdonsághoz. A klipadatok és a jelenetgrafikon objektumok közötti hídként működik.
AnimationChannelEgyetlen animált tulajdonságáram egy klipen belül, amely egy objektumon egy nevesített tulajdonságot céloz (pl., Transform.translation.x).
KeyFrameEgyetlen idő‑érték minta egy KeyframeSequence. Tárolja az időt (másodpercben) és az adott időpontban lévő értéket.
KeyframeSequenceRendezett lista a KeyFrame objektumokról egy skalár csatornához, interpolációs és extrapolációs beállításokkal együtt.
InterpolationAz interpolációs módok felsorolása a kulcsképkockák között: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeAz első és az utolsó kulcskockán kívüli viselkedések felsorolása: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

Formátum I/O

MethodsMethods
Scene.from_file(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. Hibát dob, ha a fájl nem található vagy a formátum nem támogatott.
Scene.open(path, options=None)Példány metódus. Megnyit egy fájlt egy meglévő Scene példányba, opcionálisan formátum-specifikus LoadOptions al osztály.
Scene.save(path, options=None)Példány metódus. Sorosítja a jelenetet a path a kiterjesztésből következtetett formátum használatával, opcionálisan formátum-specifikus SaveOptions al osztály.
FileFormatA támogatott fájlformátumok nyilvántartása. Tartalmaz bejegyzéseket, például FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF. A formátum-specifikus változatok opció osztályokon keresztül érhetők el (pl., ColladaSaveOptions, GltfSaveOptions).
IOServiceBelső I/O absztrakció, amelyet a formátum importálók és exportálók használnak. Általában nem közvetlenül használják az alkalmazáskód.
LoadOptionsAlaposztály minden formátum-specifikus betöltési opció objektumhoz. Leszármaztatva ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsAlaposztály minden formátum-specifikus mentési opció objektumhoz. Leszármaztatva ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

OBJ formátum

MethodsMethods
ObjImporterBelső importáló osztály, amely a Wavefront OBJ és MTL fájlokat dolgozza fel. Automatikusan meghívja Scene.from_file() a .obj kiterjesztéseket.
ObjLoadOptionsBetöltési opciók a Wavefront OBJ fájlokhoz. Kulcsfontosságú tulajdonságok: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsMentési beállítások 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

MethodsMethods
StlImporterBelső importáló, amely képes bináris és ASCII STL fájlok olvasására. Kiterjesztés alapján automatikusan kiválasztva.
StlExporterBelső exportáló, amely STL-t ír.
StlLoadOptionsBetöltési beállítások STL fájlokhoz. Támogatja flip_coordinate_system és scale.
StlSaveOptionsMentési beállítások STL kimenethez. Szabályozza binary_mode, scale, és flip_coordinate_system.
StlFormatFormátumleíró STL-hez.

glTF formátum

MethodsMethods
GltfLoadOptionsBetöltési beállítások glTF 2.0 és GLB fájlokhoz. Kulcsfontosságú tulajdonság: flip_tex_coord_v.
GltfSaveOptionsMentési beállítások glTF 2.0 kimenethez. Használja binary_mode=True egy önálló GLB csomaghoz.
GltfFormatFormátumleíró glTF 2.0 / GLB-hez. Elérhető mint FileFormat.GLTF2().

FBX formátum

MethodsMethods
FbxLoadOptionsBetöltési beállítások FBX fájlokhoz. Kulcsfontosságú tulajdonságok: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsMentési beállítások FBX kimenethez. Az FBX exportálás kiváltja NotImplementedError feltétlenül; FbxSaveOptions létezik, de az exportálás nincs megvalósítva.
FbxFormatFormátumleíró FBX-hez. Elérhető mint FileFormat.FBX7400ASCII().

COLLADA formátum

MethodsMethods
ColladaLoadOptionsBetöltési beállítások COLLADA (.dae) fájlokhoz. Szabályozza a tengelyek újratérképezését és az egységskálát importáláskor.
ColladaSaveOptionsMentési beállítások a COLLADA kimenethez. Vezérlők indented, flip_coordinate_system, és anyagexport.
ColladaFormatFormátumleíró a COLLADA számára. Automatikusan feloldva a .dae fájlkiterjesztésből.

3MF Format

MethodsMethods
ThreeMfLoadOptions3MF betöltési beállítások (.3mf) fájlok.
ThreeMfSaveOptions3MF kimenet mentési beállításai. A 3MF a 3D nyomtatási munkafolyamatok preferált formátuma.
ThreeMfFormatFormátumleíró a 3MF-hez. Elérhető mint FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
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

MethodsMethods
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 objektumokhoz 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 al osztály, amely csak egy nevet és egy tetszőleges PropertyCollection. A felhasználó által definiált metaadatok tárolására használják a jelenet objektumain.

Kép és renderelés

MethodsMethods
ImageRenderOptionsSzoftveres rasterizálás beállításai, amikor egy jelenetet képpufferbe renderelünk. Tárolja a háttérszínt, a kép méreteit és a kamera referenciát. Scene.render() emel NotImplementedError; a renderelés nincs megvalósítva ebben a kiadásban.

Lásd még

 Magyar