Aspose.3D FOSS for Python

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

Všechny třídy jsou importovány z aspose.threed balíčku nebo jeho podbalíčků. Kořenový import je:

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

Jádrový graf scény

MethodsMethods
SceneKontejner nejvyšší úrovně pro všechna 3D data scény. Uchovává kořenový uzel, metadata aktiv a animační klipy. Poskytuje from_file(), open(), a save() jako hlavní vstupní/výstupní body.
NodePojmenovaný uzel v hierarchii scény. Obsahuje seznam podřízených uzlů 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á 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 the Properties kolekce.
INamedObjectRozhraní, které zaručuje name vlastnost. Implementováno v Node, Entity, a několik formátově specifických typů deskriptorů.

Geometrie a síť

MethodsMethods
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áklad pro datovou vrstvu připojenou k geometrii (normály, UV, barvy atd.). Nese mapping_mode, reference_mode, a data seznam.
VertexElementNormalUkládá jeden normálový vektor na vrchol nebo na roh polygonu, v závislosti na mapping_mode. Hodnoty dat jsou FVector4 instance (jednoduchá přesnost) s w nepoužité.
VertexElementUVUkládá data texturovacích souřadnic jako FVector4 na vrchol nebo na roh polygonu (pouze x a y komponenty jsou použity pro UV). Síť může nést více UV vrstev pro různé texturové kanály.
VertexElementVertexColorUkládá data barvy RGBA na úrovni vrcholu (per-vertex) nebo rohu (per-corner) jako FVector4 (r, g, b, a v rozsahu 0–1).
VertexElementSmoothingGroupUkládá celočíselná ID skupin vyhlazování per-polygon, která importér OBJ používá k reprodukci původních přiřazení skupin vyhlazování ze zdrojového souboru.
VertexElementTypeVýčet identifikující sémantickou roli vrstvy elementu vrcholu: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, a další. Předávejte hodnoty do Mesh.get_element().
MappingModeVýčtový typ řídící, ke kterému primitivu se hodnota vrcholového elementu mapuje: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, nebo ALL_SAME.
ReferenceModeVýčtový typ řídící, jak jsou hodnoty indexovány: DIRECT (jedna hodnota na mapovací primitivum) nebo INDEX_TO_DIRECT (pole hodnot plus samostatné pole indexů).
PolygonModifierStatická pomocná třída s metodami pro triangulaci Mesh objektů a celých Scene grafů.

Transformace a prostorové

MethodsMethods
TransformLokální transformace připojená k Node. Poskytuje translaci, rotaci (jako Quaternion), a komponenty měřítka, plus pohodlné vlastnosti pro Eulerovy úhly.
GlobalTransformRead‑only pohled na transformaci uzlu ve světovém prostoru po složení všech transformací předků. Přístupné přes Node.global_transform.
AssetInfoMetadata blok 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í

MethodsMethods
MaterialAbstraktní základní třída pro všechny typy materiálů. Poskytuje název a kolekci vlastností pro číselné a barevné parametry.
LambertMaterialMateriálový model pouze s difúzním osvětlením. Ukládá ambientní barvu, difúzní barvu, emisní barvu a průhlednost. Načítá se z OBJ souborů, které používají základní Ka/Kd/Ke deklarace.
PhongMaterialMethods LambertMaterial s odleskovou barvou a leskem (speculární exponent). Načítá se z OBJ souborů, které používají Ks/Ns deklarace.
PbrMaterialMateriál založený na fyzikálně založeném renderování. Ukládá albedo, kovový faktor, faktor drsnosti a související textury. Používá se v glTF 2.0 a dalších formátech podporujících PBR.

Kamera a osvětlení

MethodsMethods
CameraEntita kamery. Pouze projection_type a name jsou v této edici funkční; všechny ostatní číselné vlastnosti (near_plane, far_plane, field_of_view, aspect_ratio) jsou zástupné funkce, které vrací výchozí hodnoty. Připojeno k Node pro definování transformací pohledu.
LightEntita světelného zdroje. Dědí z Camera jako zástupné třídy; Light třída sama o sobě v tomto vydání neuvádí žádné další vlastnosti.
LightTypeVýčet podporovaných kategorií světel: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeVýčet režimů projekce kamery: PERSPECTIVE a ORTHOGRAPHIC.

Matematické utility

MethodsMethods
Vector2Dvojitá přesnost 2‑komponentový vektor (x, y).
Vector3Dvojitá přesnost 3‑komponentový vektor (x, y, z).
Vector4Vektor se čtyřmi komponentami s dvojitou přesností (x, y, z, w). Používá se pro řídicí body (homogenní pozice) a data normál.
FVector2Jednopřesnostní 2-komponentový float vektor. Používá se interně pro kompaktní ukládání v polích dat elementů vrcholů.
FVector3Jednopřesnostní 3-komponentový float vektor. Objevuje se v polích dat elementů vrcholů pro normály a tangenty.
FVector4Jednopřesnostní 4‑komponentový float vektor. Typ úložiště pro VertexElementFVector.data.
QuaternionJednotkový kvaternion pro reprezentaci rotací (w, x, y, z) Používá se v Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxOsově zarovnaná ohraničující krabice definovaná minimum a maximum Vector3 rohy. Používá se pro prostorové dotazy a pomocníky pro ořezávání frustru.

Methods

MethodsMethods
AnimationClipPojmenovaný kontejner pro sadu animovaných kanálů pokrývajících jeden přehrávací rozsah. Scene může obsahovat více klipů (např. „Walk“, „Run“).
AnimationNodeVáže AnimationClip k určitému uzlu scény nebo vlastnosti. Funguje jako most mezi daty klipu a objekty grafu scény.
AnimationChannelJednotlivý animovaný proud vlastnosti v rámci klipu, cílící na pojmenovanou vlastnost objektu (např., Transform.translation.x).
KeyFrameJednotlivý čas‑hodnotový vzorek v rámci KeyframeSequence. Ukládá čas (v sekundách) a hodnotu v tomto čase.
KeyframeSequenceUspořádaný seznam KeyFrame objektů pro jeden skalární kanál, spolu s nastavením interpolace a extrapolace.
InterpolationVýčet režimů interpolace mezi klíčovými snímky: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeVýčet chování mimo první a poslední klíčový snímek: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

Formát I/O

MethodsMethods
Scene.from_file(path)Statická metoda. Otevírá soubor na path, zjistí 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=None)Metoda instance. Otevře soubor do existující Scene instance, volitelně pomocí formátově specifické LoadOptions podtřídy.
Scene.save(path, options=None)Metoda instance. Serializuje scénu do path používá formát odvozený z přípony, volitelně pomocí formátově specifické SaveOptions podtřídy.
FileFormatRegistr podporovaných formátů souborů. Obsahuje položky jako FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF. Varianty specifické pro formát jsou přístupné přes třídy možností (např., ColladaSaveOptions, GltfSaveOptions).
IOServiceInterní abstrakce I/O používaná importéry a exportéry formátů. Obvykle není používána přímo aplikačním kódem.
LoadOptionsZákladní třída pro všechny objekty možností načítání specifické pro formát. Děděna třídou ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsZákladní třída pro všechny objekty možností ukládání specifické pro formát. Děděna třídou ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

Formát OBJ

MethodsMethods
ObjImporterInterní třída importéru, která parsuje soubory Wavefront OBJ a MTL. Automaticky volána Scene.from_file() pro .obj přípony.
ObjLoadOptionsMožnosti načítání pro soubory Wavefront OBJ. Klíčové vlastnosti: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsUložit možnosti 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

MethodsMethods
StlImporterInterní importér, který čte jak binární, tak ASCII soubory STL. Vybráno automaticky podle přípony.
StlExporterInterní exportér, který zapisuje STL.
StlLoadOptionsMožnosti načítání pro soubory STL. Podporuje flip_coordinate_system a scale.
StlSaveOptionsMožnosti ukládání pro výstup STL. Ovládá binary_mode, scale, a flip_coordinate_system.
StlFormatPopis formátu pro STL.

Formát glTF

MethodsMethods
GltfLoadOptionsMožnosti načítání pro soubory glTF 2.0 a GLB. Klíčová vlastnost: flip_tex_coord_v.
GltfSaveOptionsMožnosti ukládání pro výstup glTF 2.0. Použijte binary_mode=True pro samostatný balíček GLB.
GltfFormatPopis formátu pro glTF 2.0 / GLB. Přístupný jako FileFormat.GLTF2().

Formát FBX

MethodsMethods
FbxLoadOptionsMožnosti načítání pro soubory FBX. Klíčové vlastnosti: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsMožnosti ukládání pro výstup FBX. Export FBX vyvolá NotImplementedError bezpodmínečně; FbxSaveOptions existuje, ale export není implementován.
FbxFormatPopis formátu pro FBX. Přístupný jako FileFormat.FBX7400ASCII().

Formát COLLADA

MethodsMethods
ColladaLoadOptionsMožnosti načítání pro COLLADA (.dae) soubory. Ovládá přemapování os a měřítko jednotek při importu.
ColladaSaveOptionsUložit možnosti pro výstup COLLADA. Ovládací prvky indented, flip_coordinate_system, a export materiálů.
ColladaFormatPopis formátu pro COLLADA. Automaticky rozpoznáno z .dae přípony souboru.

3MF Format

MethodsMethods
ThreeMfLoadOptionsNačíst možnosti pro 3MF (.3mf) soubory.
ThreeMfSaveOptionsUložit možnosti pro výstup 3MF. 3MF je preferovaný formát pro workflow 3D tisku.
ThreeMfFormatPopis formátu pro 3MF. Přístupný jako FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
TextureMappingUrčuje, jak je textura mapována na geometrii: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, atd.
BooleanOperationTyp Booleovské operace CSG: UNION, DIFFERENCE, INTERSECTION.

Systém vlastností

MethodsMethods
PropertyJedna pojmenovaná typová vlastnost na A3DObject. Ukládá název vlastnosti, popis typu a aktuální hodnotu.
PropertyCollectionIterovatelná kolekce Property objektů připojených 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í

MethodsMethods
ImageRenderOptionsMožnosti softwarové rasterizace při vykreslování scény do obrazového bufferu. Ukládá barvu pozadí, rozměry obrázku a referenci kamery. Scene.render() vyvolává NotImplementedError; vykreslování není v tomto vydání implementováno.

Viz také

 Čeština