Aspose.3D FOSS for Python

API atsauce uz aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT licence).

Visas klases tiek importētas no aspose.threed paketes vai tās apakšpaketēm. Saknes imports ir:

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

Kodol Scēnas Grafiks

MethodsMethods
SceneAugstākā līmeņa konteiners visiem 3D skatu datiem. Satur saknes mezglu, līdzekļu metadatus un animācijas klipus. Padara pieejamu from_file(), open(), un save() kā galvenie I/O piekļuves punkti.
NodeNosaukts mezgls skatu hierarhijā. Satur sarakstu ar bērnu mezgliem un sarakstu ar pievienotiem Entity objektiem, piemēram, režģiem, kamerām un gaismas avotiem. Nes vietējo Transform.
EntityAbstrakta pamata klase visiem objektiem, kas var tikt pievienoti Node. Sniedz nosaukumu un identitāti, bet neietver nekādu ģeometriju.
SceneObjectPamata klase, ko koplieto Node un Entity. Sniedz īpašību kolekcijas interfeisu, ko izmanto lietotāja definētai metadatu informācijai.
A3DObjectPamatklase visiem Aspose.3D pārvaldītajiem objektiem. Atklāj name īpašību un Properties kolekcija.
INamedObjectInterfeiss, kas garantē name īpašību. Implementē Node, Entity, un vairāki formāta specifiski deskriptora tipi.

Ģeometrija un Tīkls

MethodsMethods
MeshPoligona 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).
GeometryAbstrakta bāze režģveida ģeometrijas tipiem. Definē kontroles punktu masīvu un kolekciju VertexElement slāņi. Mesh manto no Geometry.
VertexElementAbstrakta bāze datu slānim, kas pievienots ģeometrijai (normāles, UV, krāsas utt.). Nes mapping_mode, reference_mode, un data sarakstu.
VertexElementNormalSaglabā vienu normālu vektoru uz virsotnes vai uz poligona stūra, atkarībā no mapping_mode. Datu vērtības ir FVector4 instances (vienkāršā precizitāte) ar w neizmantots.
VertexElementUVSaglabā tekstūras koordinātu datus kā FVector4 uz virsotnes vai uz poligona stūra (tikai x un y komponenti tiek izmantoti UV). Režģis var saturēt vairākus UV slāņus dažādiem tekstūras kanāliem.
VertexElementVertexColorSaglabā katras virsotnes vai katras stūra RGBA krāsu datus kā FVector4 (r, g, b, a diapazonā no 0–1).
VertexElementSmoothingGroupSaglabā katras daudzstūra gludināšanas grupas veselu skaitļu ID, ko izmanto OBJ importētājs, lai atjaunotu sākotnējās gludināšanas grupu piešķiršanas no avota faila.
VertexElementTypeUzskaitījums, kas identificē semantisko lomu virsotnes elementa slānī: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, un citi. Pārsūtiet vērtības uz Mesh.get_element().
MappingModeUzskaitījums, kas kontrolē, uz kuru primitīvu virsotnes elementa vērtība tiek kartēta: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, vai ALL_SAME.
ReferenceModeUzskaitījums, kas kontrolē, kā vērtības tiek indeksētas: DIRECT (viena vērtība uz kartēšanas primitīvu) vai INDEX_TO_DIRECT (vērtību masīvs plus atsevišķs indeksu masīvs).
PolygonModifierStatiskā utilītklase ar metodēm trīsstūrveidošanai Mesh objektus un visus Scene grafikus.

Transformācija un Telpiskie

MethodsMethods
TransformLokāla transformācija, kas pievienota Node. Nodrošina translāciju, rotāciju (kā Quaternion), un mēroga komponentes, kā arī ērtas īpašības Eilera leņķiem.
GlobalTransformTikai lasāms skats uz mezgla pasaules telpas transformāciju pēc visu priekšgājēju transformāciju apvienošanas. Piekļūst caur Node.global_transform.
AssetInfoMetadatu 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īmogus.

Materiāli un Ēnošana

MethodsMethods
MaterialAbstrakta pamata klase visiem materiālu tipiem. Nodrošina nosaukumu un īpašību kolekciju skaitliskajiem un krāsu parametriem.
LambertMaterialTikai difūzais materiāla modelis. Saglabā apkārtējo krāsu, difūzo krāsu, emisijas krāsu un caurspīdīgumu. Ielādēts no OBJ failiem, kas izmanto pamata Ka/Kd/Ke deklarācijas.
PhongMaterialMethods LambertMaterial ar spekulāro krāsu un spīdumu (specular exponent). Ielādēts no OBJ failiem, kas izmanto Ks/Ns deklarācijas.
PbrMaterialFiziski balstīta renderēšanas materiāls. Saglabā albedo, metāla koeficientu, raupjuma koeficientu un saistītās tekstūras. Izmanto glTF 2.0 un citos PBR‑spējīgos formātos.

Kamera un apgaismojums

MethodsMethods
CameraKameras vienība. Tikai projection_type un name ir funkcionāli šajā izdevumā; visas pārējās skaitliskās īpašības (near_plane, far_plane, field_of_view, aspect_ratio) ir stubi, kas atgriež noklusējuma vērtības. Pievienots pie a Node definēt skatpunktu transformācijas.
LightGaismas avota vienība. Manto no Camera kā stub class; Light Klase pati neizpauž papildu īpašības šajā izlaidē.
LightTypeAtbalstīto gaismas kategoriju uzskaitījums: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeKameras projekcijas režīmu uzskaitījums: PERSPECTIVE un ORTHOGRAPHIC.

Matemātikas Rīki

MethodsMethods
Vector2Dubultprecizitātes 2‑komponentu vektors (x, y). Izmanto UV tekstūras koordinātām.
Vector3Dubultprecizitātes 3-komponentu vektors (x, y, z). Izmanto pozīcijām, virzieniem un mērogam.
Vector4Dubultprecizitātes 4-komponentu vektors (x, y, z, w). Izmanto kontroles punktiem (homogēnas pozīcijas) un normālu datiem.
FVector2Vienkāršprecizitātes 2-komponentu peldošā komata vektors. Izmanto iekšēji kompakta glabāšanas nolūkā virsotnes elementu datu masīvos.
FVector3Vienkāršprecizitātes 3-komponentu peldošā komata vektors. Parādās virsotnes elementu datu masīvos normālēm un tangensēm.
FVector4Vienkāršā precizitātes 4-komponentu float vektors. Glabāšanas tips VertexElementFVector.data.
QuaternionVienības kvaternions rotāciju attēlošanai (w, x, y, z). Izmanto Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxAšas‑līdzināta robežkaste, kas definēta ar minimum un maximum Vector3 stūriem. Izmanto telpiskām vaicājumiem un frustum culling palīglīdzekļiem.

Methods

MethodsMethods
AnimationClipNosaukts konteineris kopai animēto kanālu, kas aptver vienu atskaņošanas diapazonu. A Scene var saturēt vairākus klipus (piem., “Walk”, “Run”).
AnimationNodeSaista AnimationClip ar konkrētu ainas mezglu vai īpašību. Darbojas kā tilts starp klipa datiem un ainas grafika objektiem.
AnimationChannelViens animēts īpašuma straumes klips, kas mērķē uz nosauktu īpašumu objektā (piem., Transform.translation.x).
KeyFrameViens laika‑vērtības paraugs iekšā KeyframeSequence. Saglabā laiku (sekundēs) un vērtību tajā brīdī.
KeyframeSequenceKārtots saraksts ar KeyFrame objektiem vienam skalāram kanālam, kopā ar interpolācijas un ekstrapolācijas iestatījumiem.
InterpolationUzskaitījums interpolācijas režīmu starp atslēgkadrēm: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeUzvedības uzskaitījums, kas pārsniedz pirmo un pēdējo atslēgkadrus: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

Formāta I/O

MethodsMethods
Scene.from_file(path)Statiskā metode. Atver failu vietā path, noskaidro formātu no paplašinājuma, un atgriež aizpildītu Scene. Izsauc kļūdu, ja fails nav atrasts vai formāts nav atbalstīts.
Scene.open(path, options=None)Instancēšanas metode. Atver failu esošā Scene instancē, izvēles iespējas, izmantojot formāta specifisku LoadOptions apakšklasi.
Scene.save(path, options=None)Instancēšanas metode. Serializē ainu uz path izmantojot formātu, kas izsecināts no paplašinājuma, izvēles iespējas, izmantojot formāta specifisku SaveOptions apakšklasi.
FileFormatAtbalstīto failu formātu reģistrs. Satur ierakstus, piemēram, FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF. Formāta specifiskās variācijas tiek piekļūtas caur opciju klasēm (piemēram,., ColladaSaveOptions, GltfSaveOptions).
IOServiceIekšējā I/O abstrakcija, ko izmanto formātu importētāji un eksportētāji. Parasti netiek izmantota tieši lietojumprogrammas kodā.
LoadOptionsBāzes klase visām formāta specifiskajām ielādes opciju objektiem. Apakšklases: ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsBāzes klase visām formāta specifiskajām saglabāšanas opciju objektiem. Apakšklases: ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

OBJ formāts

MethodsMethods
ObjImporterIekšējā importētāja klase, kas parsē Wavefront OBJ un MTL failus. Automātiski izsauc to Scene.from_file() priekš .obj paplašinājumus.
ObjLoadOptionsIelādes opcijas Wavefront OBJ failiem. Galvenās īpašības: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsSaglabāšanas iespējas Wavefront OBJ izvadei. Kontrolē normāles, UV koordinātas, materiālu atsauces un punktu mākoņa režīmu.
ObjFormatFormāta apraksts Wavefront OBJ. Pieejams kā FileFormat.WAVEFRONT_OBJ().

STL formāts

MethodsMethods
StlImporterIekšējais importētājs, kas lasa gan bināros, gan ASCII STL failus. Automātiski izvēlēts pēc paplašinājuma.
StlExporterIekšējais eksportētājs, kas raksta STL.
StlLoadOptionsIelādes iespējas STL failiem. Atbalsta flip_coordinate_system un scale.
StlSaveOptionsSaglabāšanas iespējas STL izvadei. Kontrolē binary_mode, scale, un flip_coordinate_system.
StlFormatFormāta apraksts STL.

glTF formāts

MethodsMethods
GltfLoadOptionsIelādes iespējas glTF 2.0 un GLB failiem. Galvenā īpašība: flip_tex_coord_v.
GltfSaveOptionsSaglabāšanas iespējas glTF 2.0 izvadei. Izmantojiet binary_mode=True lai izveidotu pašpietiekamu GLB pakotni.
GltfFormatFormāta apraksts glTF 2.0 / GLB. Pieejams kā FileFormat.GLTF2().

FBX formāts

MethodsMethods
FbxLoadOptionsIelādes iespējas FBX failiem. Galvenās īpašības: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsSaglabāšanas iespējas FBX izvadei. Kontrolē saspiešanu, tekstūru iegulšanu un materiālu īpašības.
FbxFormatFormāta apraksts FBX. Pieejams kā FileFormat.FBX7400ASCII().

COLLADA formāts

MethodsMethods
ColladaLoadOptionsIelādes iespējas COLLADA (.dae) failiem. Kontrolē ass pārkartēšanu un vienību mērogu importēšanas laikā.
ColladaSaveOptionsSaglabāšanas iespējas COLLADA izvadei. Kontrolē indented, flip_coordinate_system, un materiālu eksportu.
ColladaFormatFormāta apraksts COLLADA. Automātiski noteikts no .dae faila paplašinājuma.

3MF Format

MethodsMethods
ThreeMfLoadOptionsIelādes iespējas 3MF (.3mf) faili.
ThreeMfSaveOptionsSaglabāt opcijas 3MF izvadei. 3MF ir vēlamais formāts 3D drukāšanas darbplūsmām.
ThreeMfFormatFormāta apraksts 3MF. Pieejams kā FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
TextureMappingIdentificē, kā tekstūra tiek kartēta uz ģeometrijas: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, utt.
BooleanOperationCSG Būla operācijas veids: UNION, DIFFERENCE, INTERSECTION.

Īpašību sistēma

MethodsMethods
PropertyViena nosaukta tipa īpašība uz A3DObject. Saglabā īpašības nosaukumu, tipa aprakstu un pašreizējo vērtību.
PropertyCollectionIterējama kolekcija no Property objekti, kas pievienoti A3DObject. Atbalsta meklēšanu pēc nosaukuma un iterāciju pār visām definētajām īpašībām.
CustomObjectViegls A3DObject apakšķirša klase, kas nes tikai nosaukumu un patvaļīgu PropertyCollection. Izmantots, lai saglabātu lietotāja definētus metadatus uz ainas objektiem.

Attēls un renderēšana

MethodsMethods
ImageRenderOptionsOpcijas programmatūras rasterizācijai, kad aina tiek renderēta 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ī

 Latviešu