Aspose.3D FOSS for Python

API-reference for: Aspose-3d-foss 26.1.0 (Python 3.7 3.12, MIT-licens).

Alle klasser importeres fra de Forenede Stater. aspose.threed pakke eller underpakker heraf.:

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

Grafik af kernen

KlasseBeskrivelse:
SceneTop-level container for alle 3D scene data. Hold den rodnode, aktiv metadata og animation klippene. Exposes from_file(), open(), og save() som de primære indgangs-/udgangspunkter.
NodeEn navngivet knude i scenen hierarki. Ejer en liste over barnknuder og en listag af vedhæftede Entity Det er et vigtigt element i en række af de forskellige former for teknologi, der anvendes til at skabe nye og mere effektive systemer. Transform.
EntityAbstrakt basisklasse for alle objekter, der kan vedhæftes en Node.Det giver navn og identitet, men ingen egen geometri.
SceneObjectBaseklasse delt af: Node og: Entity. Tilvejebringer den interfacet til indsamling af egenskaber, der anvendes for brugerdefinerede metadata.
A3DObjectRoot-basisklasse for alle Aspose.3D administrerede objekter. Forklarer navnegenskaberne og den Properties Samling.
INamedObjectInterface, der garanterer en name Indførelse af: Node, Entity, og flere format-specifikke beskrivelsestyper.

Geometri og net

KlasseBeskrivelse:
MeshPolygonmesseenhed: gemmer kontrolpunkter (vertexpositioner som Vector4), polygon-ansiktslister (lister over kontrolpunktindekser) og vertexelementlagre (normale, UV’er, vertexfarver).
GeometryDefinerer kontrolpunktsarret og samlingen af VertexElement lag. Mesh arve fra Geometry.
VertexElementAbstrakt basis for et dataslag knyttet til geometri (normale, UV-lys, farver osv.). mapping_mode, reference_mode, og en data - Det er en liste.
VertexElementNormalLagrer en normal vektor pr. vinkel eller per polygon hjørne, afhængigt af: mapping_mode.Dataværdierne er: FVector4 Eksempler (enlig præcision) med: w Ubrugt.
VertexElementUVGemmer teksturkoordinatdata som: FVector4 per vinkel eller hvert polygon hjørne (kun x og: y Et mask kan bære flere UV-lag for forskellige teksturkanaler.
VertexElementVertexColorLagrer farvedata pr. hjørne eller per vinkel som: FVector4 (r, g, b, a i intervallet 01).
VertexElementSmoothingGroupLagrer heltal-ID’er for hver polygon af glatningskreds, som anvendes af OBJ-importøren til at reproducere de oprindelige fordelinger af glødningsgrupper fra kildedatafilen.
VertexElementTypeEnsommering, der identificerer den semantiske rolle for et topelementlag: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, og andre. Mesh.get_element().
MappingModeEnumeration, der kontrollerer hvilken primitiv værdi et topelement viser til: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,eller ALL_SAME.
ReferenceModeEn oversigt, der kontrollerer indeksering af værdier: DIRECT (en værdi pr. kortlægningsprimitiv) eller INDEX_TO_DIRECT (værdier array plus en separat indeks array).
PolygonModifierStatisk nytteværdiklasse med metoder til triangulation Mesh og hele Scene grafiske data.

Transform og rumlig

KlasseBeskrivelse:
TransformLokal omdannelse vedlagt en Node.- giver oversættelse, rotation (som en del af den europæiske arbejdsmarkedspolitik) og Quaternion), og skalekomponenter plus bekvemmelige egenskaber for Eulers vinkler.
GlobalTransformKun læsevisning af en nodes verdensrumstransformation efter at have komponeret alle forfædre-transformationer. Tilgået via Node.global_transform.
AssetInfoMetadatablokken ved en Scene.Opbevarer ophavsmandens navn på ansøgningen, enhedenavn, skalafaktor for enheden, koordinatsystemeksisdefinitioner og tidsmærker for oprettelse/modifikation.

Materiale og skygge

KlasseBeskrivelse:
MaterialAbstrakt basisklasse for alle materialetyper. Giv et navn og en ejendomssamling til numeriske og farveparametre.
LambertMaterialKun diffus materiale model: lagrer omgivelsesfarve, diffuse farve og gennemsigtighed. indlæst fra OBJ-filer der bruger grundlæggende Ka/Kd/Ke erklæringer.
PhongMaterialUdvidelse LambertMaterial Det er en del af den europæiske industri, der har udviklet sig til at være et internationalt marked. Ks/Ns erklæringer.
PbrMaterialFysisk baseret renderingsmateriale. Lagrer albedo, metalfaktor, grovhedsfaktor og tilhørende teksturer. Bruges af glTF 2.0 og andre PBR-kompatible formater.

Kamera og belysning

KlasseBeskrivelse:
CameraKameraenhed. projection_type og: name er funktionelle i denne udgave; alle andre numeriske egenskaber (near_plane, far_plane, field_of_view, aspect_ratio) er stubs, der returnerer standardværdier. Node at definere synspunktstransformationer.
LightLyskilde-enhed. Arveligt fra Camera som en stub-klasse, og Light Klasse i sig selv udsætter ikke yderligere egenskaber i denne udgivelse.
LightTypeOplysninger om de understøttede lyskategorier: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeOpgørelse af kameraets projektionstilstande: PERSPECTIVE og: ORTHOGRAPHIC.

Matematiske værktøjer

KlasseBeskrivelse:
Vector2Dobbeltpræcision 2-komponentvektor (x, y) Bruges til at bestemme UV-strukturkoordinater.
Vector3Dobbeltpræcision 3-komponentvektor (x, y, z) Bruges til at angive positioner, retninger og skala.
Vector4Dobbeltpræcision 4-komponentvektor (x, y, z, w) Bruges til kontrolpunkter (homogene positioner) og normale data.
FVector2Enkelpræcision 2-komponent float vector. Bruges internt til kompakt lagring i vertex element datamater.
FVector3Enkelpræcision 3-komponent float vector. vises i vertex element datamater for normalværdier og tangenter.
FVector4En præcisions-flotator med 4 komponenter. VertexElementFVector.data.
QuaternionEnhederne for rotation (w, x, y, z) Bruges af: Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxAkselignet afgrænsende kasse defineret ved: minimum og: maximum ØvrigeVector3 Bruges til rumlige forespørgsler og frustum-bødningshjælpere.

Animation

KlasseBeskrivelse:
AnimationClipEn navngivet beholder for et sæt animerede kanaler, der dækker ét afspilningsområde. A Scene kan indeholde flere klippestykker (f.eks. “Gå”, “Løb”).
AnimationNodeBindes og AnimationClip Det fungerer som broen mellem klipdata og scenegrafobjekter.
AnimationChannelEn enkelt animeret ejendomsstrøm i et klip, der målretter en navngivet egenskab på et objekt (f.eks., Transform.translation.x).
KeyFrameEn enkelt tids-/værdssprøvning inden for en KeyframeSequence.Opbevarer tiden (i sekunder) og værdien på det pågældende tidspunkt.
KeyframeSequenceEn rækkefølge over: KeyFrame objekter for en skalarkanal sammen med interpolerings- og ekstrapoleringsanordninger.
InterpolationOplysninger om de forskellige typer af data, der er anvendt i forbindelse med en sådan analyse.: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeOplysninger om den samlede værdi af de pågældende data, der er registreret i en database.: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

Format I/O

SymbolerBeskrivelse:
Scene.from_file(path)Static metode. Åbner filen på: path, detekterer formatet fra udvidelsen og returnerer et udfyldt Scene.Opløser på fil-ikke-fundet eller ikke understøttet format.
Scene.open(path, options=None)Instance-metode. Åbner en fil i et eksisterende system Scene For eksempel kan du vælge at bruge et format-specifikt LoadOptions Underklasse.
Scene.save(path, options=None)Instansmetoden. Serialiserer scenen til path ved hjælp af det format, der er udledt fra udvidelsen, valgfrit ved brug af et formatspecifikt SaveOptions Underklasse.
FileFormatRegistret for understøttede filformater. Indeholder poster som fx: FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF.Format-specifikke varianter kan tilgås via opsjonsklasser (f.eks., ColladaSaveOptions, GltfSaveOptions).
IOServiceIntern ind- og udstrækning, som anvendes af formatimportører og eksportører.
LoadOptionsBasisklasse for alle format-specifikke indlæseoptionsobjekter. Underklasseret af ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsBasisklasse for alle format-specifikke opslagsalternativer. Underklassen er: ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

OBJ-format

KlasseBeskrivelse:
ObjImporterInterne importørklasser, der analyserer Wavefront OBJ- og MTL-filer. Automatisk indkaldt af Scene.from_file() for: .obj udvidelser.
ObjLoadOptionsOptioner til indlæsning af Wavefront OBJ-filer.: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsOptimering til Wavefront OBJ-udgang. Kontrollerer normal, UV, materialereferencer og point cloud mode.
ObjFormatFormatdeskriptor for Wavefront OBJ. Tilgængelig som: FileFormat.WAVEFRONT_OBJ().

STL-format

KlasseBeskrivelse:
StlImporterInterne importører, der læser både binære og ASCII STL-filer.
StlExporterIndenlandsk eksportør, der skriver STL.
StlLoadOptionsOptioner til indlæse af STL-filer. Støtter flip_coordinate_system og: scale.
StlSaveOptionsOptimer til STL-udgang. Kontroller binary_mode, scale, og flip_coordinate_system.
StlFormatFormatdeskriver for STL.

glTF-format

KlasseBeskrivelse:
GltfLoadOptionsLadeindstillinger for glTF 2.0 og GLB-filer.: flip_tex_coord_v.
GltfSaveOptionsOptioner til glTF 2.0 udgang. Brug binary_mode=True for en selvstændig GLB-pakke.
GltfFormatFormatdeskriver for glTF 2.0 / GLB. Tilgængelig som: FileFormat.GLTF2().

FBX-format

KlasseBeskrivelse:
FbxLoadOptionsLadeindstillinger for FBX-filer.: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsFBX-eksport stiger. NotImplementedError ubetinget.; FbxSaveOptions Det er ikke muligt at få en sådan løsning.
FbxFormatFormatdeskriver til FBX. Tilgængelig som: FileFormat.FBX7400ASCII().

COLLADA Format

KlasseBeskrivelse:
ColladaLoadOptionsLådeindstillinger for COLLADA (.daeKontrollerer omformning af akser og enhedsskala ved import.
ColladaSaveOptionsOptioner til COLLADA-udgang. Kontroller indented, flip_coordinate_system, og eksport af materialer.
ColladaFormatFormatdeskriptor for COLLADA. Automatisk løst fra .dae filforlængelse.

3MF Format

KlasseBeskrivelse:
ThreeMfLoadOptionsLådemodeller til 3MF (.3mf) filer.
ThreeMfSaveOptionsOptimering til 3MF-udgang. 3 MF er det foretrukne format for 3D-printingsarbejdsstrømme.
ThreeMfFormatFormatdeskriver for 3MF. Tilgængelig som: FileFormat.MICROSOFT_3MF_FORMAT().

Oplysninger om optegnelser

Oplysninger om opgørelseBeskrivelse:
TextureMappingIdentificerer, hvordan en tekstur er indrettet til geometri: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, osv.
BooleanOperationCSG Boolean-operationstype: UNION, DIFFERENCE, INTERSECTION.

Egenskabernes system

KlasseBeskrivelse:
PropertyEn enkelt navngivet typede egenskab på en A3DObject.Opbevarer ejendomsnavn, typedeskriptor og aktuel værdi.
PropertyCollectionIterabel indsamling af Property Forbrugerens personlige oplysninger. A3DObject.Understøtter søgning efter navn og iteration over alle definerede egenskaber.
CustomObjectEn letvægts- A3DObject underklasse, der kun indeholder et navn og en vilkårlig PropertyCollection.Bruges til at gemme brugerdefinerede metadata om sceneobjekter.

Billed og fremstilling

KlasseBeskrivelse:
ImageRenderOptionsMuligheder for software-rasterisering, når en scene renderes til et billedbuffer. Lagrer baggrundsfarve, billedet dimensioner og kamera reference. Scene.render() forhøjelser NotImplementedError;Rendering er ikke implementeret i denne udgave.

Se også:

 Dansk