Aspose.3D FOSS for Python

Odkaz API pro: Aspose-3d-foss 26.1.0 (Python 3.7 3.12, MIT licence).

Všechny třídy jsou dováženy z České republiky. aspose.threed balíček nebo jeho podbalíčky.:

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

Graf hlavní scény

TřídaPopis:
SceneKontejner nejvyšší úrovně pro všechny 3D daty scény. Skládá kořenový uzel, metadata aktiv a animační klipy. Exponuje from_file(), open(),a) save() jako primární vstupní body I/O.
NodeJmenovaný uzel v hierarchii scény. Vlastní seznam dětských uzlů a seznam připojených Entity Objekty, jako jsou okovy, kamery a světla. Transform.
EntityAbstraktní základní třída pro všechny objekty, které mohou být připojeny k Node.Poskytuje jméno a identitu, ale žádnou vlastní geometrii.
SceneObjectZákladní třída sdílená: Node a) Entity.Poskytuje rozhraní pro sběr vlastností používané pro uživatelsky definované metadata.
A3DObjectRoot base class pro všechny objekty Aspose.3D. Vystavuje vlastnost název a funkci “root” (základní) pro všechna řízená objekta v 3D, která jsou součástí aplikace APPO3D . Properties Sbírka.
INamedObjectRozhraní, které zaručuje: name Provozuje: Node, Entity, a několik typů deskriptoru specifických pro formát.

Geometrie a síťová trubka

TřídaPopis:
MeshVěc s mnohonásobným okem. Uložení kontrolních bodů (pozice vrcholu jako Vector4), seznamy polygonů (seznamy kontrolních bodových indexů) a vrstvy vrcholkových prvků (normální, UV, barvy vertexů).
GeometryAbstraktní základ pro typy geometrie podobné sítím. Definuje rozsah kontrolních bodů a sbírku VertexElement vrstvy. Mesh dědictví z: Geometry.
VertexElementAbstraktní základ pro datovou vrstvu připojenou k geometrii (normální hodnoty, UV záření, barvy atd.). mapping_mode, reference_mode,a) data Seznam.
VertexElementNormalUložení jednoho normálního vektora na vrchol nebo uhol mnohonohého úhlu, v závislosti na: mapping_mode.Hodnoty údajů jsou: FVector4 příklady (jednotlivá přesnost) s w nepoužívané.
VertexElementUVUložení dat o texturních souřadnicích jako: FVector4 na vrchol nebo roh mnohonásobku (pouze x a) y Ošivka může mít pro různé texturační kanály více vrstv UV.
VertexElementVertexColorUložení barevných dat RGBA na vrchol nebo roh jako: FVector4 (r, g, b, a v rozmezí 01).
VertexElementSmoothingGroupUložení ID celých čísel pro polygonové vyrovnávací skupiny, které používá dovozce OBJ k reprodukci původních přidělení skupin vyrovnání ze zdrojového souboru.
VertexElementTypeSeznam, který identifikuje sémantickou roli vrcholu prvku vrstvy: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, a další. Přeneste hodnoty na Mesh.get_element().
MappingModeZpočetní kontrola, která primitivní hodnota prvku vrcholu se odkazuje na: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,nebo: ALL_SAME.
ReferenceModeVypočet, který kontroluje indexování hodnot: DIRECT (jedna hodnota na jednu primitivní mapu) nebo INDEX_TO_DIRECT (složka hodnot plus samostatná indexační složka).
PolygonModifierKlasifikace statické užitkové služby s metodami pro triangulaci Mesh předměty a celé Scene grafy.

Transformace a prostorová tvorba

TřídaPopis:
TransformMístní přeměna připojená k Node.Poskytuje překlad, rotaci (jako Quaternion), a složky měřítka, plus výhodné vlastnosti pro Eulerovy úhly.
GlobalTransformPřečtený zobrazení transformace světového prostoru uzlu po složení všech předků. Přístup prostřednictvím Node.global_transform.
AssetInfoMetadata připojená k datovému bloku. Scene.Uložení názvu autorské aplikace, jména jednotky, faktor jednotkové stupnice, definice osy souřadnicového systému a časové razítko vytvoření/modifikace.

Materiály a odstínění

TřídaPopis:
MaterialAbstraktní základní třída pro všechny typy materiálů. Poskytuje název a soubor vlastností numerických a barevných parametrů.
LambertMaterialModel materiálu pouze pro difúzní použití: ukládá okolní barvu, difuzní barevnost, emitující barvy a průhlednost. Nabízen z OBJ souborů s použitím základních funkcí Ka/Kd/Ke prohlášení.
PhongMaterialRozsah: LambertMaterial Skládané z souborů OBJ, které používají Ks/Ns prohlášení.
PbrMaterialFyzicky založený materiál pro renderowanie. Uložení albedo, kovového faktoru, surovosti a souvisejících textur. Používá se v formátu glTF 2.0 a dalších formátech s možností PBR.

Kamera a osvětlení

TřídaPopis:
CameraKamera je jen… projection_type a) name jsou funkční v tomto vydání; všechny ostatní číselné vlastnosti (near_plane, far_plane, field_of_view, aspect_ratio) jsou stuby, které vracejí standardní hodnoty. Node Pro definici perspektivních transformací.
LightEntita světelného zdroje, dědictví od Camera jako třída stubů; Light Sama třída nevysvětluje v tomto znění žádné další vlastnosti.
LightTypeSeznam podporovaných kategorií světla: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeSeznam režimů projekce fotoaparátu: PERSPECTIVE a) ORTHOGRAPHIC.

Matematické nástroje

TřídaPopis:
Vector2Dvojitě přesný dvojkomponentový vektor (x, y) Používá se pro koordináty UV textury.
Vector3Dvojité přesnosti 3-komponentový vektor (x, y, z). Používá se pro pozice, směry a měřítko.
Vector4Dvojité přesnosti 4 komponent vector (x, y, z, w) Používá se pro kontrolní body (homogenní pozice) a normální údaje.
FVector2Jednopřesný dvojkomponentový float vektor, interně používaný pro kompaktní ukládání v souborech dat o vrcholových prvcích.
FVector3Jednopřesný 3-komponentový float vektor. Objevuje se v souborech dat o vrcholových prvcích pro normály a tangenty.
FVector4Jednopřesný čtyřkomponentový plovoucí vektor. VertexElementFVector.data.
QuaternionJednotka kvaternionu pro zobrazování rotací (w, x, y, z) Používá: Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxOmezující pole uspořádané na ose definované tímto: minimum a) maximum Česká republikaVector3 Používají se pro prostorové dotazy a pomocné při odstraňování frustum.

Animování

TřídaPopis:
AnimationClipJmenovaný kontejner pro soubor animovaných kanálů pokrývajících jeden rozsah přehrávání. A Scene může držet více kliků (např. “Walk”, “Run”).
AnimationNodeVázání a AnimationClip Působí jako most mezi daty klipů a objekty grafu scény.
AnimationChannelJediný animovaný proud vlastností v rámci klipu, zaměřený na jmenovanou vlastnost objektu (např., Transform.translation.x).
KeyFrameJediný časový vzork v rámci jednoho času. KeyframeSequence.Uložení času (v sekundách) a hodnoty v daném okamžiku.
KeyframeSequencePořadový seznam: KeyFrame objekty pro jeden skalární kanál spolu s nastavením interpolace a extrapolaci.
InterpolationZpočet režimů interpolace mezi klíčovými rámy: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeSeznam chování mimo první a poslední klíčový rámec: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

Formát V/V

SymbolPopis:
Scene.from_file(path)Statická metoda. Otevře soubor na adrese: path, detekuje formát z rozšíření a vrací vyplněný Scene.Zvyšuje se ve formátu souborů, které nejsou nalezeny nebo nepodporovány.
Scene.open(path, options=None)Metodou instance. Otevře soubor do existujícího systému Scene příklad, případně pomocí formátu specifické LoadOptions Podtřída.
Scene.save(path, options=None)Příkladová metoda. Serializace scény na path Použití formátu odvodeného z rozšíření, případně použití specifického pro daný formát SaveOptions Podtřída.
FileFormatRegistrace podporovaných formátů souborů. Obsahuje položky jako: FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF.Přístup k variantám specifickým pro formát je možné prostřednictvím tříd možností (např., ColladaSaveOptions, GltfSaveOptions).
IOServiceVnitřní abstrakce I/O používaná formátem dovozci a vývozci. Obvykle se nepoužívá přímo aplikačním kódem.
LoadOptionsZákladní třída pro všechny objekty s možnostmi načítání specifickými pro formát. Podtřídění: ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsZákladní třída pro všechny objekty speciálnímu formátu s možnostmi ukládání. Podtřídění: ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

Formát OBJ

TřídaPopis:
ObjImporterVnitřní importérská třída, která analyzuje soubory Wavefront OBJ a MTL. Automaticky vyvolána pomocí Scene.from_file() pro: .obj prodloužení.
ObjLoadOptionsMožnosti načítání Wavefront OBJ souborů.: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsZachování možností pro výstup Wavefront OBJ. Ovládá normály, UV záření, odkazy na materiály a bodový režim cloudu.
ObjFormatDeskriptor formátu pro Wavefront OBJ. Přístupný jako FileFormat.WAVEFRONT_OBJ().

Formát STL

TřídaPopis:
StlImporterInterní dovozce, který čte jak binární soubory tak ASCII STL. Výběr automaticky rozšířením.
StlExporterVnitřní vývozce, který se píše STL.
StlLoadOptionsMožnosti načítání pro soubory STL. Podpora flip_coordinate_system a) scale.
StlSaveOptionsZachování možností pro výstup STL. Ovládací prvky binary_mode, scale,a) flip_coordinate_system.
StlFormatDeskriptor formátu pro STL.

Formát glTF

TřídaPopis:
GltfLoadOptionsMožnosti načítání souborů glTF 2.0 a GLB. Klíčová vlastnost: flip_tex_coord_v.
GltfSaveOptionsZachování možností pro výstup GLTF 2.0. Použití binary_mode=True pro samostatný balíček GLB.
GltfFormatDeskriptor formátu pro glTF 2.0 / GLB. Přístupný jako: FileFormat.GLTF2().

Formát FBX

TřídaPopis:
FbxLoadOptionsMožnosti načítání souborů FBX. Klíčové vlastnosti: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsZachovat možnosti pro výstup FBX. FBx export zvyšuje NotImplementedError bezpodmínečně; FbxSaveOptions existuje, ale vývoz není realizován.
FbxFormatDeskriptor formátu pro FBX. Přístupný jako FileFormat.FBX7400ASCII().

COLLADA Formát

TřídaPopis:
ColladaLoadOptionsMožnosti zatížení pro COLLADA (.daeKontrolní úprava osy a jednotková míra při dovozu.
ColladaSaveOptionsZachování možností pro COLLADA výstup. Ovládací prvky indented, flip_coordinate_system, a vývozu materiálů.
ColladaFormatDeskriptor formátu pro COLLADA. Automaticky vyřešen z .dae Rozšíření souboru.

3MF Format

TřídaPopis:
ThreeMfLoadOptionsMožnosti zatížení pro 3MF (.3mf) soubory.
ThreeMfSaveOptionsMožnosti ukládání pro výstup 3MF. 3 MF je preferovaný formát pro pracovní toky tisků 3D.
ThreeMfFormatDeskriptor formátu pro 3MF. Přístupný jako: FileFormat.MICROSOFT_3MF_FORMAT().

Číslování

Číslo a početPopis:
TextureMappingIdentifikuje, jak je textura mapována do geometrie: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, atd.
BooleanOperationCSG Typ booleánního provozu: UNION, DIFFERENCE, INTERSECTION.

Systém vlastností

TřídaPopis:
PropertyJediná pojmenovaná typová vlastnost na A3DObject.Uložení jména vlastností, deskriptor typu a aktuální hodnota.
PropertyCollectionNeúprosný sběr: Property předměty připojené k A3DObject.Podporuje vyhledávání podle jména a iterování všech definovaných vlastností.
CustomObjectLehký. A3DObject Podtřída, která nese pouze název a svévolný kód. PropertyCollection.Používá se k ukládání uživatelsky definovaných metadát na objekty scény.

Obraz a zobrazení

TřídaPopis:
ImageRenderOptionsMožnosti pro rasterizování softwaru při renderu scény do obrazového bufera. Uložení barvy pozadí, rozměry obrazu a odkazu kamery. Scene.render() zvýšení NotImplementedError; rendering není implementován v tomto vydání.

Viz také:

 Čeština