Aspose.3D FOSS for Python

Referència API per a: aspose-3d-foss 26.1.0 (Python 3.7 3.12, llicència MIT).

Totes les classes són importades des de la República Federal d’Austràlia. aspose.threed El paquet o els seus subpaquets. La importació original és:

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

Grau de la escena principal

Classe	Descripció
`Scene`	Contenidor de primer nivell per a totes les dades de la escena 3D. Conté el node raí, metadades d’actius i clips d ‘animació. Exponen `from_file()`, `open()`, i `save()` com a punts d’entrada i sortida primaris.
`Node`	Un nod nomenat en la jerarquia de l’escena. Poseix una llista de nodes fills i una lista d’apostos `Entity` Els objectes com ara màxines, càmeres i llums. `Transform`.
`Entity`	Clase de base abstracta per a tots els objectes que es poden fixar a un `Node`.Proporciona nom i identitat però no té geometria pròpia.
`SceneObject`	Classe base compartida per: `Node` i de la `Entity`.Proporciona la interfície de recopilació de propietats utilitzada per a metadades definides per l’usuari.
`A3DObject`	Classe base de raí per a tots els objectes gestionats en Aspose.3D. Exposen la propietat nom i el nombre d’objectes que han estat administrats. `Properties` col·lecció.
`INamedObject`	Interfície que garanteix una `name` Propriedat. Implementada per: `Node`, `Entity`, i diversos tipus de descriptors específics per a formats.

Geometria i malla

Classe	Descripció
`Mesh`	Entitat de malla poligonal. Almacena punts de control (posicions del vèrtex com a `Vector4`), llistes de cares dels polígons (listes d’índex del punt de control) i capes d"elements verticals (normales, UVs, colors de vèrtex).
`Geometry`	Base abstracta per a tipus de geometria similar a les mescles. Defineix l’array de punts de control i la col·lecció d’arxius de punt de comanda, amb un valor total de 10 × 100 mm. `VertexElement` capes. `Mesh` hereta de `Geometry`.
`VertexElement`	Base abstracta per a una capa de dades adjunta a la geometria (normales, UVs, colors, etc.). `mapping_mode`, `reference_mode`, i a `data` llista.
`VertexElementNormal`	Emmagatzemen un vector normal per vèrtex o per cantó de polígon, depenent del que sigui el punt d’ús. `mapping_mode`.Els valors de dades són: `FVector4` instàncies (món-precisió) amb `w` no utilitzat.
`VertexElementUV`	Emmagatzemar dades de coordenades de textura com a: `FVector4` per vèrtex o per cantó de polígon (només `x` i de la `y` Una malla pot portar múltiples capes de UV per a diferents canals de textura.
`VertexElementVertexColor`	Amortiza dades de color per vèrtex o per cantó RGBA com: `FVector4` (r, g, b, a en el rang 01).
`VertexElementSmoothingGroup`	Emmagatzemar IDs de nombres enters per grup d’al·lisament per polígon, utilitzats pel importador OBJ per reproduir les assignatures originals del grup al·lissament des del fitxer font.
`VertexElementType`	Enumeració que identifica el paper semàntic d’una capa de elements del vèrtex: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, i altres. Passar valors a `Mesh.get_element()`.
`MappingMode`	Enumeració que controla quin primitivo un valor de vertex d’element correspon a: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, o `ALL_SAME`.
`ReferenceMode`	Enumeració que controla com s’indexen els valors: `DIRECT` (un valor per primitiva de mapeig) o `INDEX_TO_DIRECT` (array de valors més un array d’índex separats).
`PolygonModifier`	Clase d’utilitat estàtica amb mètodes de triangulació `Mesh` objectes i tota la `Scene` grafics.

Transformació i espacial.

Classe	Descripció
`Transform`	Transformació local adjunta a una empresa de transformació. `Node`.• Translació, rotació (com a `Quaternion`), i components d’escala, més propietats de conveniència per als angles d"Euler.
`GlobalTransform`	Vista de lectura única de la transformació d’un nod en l’espai mundial després de compondre totes les transformacions ancestrals. Accés a través del canal Web: http://www.crowd-review.com/index.php?id=3146184 `Node.global_transform`.
`AssetInfo`	Bloc de metadades adjunt a un bloc d’informació. `Scene`.Emmagatzemen el nom de l’aplicació autor, el nombre d’unitat, factor d ’escala unitària, definicions dels eixos del sistema de coordenades i timestamps de creació/modificació.

Materials i ombres

Classe	Descripció
`Material`	Classe de base abstracta per a tots els tipus de materials. Proporciona un nom i una col·lecció de propietats per als paràmetres numèrics i color.
`LambertMaterial`	Modell de material difús únicament. Almacena color ambient, color difós, colors emissius i transparència. Carregat des dels arxius OBJ que utilitzen bases bàsiques `Ka`/`Kd`/`Ke` declaracions.
`PhongMaterial`	Extensos `LambertMaterial` Carregat des dels arxius OBJ que utilitzen el sistema de correcció d’objectes. `Ks`/`Ns` declaracions.
`PbrMaterial`	Material de renderizació basat en física. Almacena albedo, factor metàl·lic, factors d’arrogància i textures associades. Utilitzat per glTF 2.0 i altres formats compatibles amb PBR.

Camara i il·luminació

Classe	Descripció
`Camera`	Unitat de càmera. `projection_type` i de la `name` són funcionals en aquesta edició; totes les altres propietats numèriques (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) són estocs que retornen valors predeterminats. `Node` per definir la transformació de punt de vista.
`Light`	Entitat de font luminosa. `Camera` com a classe de stub; el `Light` la classe en si mateixa no exposa propietats addicionals en aquesta publicació.
`LightType`	Enumeració de les categories de llum suportades: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Enumeració dels modes de projecció de la càmera: `PERSPECTIVE` i de la `ORTHOGRAPHIC`.

Utilitats de matemàtiques

Classe	Descripció
`Vector2`	Vector de doble precisió amb dos components (`x`, `y`) Utilitzat per a les coordenades de textura UV.
`Vector3`	Vector de doble precisió amb 3 components (`x`, `y`, `z`). Utilitzat per a posicions, direccions i escala.
`Vector4`	Vector de doble precisió amb 4 components (`x`, `y`, `z`, `w`) Utilitzat per als punts de control (posicions homogènies) i dades normals.
`FVector2`	Vector flotador de precisió única amb dos components. Utilitzat internament per a l’emmagatzematge compacte en matrius de dades d’elements verticals.
`FVector3`	Vector flotador de tres components d’una precisió única. Apareix en matrius de dades dels elements del vèrtex per a normals i tangents.
`FVector4`	Vector flotador de 4 components d’una sola precisió. `VertexElementFVector.data`.
`Quaternion`	Unitat de quaterni per a la representació de rotacions (`w`, `x`, `y`, `z`) Utilitzats per: `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Casella delimitació alineada a l’eix definida per: `minimum` i de la `maximum` El dia de la mort.`Vector3` Utilitzats per a consultes espacials i ajudants de frustum.

Animation (animació)

Classe	Descripció
`AnimationClip`	Contenidor nomenat per a un conjunt de canals animats que cobreixen una gamma de reproducció. A `Scene` pot contenir múltiples pinces (per exemple, “Caminar”, “Correr”).
`AnimationNode`	Enllaços i `AnimationClip` Actúa com el pont entre les dades de la escena i els objectes del gràfic d’escena.
`AnimationChannel`	Un únic flux de propietats animades dins d’un clip, dirigit a una propietat nomenada en un objecte (per exemple,., `Transform.translation.x`).
`KeyFrame`	Una mostra de valor en un sol moment dins d’un grup. `KeyframeSequence`.Emmagatzemar el temps (en segons) i el valor en aquell moment.
`KeyframeSequence`	Una llista ordenada de: `KeyFrame` objectes per a un canal escalar, juntament amb configuracions d’interpolació i extrapolación.
`Interpolation`	Enumeració de modes d’interpolació entre quadres clau: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Enumeració de comportaments més enllà del primer i últim quadre clau: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Format d’entrada i sortida

Símbol	Descripció
`Scene.from_file(path)`	Metode estàtic. Obre el fitxer en `path`, detecta el format de l’extensió, i torna un omplert `Scene`. S’eleva en format de fitxer no trobat o sense suport.
`Scene.open(path, options=None)`	Metode d’instància. Obre un fitxer en una instància existent `Scene` instància, opcionalment utilitzant un format específic de la pàgina web. `LoadOptions` subclasse.
`Scene.save(path, options=None)`	Mètode d’instància. Serialitza la escena a `path` utilitzant el format inferit de l’extensió, opcionalment usant un format específic. `SaveOptions` subclasse.
`FileFormat`	Registre de formats de fitxer suportats. Conté entrades com ara: `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`.Les variants específiques del format s’acessaran a través de classes d’opció (per exemple,., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Abstracció interna d’E/S utilitzada pels importadors i exportadors de format. Normalment no s’utilitza directament pel codi de l’aplicació.
`LoadOptions`	Classe base per a tots els objectes d’opció de càrrega específics del format. Subclassificada pel `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Clasa base per a tots els objectes d’opció de guarda específics del format. Subclassificada per `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Format OBJ

Classe	Descripció
`ObjImporter`	Clase d’importador intern que analisa els arxius Wavefront OBJ i MTL. Invocat automàticament per `Scene.from_file()` per a: `.obj` extensions.
`ObjLoadOptions`	Opcions de càrrega per als arxius Wavefront OBJ. Propietats clau: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Salva opcions per a la sortida de Wavefront OBJ. Controla normales, UVs, referències de materials i mode núvol puntal.
`ObjFormat`	Descriptor de format per a Wavefront OBJ. Accessible com `FileFormat.WAVEFRONT_OBJ()`.

Format STL

Classe	Descripció
`StlImporter`	Importador intern que llegeix tant arxius STL binaris com ASCII. Seleccionat automàticament per extensió.
`StlExporter`	Exportador intern que escriu STL.
`StlLoadOptions`	Opcions de càrrega per a arxius STL. Suport `flip_coordinate_system` i de la `scale`.
`StlSaveOptions`	Salvar opcions per a la sortida STL. Controles `binary_mode`, `scale`, i `flip_coordinate_system`.
`StlFormat`	Descriptor de format per a STL.

Format glTF

Classe	Descripció
`GltfLoadOptions`	Opcions de càrrega per a fitxers glTF 2.0 i GLB.: `flip_tex_coord_v`.
`GltfSaveOptions`	Salvar opcions per a la sortida de glTF 2.0. `binary_mode=True` per a un paquet de GLB independent.
`GltfFormat`	Descriptor de format per a glTF 2.0 / GLB. Accessible com: `FileFormat.GLTF2()`.

Format FBX

Classe	Descripció
`FbxLoadOptions`	Opcions de càrrega per a arxius FBX. Propietats clau: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Salvar opcions per a la sortida FBX. `NotImplementedError` incondicionalment; `FbxSaveOptions` Existeix però no s’efectua l’exportació.
`FbxFormat`	Descriptor de format per FBX. Accessible com a `FileFormat.FBX7400ASCII()`.

COLLADA Format

Classe	Descripció
`ColladaLoadOptions`	Opcions de càrrega per a COLLADA (`.dae`Controla el reencàrrec dels eixos i l’escala de les unitats en la importació.
`ColladaSaveOptions`	Salvar opcions per a la sortida COLLADA. Controles `indented`, `flip_coordinate_system`, i exportació de materials.
`ColladaFormat`	Descriptor de format per a COLLADA. Resolut automàticament des del `.dae` extensió de fitxer.

3MF Format

Classe	Descripció
`ThreeMfLoadOptions`	Opcions de càrrega per 3MF (`.3mf`) arxius.
`ThreeMfSaveOptions`	Opcions d’emmagatzematge per a la sortida 3MF. 3 MF és el format preferit per als fluxos de treball dimpressió en 3D.
`ThreeMfFormat`	Descriptor de format per a 3MF. Accessible com: `FileFormat.MICROSOFT_3MF_FORMAT()`.

Enumeracions

Enumeració	Descripció
`TextureMapping`	Identifica com es mapà una textura a la geometria: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, etc.
`BooleanOperation`	CSG Tipus d’operació booleana: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Sistema de propietats

Classe	Descripció
`Property`	Una propietat típica amb un sol nom en una `A3DObject`.Emmagatzemar el nom de la propietat, descriptor del tipus i valor actual.
`PropertyCollection`	Recopilació iterable de `Property` objectes adjuntats a un `A3DObject`.Suporta la recerca per nom i iteració sobre totes les propietats definides.
`CustomObject`	Un lleuger. `A3DObject` Subclasse que només porta un nom i una arbitrària `PropertyCollection`.Utilitzat per emmagatzemar metadades definides per l’usuari sobre objectes de escena.

Imatge i renderi

Classe	Descripció
`ImageRenderOptions`	Opcions per a la rasterització de programari quan es retrata una escena en un buffer d’imatge. Almacena el color del fons, les dimensions de l’image i la referència de la càmera. `Scene.render()` augmentacions `NotImplementedError`; el renderi no s’implementa en aquesta versió.