Aspose.3D FOSS for Python

के लिए API संदर्भ aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT लाइसेंस).

सभी क्लासेस को आयात किया जाता है aspose.threed पैकेज या उसकी सब‑पैकेजों से। मूल आयात है:

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

कोर सीन ग्राफ

MethodsMethods
Sceneसभी 3D सीन डेटा के लिए शीर्ष‑स्तर कंटेनर। रूट नोड, एसेट मेटाडेटा, और एनीमेशन क्लिप्स को रखता है। एक्सपोज़ करता है from_file(), open(), और save() को प्राथमिक I/O एंट्री पॉइंट्स के रूप में.
Nodeसीन पदानुक्रम में एक नामित नोड। चाइल्ड नोड्स की सूची और संलग्न Entity ऑब्जेक्ट्स जैसे मेषेज़, कैमरे, और लाइट्स। स्थानीय Transform.
Entityसभी ऑब्जेक्ट्स के लिए एब्स्ट्रैक्ट बेस क्लास जो एक Node. नाम और पहचान प्रदान करता है लेकिन अपनी कोई ज्यामिति नहीं होती।.
SceneObjectबेस क्लास जिसे साझा किया गया है Node और Entity. उपयोगकर्ता-परिभाषित मेटाडेटा के लिए उपयोग किए जाने वाले प्रॉपर्टी कलेक्शन इंटरफ़ेस को प्रदान करता है।.
A3DObjectसभी Aspose.3D प्रबंधित ऑब्जेक्ट्स के लिए रूट बेस क्लास। नाम प्रॉपर्टी और Properties कलेक्शन।.
INamedObjectइंटरफ़ेस जो गारंटी देता है एक name प्रॉपर्टी। लागू किया गया है द्वारा Node, Entity, और कई फ़ॉर्मेट-विशिष्ट डिस्क्रिप्टर प्रकार।.

ज्यामिति और मेष

MethodsMethods
Meshपॉलीगॉन मेष एंटिटी। नियंत्रण बिंदुओं को संग्रहीत करता है (वर्टेक्स पोज़िशन के रूप में Vector4), पॉलीगॉन फेस लिस्ट्स (नियंत्रण-बिंदु सूचकांकों की सूचियाँ), और वर्टेक्स एलिमेंट लेयर्स (नॉर्मल्स, UVs, वर्टेक्स रंग)।.
Geometryजाल-सम geometry प्रकारों के लिए सारभूत आधार। control-point सरणी और संग्रह को परिभाषित करता है VertexElement परतें।. Mesh से विरासत में लेता है Geometry.
VertexElementज्यामिति (normals, UVs, colours, आदि) से जुड़ी डेटा परत के लिए सारभूत आधार। वह ले जाता है mapping_mode, reference_mode, और एक data सूची।.
VertexElementNormalप्रति vertex या प्रति polygon corner एक normal वेक्टर संग्रहीत करता है, यह इस पर निर्भर करता है mapping_mode. डेटा मान हैं FVector4 इंस्टेंस (single-precision) के साथ w अप्रयुक्त।.
VertexElementUVtexture-coordinate डेटा को इस रूप में संग्रहीत करता है FVector4 प्रति वर्टेक्स या प्रति पॉलीगॉन कोना (केवल x और y घटक UV के लिए उपयोग किए जाते हैं)। एक मेष विभिन्न टेक्सचर चैनलों के लिए कई UV लेयर ले जा सकता है।.
VertexElementVertexColorप्रति-वर्टेक्स या प्रति-कोना RGBA रंग डेटा को इस रूप में संग्रहीत करता है FVector4 (r, g, b, a 0–1 की सीमा में)।.
VertexElementSmoothingGroupप्रति-पॉलीगॉन स्मूदिंग ग्रुप पूर्णांक IDs को संग्रहीत करता है, जिसका उपयोग OBJ इम्पोर्टर द्वारा स्रोत फ़ाइल से मूल स्मूदिंग ग्रुप असाइनमेंट को पुनः उत्पन्न करने के लिए किया जाता है।.
VertexElementTypeएक एनीमरेशन जो वर्टेक्स एलिमेंट लेयर की सिमैंटिक भूमिका की पहचान करता है: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, और अन्य। मानों को पास करें Mesh.get_element().
MappingModeएक एनीमरेशन जो नियंत्रित करता है कि वर्टेक्स एलिमेंट मान किस प्रिमिटिव में मैप होता है: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, या ALL_SAME.
ReferenceModeएक एनीमरेशन जो नियंत्रित करता है कि मानों को कैसे इंडेक्स किया जाता है: DIRECT (प्रत्येक मैपिंग प्रिमिटिव के लिए एक मान) या INDEX_TO_DIRECT (मानों की एरे और एक अलग इंडिसेज़ एरे)।.
PolygonModifierत्रिभुज बनाने के तरीकों के साथ स्थैतिक उपयोगिता वर्ग Mesh ऑब्जेक्ट्स और संपूर्ण Scene ग्राफ़।.

ट्रांसफ़ॉर्म और स्पैशियल

MethodsMethods
Transformस्थानीय रूपांतरण जो एक Node. अनुवाद, घूर्णन (के रूप में Quaternion), और स्केल घटक, साथ ही यूलेर कोणों के लिए सुविधाजनक गुण।.
GlobalTransformसभी पूर्वज रूपांतरणों को संयोजित करने के बाद नोड के विश्व-स्थान रूपांतरण का केवल‑पढ़ने योग्य दृश्य। इसे द्वारा एक्सेस किया जाता है Node.global_transform.
AssetInfoमेटाडेटा ब्लॉक जो एक Scene. लेखक एप्लिकेशन का नाम, इकाई का नाम, इकाई स्केल फैक्टर, निर्देशांक प्रणाली अक्ष परिभाषाएँ, और निर्माण/संशोधन टाइमस्टैम्प संग्रहीत करता है।.

मैटेरियल्स और शेडिंग

MethodsMethods
Materialसभी सामग्री प्रकारों के लिए सारभूत बेस क्लास। यह एक नाम और संख्यात्मक तथा रंग पैरामीटरों के लिए प्रॉपर्टी संग्रह प्रदान करता है।.
LambertMaterialकेवल डिफ्यूज़ सामग्री मॉडल। एंबिएंट रंग, डिफ्यूज़ रंग, एमिसिव रंग, और पारदर्शिता को संग्रहीत करता है। बुनियादी Ka/Kd/Ke घोषणाओं से लोड किया जाता है।.
PhongMaterialMethods LambertMaterial स्पेक्युलर रंग और चमक (स्पेक्युलर एक्सपोनेंट) के साथ। उन OBJ फ़ाइलों से लोड किया जाता है जो उपयोग करती हैं Ks/Ns घोषणाओं।.
PbrMaterialभौतिक रूप से आधारित रेंडरिंग सामग्री। यह अल्बीडो, मेटैलिक फैक्टर, रफ़नेस फैक्टर, और संबंधित टेक्सचर को संग्रहीत करता है। glTF 2.0 और अन्य PBR-सक्षम फ़ॉर्मैट्स द्वारा उपयोग किया जाता है।.

कैमरा और लाइटिंग

MethodsMethods
Cameraकैमरा एंटिटी। केवल projection_type और name इस संस्करण में कार्यात्मक हैं; सभी अन्य संख्यात्मक प्रॉपर्टीज़ (near_plane, far_plane, field_of_view, aspect_ratio) डिफ़ॉल्ट मान लौटाने वाले स्टब हैं। एक Node को परिभाषित करने के लिए व्यूपॉइंट ट्रांसफ़ॉर्म्स।.
Lightलाइट-सोर्स इकाई। इनहेरिट करती है Camera एक स्टब क्लास के रूप में; यह Light क्लास स्वयं इस रिलीज़ में अतिरिक्त प्रॉपर्टीज़ नहीं दिखाती है।.
LightTypeसमर्थित लाइट श्रेणियों की एनेमरेशन: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeकैमरा प्रोजेक्शन मोड्स की एनेमरेशन: PERSPECTIVE और ORTHOGRAPHIC.

मैथ यूटिलिटीज़

MethodsMethods
Vector2डबल-प्रिसीजन 2-घटक वेक्टर (x, y). यूवी टेक्सचर कोऑर्डिनेट्स के लिए उपयोग किया जाता है।.
Vector3डबल-प्रिसीजन 3-घटक वेक्टर (x, y, z). पोजीशन, दिशा, और स्केल के लिए उपयोग किया जाता है।.
Vector4डबल-प्रिसीजन 4-घटक वेक्टर (x, y, z, w). नियंत्रण बिंदुओं (समरूप स्थितियों) और सामान्य डेटा के लिए उपयोग किया जाता है।.
FVector2सिंगल-प्रिसीजन 2-घटक फ़्लोट वेक्टर। वर्टेक्स एलिमेंट डेटा एरेज़ में कॉम्पैक्ट स्टोरेज के लिए आंतरिक रूप से उपयोग किया जाता है।.
FVector3सिंगल-प्रिसीजन 3-घटक फ़्लोट वेक्टर। सामान्य और टैन्जेंट के लिए वर्टेक्स एलिमेंट डेटा एरेज़ में प्रकट होता है।.
FVector4सिंगल-प्रिसीजन 4-घटक फ़्लोट वेक्टर। इसका स्टोरेज प्रकार है VertexElementFVector.data.
Quaternionरोटेशन को दर्शाने के लिए यूनिट क्वाटरनियन (w, x, y, z). द्वारा उपयोग किया जाता है Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxएक्सिस-एलाइन्ड बाउंडिंग बॉक्स जो परिभाषित है minimum और maximum Vector3 कोनों द्वारा। स्पैशियल क्वेरीज़ और फ्रस्टम क्यूलिंग हेल्पर्स के लिए उपयोग किया जाता है।.

Methods

MethodsMethods
AnimationClipएक नामित कंटेनर जो एक प्लेबैक रेंज को कवर करने वाले एनीमेटेड चैनलों के सेट के लिए है। A Scene एकाधिक क्लिप्स रख सकता है (जैसे, “Walk”, “Run”)।.
AnimationNodeबाइंड करता है एक AnimationClip एक विशिष्ट सीन नोड या प्रॉपर्टी से। क्लिप डेटा और सीन ग्राफ ऑब्जेक्ट्स के बीच पुल के रूप में कार्य करता है।.
AnimationChannelएक क्लिप के भीतर एकल एनीमेटेड प्रॉपर्टी स्ट्रीम, जो ऑब्जेक्ट पर एक नामित प्रॉपर्टी को लक्षित करती है (जैसे,., Transform.translation.x).
KeyFrameएकल समय‑मान नमूना एक के भीतर KeyframeSequence. समय (सेकंड में) और उस समय का मान संग्रहीत करता है।.
KeyframeSequenceएक क्रमबद्ध सूची KeyFrame एक स्केलर चैनल के लिए ऑब्जेक्ट्स, साथ ही इंटरपोलेशन और एक्सट्रापोलेशन सेटिंग्स।.
Interpolationकीफ़्रेम्स के बीच इंटरपोलेशन मोड्स की सूची: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeपहले और अंतिम कीफ़्रेम के परे व्यवहारों की सूची: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

फ़ॉर्मेट I/O

MethodsMethods
Scene.from_file(path)स्थैतिक मेथड। फ़ाइल को यहाँ खोलता है path, एक्सटेंशन से फ़ॉर्मेट का पता लगाता है, और एक भरा हुआ Scene. फ़ाइल न मिलने या असमर्थित फ़ॉर्मेट पर त्रुटि उत्पन्न करता है।.
Scene.open(path, options=None)इंस्टेंस मेथड। एक मौजूदा इंस्टेंस में फ़ाइल खोलता है Scene इंस्टेंस, वैकल्पिक रूप से फ़ॉर्मेट-विशिष्ट का उपयोग करके LoadOptions सबक्लास।.
Scene.save(path, options=None)इंस्टेंस मेथड। सीन को path एक्सटेंशन से अनुमानित फ़ॉर्मेट का उपयोग करके, वैकल्पिक रूप से फ़ॉर्मेट-विशिष्ट का उपयोग करके SaveOptions सबक्लास।.
FileFormatसमर्थित फ़ाइल फ़ॉर्मेट्स का रजिस्ट्री। इसमें ऐसे एंट्रीज़ होते हैं जैसे FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF. फ़ॉर्मेट-विशिष्ट वैरिएंट्स को विकल्प क्लासेज़ के माध्यम से एक्सेस किया जाता है (उदाहरण के लिए,., ColladaSaveOptions, GltfSaveOptions).
IOServiceफ़ॉर्मेट इम्पोर्टर्स और एक्सपोर्टर्स द्वारा उपयोग किया जाने वाला आंतरिक I/O एब्स्ट्रैक्शन। आमतौर पर एप्लिकेशन कोड द्वारा सीधे उपयोग नहीं किया जाता।.
LoadOptionsसभी फ़ॉर्मेट-विशिष्ट लोड-ऑप्शन ऑब्जेक्ट्स के लिए बेस क्लास। इसका उपवर्ग है ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsसभी फ़ॉर्मेट-विशिष्ट सेव-ऑप्शन ऑब्जेक्ट्स के लिए बेस क्लास। इसका उपवर्ग है ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

OBJ फ़ॉर्मेट

MethodsMethods
ObjImporterवेवफ़्रंट OBJ और MTL फ़ाइलों को पार्स करने वाली आंतरिक इम्पोर्टर क्लास। इसे स्वचालित रूप से द्वारा बुलाया जाता है Scene.from_file() के लिए .obj एक्सटेंशन।.
ObjLoadOptionsवेवफ़्रंट OBJ फ़ाइलों के लिए लोड विकल्प। प्रमुख गुण: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsवेवफ़्रंट OBJ आउटपुट के लिए सेव विकल्प। नॉर्मल्स, UVs, मैटेरियल रेफ़रेंसेज़, और पॉइंट-क्लाउड मोड को नियंत्रित करता है।.
ObjFormatवेवफ़्रंट OBJ के लिए फ़ॉर्मेट डिस्क्रिप्टर। एक्सेस किया जा सकता है जैसा कि FileFormat.WAVEFRONT_OBJ().

STL फ़ॉर्मेट

MethodsMethods
StlImporterबाइनरी और ASCII STL फ़ाइलों दोनों को पढ़ने वाली आंतरिक इम्पोर्टर। एक्सटेंशन द्वारा स्वचालित रूप से चयनित।.
StlExporterSTL लिखने वाली आंतरिक एक्सपोर्टर।.
StlLoadOptionsSTL फ़ाइलों के लिए लोड विकल्प। समर्थन करता है flip_coordinate_system और scale.
StlSaveOptionsSTL आउटपुट के लिए सहेजने के विकल्प। नियंत्रण binary_mode, scale, और flip_coordinate_system.
StlFormatSTL के लिए फ़ॉर्मेट विवरणक।.

glTF फ़ॉर्मेट

MethodsMethods
GltfLoadOptionsglTF 2.0 और GLB फ़ाइलों के लिए लोड विकल्प। मुख्य गुण: flip_tex_coord_v.
GltfSaveOptionsglTF 2.0 आउटपुट के लिए सहेजने के विकल्प। उपयोग करें binary_mode=True एक स्व-समाहित GLB पैकेज के लिए।.
GltfFormatglTF 2.0 / GLB के लिए फ़ॉर्मेट विवरणक। के रूप में उपलब्ध है FileFormat.GLTF2().

FBX फ़ॉर्मेट

MethodsMethods
FbxLoadOptionsFBX फ़ाइलों के लिए लोड विकल्प। मुख्य गुण: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsFBX आउटपुट के लिए सहेजने के विकल्प। FBX निर्यात उत्पन्न करता है NotImplementedError बिना शर्त; FbxSaveOptions मौजूद है लेकिन निर्यात लागू नहीं किया गया है।.
FbxFormatFBX के लिए फ़ॉर्मेट डिस्क्रिप्टर। इसे इस रूप में पहुँचा जा सकता है FileFormat.FBX7400ASCII().

COLLADA फ़ॉर्मेट

MethodsMethods
ColladaLoadOptionsCOLLADA के लिए लोड विकल्प (.dae) फ़ाइलें। आयात पर अक्ष पुनःमैपिंग और इकाई स्केल को नियंत्रित करता है।.
ColladaSaveOptionsCOLLADA आउटपुट के लिए सहेजने के विकल्प। नियंत्रित करता है indented, flip_coordinate_system, और सामग्री निर्यात।.
ColladaFormatCOLLADA के लिए फ़ॉर्मेट डिस्क्रिप्टर। स्वचालित रूप से यहाँ से निर्धारित किया जाता है .dae फ़ाइल एक्सटेंशन।.

3MF Format

MethodsMethods
ThreeMfLoadOptions3MF के लिए लोड विकल्प (.3mf) फ़ाइलें।.
ThreeMfSaveOptions3MF आउटपुट के लिए सहेजने के विकल्प। 3MF 3D प्रिंटिंग वर्कफ़्लो के लिए पसंदीदा फ़ॉर्मेट है।.
ThreeMfFormat3MF के लिए फ़ॉर्मेट विवरणकर्ता। इसे इस रूप में पहुँचा जा सकता है FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
TextureMappingयह पहचानता है कि टेक्सचर को ज्यामिति पर कैसे मैप किया जाता है: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, आदि।.
BooleanOperationCSG बूलियन ऑपरेशन प्रकार: UNION, DIFFERENCE, INTERSECTION.

प्रॉपर्टीज़ सिस्टम

MethodsMethods
Propertyएक एकल नामित टाइप्ड प्रॉपर्टी एक A3DObject. प्रॉपर्टी का नाम, टाइप विवरणकर्ता, और वर्तमान मान संग्रहीत करता है।.
PropertyCollectionइटेरेबल संग्रह Property ऑब्जेक्ट्स जो एक से जुड़े हैं A3DObject. नाम द्वारा लुकअप और सभी परिभाषित प्रॉपर्टीज़ पर इटरेशन का समर्थन करता है।.
CustomObjectएक हल्का A3DObject सबक्लास जो केवल एक नाम और एक मनमाना PropertyCollection. दृश्य वस्तुओं पर उपयोगकर्ता-परिभाषित मेटाडेटा संग्रहीत करने के लिए उपयोग किया जाता है।.

इमेज और रेंडर

MethodsMethods
ImageRenderOptionsजब दृश्य को इमेज बफ़र में रेंडर किया जाता है तो सॉफ़्टवेयर रास्टराइज़ेशन के विकल्प। पृष्ठभूमि रंग, इमेज आयाम, और कैमरा संदर्भ को संग्रहीत करता है।. Scene.render() उठाता है NotImplementedError; इस रिलीज़ में रेंडरिंग लागू नहीं की गई है।.

संबंधित देखें

 हिन्दी