Aspose.3D FOSS
Python
डेवलपर गाइड
Rendering

Aspose.3D के साथ 3D मॉडल रेंडर करें

अवलोकन

Aspose.3D Python अनुप्रयोगों में 3D मॉडल के रेंडरिंग और हेरफेर को सक्षम बनाता है। यह Scene, Node, Mesh, Geometry, Camera और Light जैसी कोर क्लासेज़ प्रदान करता है ताकि python 3d visualization, python 3d game, और 3d python library उपयोग मामलों के लिए 3D सामग्री का निर्माण और संशोधन किया जा सके।

API scene ग्राफ निर्माण को Node और Entity पदानुक्रमों के माध्यम से, Mesh और Geometry के द्वारा ज्यामिति परिभाषा, तथा रेंडरिंग के लिए कैमरा/लाइट सेटअप का समर्थन करता है। एनीमेशन क्षमताओं में AnimationClip, AnimationNode, AnimationChannel और KeyframeSequence शामिल हैं, जो कीफ़्रेम‑आधारित गति के लिए (केवल‑पढ़ने की पहुँच; एनीमेशन निर्यात अभी लागू नहीं किया गया है)। एसेट मेटाडेटा AssetInfo के माध्यम से उपलब्ध है, जबकि scene ऑब्जेक्ट्स नामकरण के लिए A3DObject और INamedObject से विरासत में लेते हैं और property प्रबंधन के लिए।

प्रमुख विशेषताएँ

Aspose.3D 3D मॉडल के साथ काम करने के लिए एक Python API प्रदान करता है, जो Scene, Mesh, Node, Geometry, और AnimationClip जैसी कक्षाओं के माध्यम से कोर ऑपरेशन्स को समर्थन देता है। यह डेवलपर्स को 3D सामग्री को लोड, मैनिपुलेट और एक्सपोर्ट करने में सक्षम बनाता है, जिससे python 3d visualization, python 3d game, और 3d python engine वर्कफ़्लो संभव होते हैं।

  • FileFormat क्लास के माध्यम से GLTF2 और WAVEFRONT_OBJ सहित कई 3D फ़ाइल स्वरूपों के समर्थन से 3D पायथन गेम और 3D पायथन विज़ुअलाइज़ेशन प्रोजेक्ट्स में सहज आयात और निर्यात संभव होता है। FBX समर्थन प्रयोगात्मक है (केवल टोकनाइज़र; पूर्ण पार्सर प्रगति पर है)।
  • Mesh और Geometry क्लासों के माध्यम से मेष ज्यामिति का प्रत्यक्ष हेरफेर वर्टिसेज़, पॉलीगॉन्स और छाया व दृश्यता जैसी रेंडरिंग गुणों पर सटीक नियंत्रण प्रदान करता है।
  • AnimationClip, AnimationNode और KeyframeSequence क्लासों के माध्यम से एनीमेशन संरचनाओं का निरीक्षण और निर्माण किया जा सकता है; ध्यान दें कि इस संस्करण में एनीमेशन निर्यात अभी लागू नहीं किया गया है।
  • Node, Entity और A3DObject का उपयोग करके सीन पदानुक्रम प्रबंधन जटिल पायथन 3D विज़ुअलाइज़ेशन दृश्यों के लिए 3D ऑब्जेक्ट्स, कैमरों और लाइट्स का संरचित संगठन प्रदान करता है।
  • PropertyCollection, AssetInfo और INamedObject के माध्यम से प्रॉपर्टी और मेटाडेटा हैंडलिंग कस्टम एट्रिब्यूट्स और दस्तावेज़‑स्तर के मेटाडेटा जैसे शीर्षक, लेखक और कीवर्ड्स को समर्थन देती है।

आवश्यकताएँ

Aspose.3D को 3D python विज़ुअलाइज़ेशन के लिए उपयोग करने के लिए, सुनिश्चित करें कि Python 3.7 या बाद का संस्करण स्थापित है। pip के साथ कमांड pip install aspose-3d-foss का उपयोग करके library स्थापित करें। यह पैकेज कोर क्लासेज़ प्रदान करता है जैसे Scene, Mesh, Node, Entity, Geometry, Camera, Light, और FileFormat, जो 3d python गेम और 3d python इंजन वर्कफ़्लो के साथ काम करने के लिए हैं।

pip install aspose-3d-foss
import aspose.threed
print('Installation successful')

कोड उदाहरण

Aspose.3D for Python में, “rendering” 3D सीन का अर्थ है इसे OBJ, GLTF2, या STL जैसे समर्थित आउटपुट फ़ॉर्मेट में निर्यात करना। पिक्सेल-आधारित रास्टराइज़ेशन समर्थित नहीं है; 3D आउटपुट फ़ाइलें बनाने के लिए scene.save() का उपयोग करें।

from aspose.threed import Scene, FileFormat, Mesh, Node

# Load a scene from file
scene = Scene.from_file("model.obj")

# Inspect the root node
root = scene.root_node
for child in root.child_nodes:
    if isinstance(child.entity, Mesh):
        print(f"Mesh: {child.name}, control points: {len(child.entity.control_points)}")

# Export to GLTF 2.0 binary — use extension-based detection or FileFormat.GLTF2() factory
# Note: FileFormat.GLTF2_BINARY is None (stub constant, not implemented).
# Use the .glb extension for auto-detection, or FileFormat.GLTF2() for explicit format.
scene.save("output.glb")
print("Scene exported to output.glb")

सर्वश्रेष्ठ प्रथाएँ

Aspose.3D को python 3d विज़ुअलाइज़ेशन या python 3d गेम इंजन बनाने के लिए उपयोग करते समय, जहाँ संभव हो Scene और Mesh इंस्टेंसेज़ को पुन: उपयोग करके मेमोरी दक्षता को प्राथमिकता दें। टाइट लूप्स में अनावश्यक ऑब्जेक्ट्स बनाने से बचें, विशेष रूप से बैच 3d python रूपांतरण के लिए कई फ़ाइलों को प्रोसेस करते समय।

  • निर्यात चक्रों में Scene ऑब्जेक्ट्स को पुन: उपयोग करें, प्रत्येक फ़ाइल के लिए नए ऑब्जेक्ट बनाना न करें।
  • स्थिर ज्यामिति के लिए साझा नियंत्रण बिंदुओं के साथ Mesh पुन: उपयोग को प्राथमिकता दें, जिससे आवंटन ओवरहेड कम हो।
  • आउटपुट मोड और निर्देशांक हैंडलिंग को नियंत्रित करने के लिए फ़ॉर्मेट‑विशिष्ट सहेजने विकल्पों (जैसे GltfSaveOptions, StlSaveOptions) का उपयोग करें।
  • पायथन 3D विज़ुअलाइज़ेशन पाइपलाइन में डिस्क I/O बाधाओं से बचने के लिए इन‑मेमोरी निर्यात वर्कफ़्लो के लिए BytesIO स्ट्रीम्स का उपयोग करें।

समस्या निवारण

यह अनुभाग Aspose.3D का उपयोग करते समय 3D पायथन विज़ुअलाइज़ेशन और गेम विकास कार्यप्रवाहों में Scene, Node, Mesh, और AnimationClip क्लासेज़ से संबंधित सामान्य समस्याओं को कवर करता है।

असमर्थित ऑपरेशन्स NotImplementedError उत्पन्न करते हैं

कुछ निर्यातकों के माध्यम से निर्यात और get_entity_renderer_key() जैसी रेंडरिंग‑संबंधी विधियों जैसे ऑपरेशन्स लागू नहीं किए गए हैं और NotImplementedError उठाते हैं। यह इसलिए होता है क्योंकि Aspose.3D for Python के वर्तमान version में कोर कार्यक्षमता अधूरी है। रनटाइम विफलताओं से बचने के लिए, असमर्थित विधियों को कॉल करने से पहले API सतह के विरुद्ध विधि उपलब्धता की जाँच करें। समर्थित लोड और निर्यात कार्यप्रवाहों के लिए Scene.from_file() और scene.save() का उपयोग करें।

Mesh विधियाँ जो NotImplementedError उठाती हैं

निम्नलिखित Mesh मेथड्स API सतह में घोषित हैं लेकिन इस रिलीज़ में NotImplementedError उत्पन्न करते हैं। किसी भी लोडेड या निर्मित Mesh इंस्टेंस पर इन्हें कॉल न करें:

MethodNotes
mesh.optimize()Mesh optimisation — अभी तक लागू नहीं किया गया
mesh.do_boolean(...)Generic boolean operation — नीचे दिए गए विशिष्ट मेथड्स का उपयोग करें
mesh.union(other)CSG union — अभी तक लागू नहीं किया गया
mesh.difference(other)CSG difference — अभी तक लागू नहीं किया गया
mesh.intersect(other)CSG intersection — अभी तक लागू नहीं किया गया
mesh.is_manifold()Manifold test — अभी तक लागू नहीं किया गया
Mesh(height_map, ...)Height-map constructor variant — अभी तक लागू नहीं किया गया

यदि आपके कार्यप्रवाह को इन संचालन की आवश्यकता है, तो ज्यामिति को trimesh या open3d जैसी लाइब्रेरी में प्रोसेस करें और परिणाम को Scene.from_file() का उपयोग करके पुनः आयात करें या कच्चे control_points और polygons से नया Mesh बनाकर।

एनीमेशन फीचर केवल‑पढ़ने योग्य

AnimationClip, AnimationNode, AnimationChannel और KeyframeSequence जैसी एनीमेशन‑संबंधित क्लासेज़ को निरीक्षण किया जा सकता है लेकिन एनीमेशन निर्यात कार्यात्मक नहीं है। python 3d गेम इंजन या python 3d विज़ुअलाइज़ेशन टूल्स बनाते डेवलपर्स को पूर्ण निर्यात समर्थन जारी होने तक एनीमेशन डेटा को केवल‑रीड (read‑only) मानना चाहिए।

टेक्सचर इमेज लोडिंग समर्थित नहीं है

materials के लिए टेक्सचर इमेज लोड करना Aspose.3D में लागू नहीं किया गया है। भले ही material properties को Mesh या Geometry के माध्यम से सेट किया जाए, टेक्सचर मैपिंग सही ढंग से रेंडर नहीं होगी। स्थिर मॉडल निर्यात के लिए, इमेज‑आधारित टेक्सचर के बजाय ठोस रंगों या वर्टेक्स‑आधारित शेडिंग पर भरोसा करें।

Camera और Geometry रेंडरिंग असमर्थित है

Camera और Geometry क्लासेज़ रेंडरिंग‑संबंधी मेथड्स जैसे get_entity_renderer_key() के लिए NotImplementedError उठाते हैं। जबकि इन क्लासेज़ को इंस्टैंशिएट और कॉन्फ़िगर किया जा सकता है, इन्हें पिक्सेल‑रास्टराइज़ेशन पाइपलाइनों में उपयोग नहीं किया जा सकता। Node और Mesh का उपयोग scene कंपोज़िशन और एक्सपोर्ट वर्कफ़्लोज़ के लिए करें।

अक्सर पूछे जाने वाले प्रश्न

क्या Aspose.3D for Python रास्टराइज़्ड इमेज आउटपुट (PNG, JPEG) का समर्थन करता है?

नहीं। Aspose.3D for Python पिक्सेल‑आधारित रास्टराइज़ेशन नहीं करता। इस लाइब्रेरी में “Rendering” का अर्थ है scene.save() का उपयोग करके दृश्य को OBJ, GLTF2, STL, या 3MF जैसे 3D आउटपुट फ़ॉर्मेट में निर्यात करना। इमेज आउटपुट के लिए, एक अलग रेंडरिंग इंजन के साथ एकीकृत करें।

कौन से निर्यात स्वरूप समर्थित हैं?

समर्थित निर्यात स्वरूपों में OBJ, glTF 2.0 / GLB, STL (बाइनरी और ASCII), COLLADA (DAE), और 3MF शामिल हैं। स्वचालित स्वरूप पहचान के लिए scene.save() को कॉल करते समय फ़ाइल एक्सटेंशन का उपयोग करें। स्पष्ट स्वरूप नियंत्रण के लिए, फ़ैक्टरी मेथड्स FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), और FileFormat.MICROSOFT_3MF_FORMAT() का उपयोग करें। ध्यान दें: FileFormat.GLTF2_BINARY, FileFormat.GLTF, FileFormat.STLASCII, FileFormat.STL_BINARY, और FileFormat.MICROSOFT_3MF जैसे एट्रिब्यूट-शैली के कॉन्स्टेंट्स None स्टब्स हैं और उनका उपयोग नहीं किया जाना चाहिए। वर्तमान संस्करण में FBX निर्यात NotImplementedError उत्पन्न करता है।

क्या मैं लोड किए गए 3D फ़ाइल से एनीमेशन डेटा पढ़ सकता हूँ?

लोड की गई फ़ाइलों में एनीमेशन संरचनाओं तक AnimationClip, AnimationNode और संबंधित क्लासों के माध्यम से पहुंचा जा सकता है, लेकिन एनीमेशन डेटा को संशोधित करना या पुनः निर्यात करना अभी समर्थित नहीं है और यह NotImplementedError उत्पन्न करेगा।

API संदर्भ सारांश

Aspose.3D Python में 3D दृश्यों को संभालने के लिए कोर क्लासेस प्रदान करता है, जिसमें Scene, Node, Mesh और Geometry शामिल हैं। Python 3D गेम, Python 3D इंजन, या Python 3D विज़ुअलाइज़ेशन प्रोजेक्ट्स पर काम करने वाले डेवलपर्स इन क्लासेस का उपयोग प्रोग्रामेटिक रूप से 3D सामग्री बनाने और संशोधित करने के लिए कर सकते हैं। Scene क्लास रूट कंटेनर के रूप में कार्य करती है, जबकि Node ऑब्जेक्ट्स scene ग्राफ़ पदानुक्रम बनाते हैं, और Mesh इंस्टेंस Geometry डेटा के साथ ज्यामितीय आकार निर्धारित करते हैं।

एस्पोज़.3D में एनीमेशन समर्थन AnimationClip, AnimationNode, AnimationChannel, और KeyframeSequence पर निर्भर करता है ताकि time-आधारित ट्रांसफ़ॉर्मेशन को परिभाषित किया जा सके। हालांकि एनीमेशन निर्यात अभी तक लागू नहीं हुआ है, डेवलपर्स इन क्लासों का उपयोग करके एनीमेशन संरचनाओं का निरीक्षण कर सकते हैं। Extrapolation क्लास और ExtrapolationType enum कीफ़्रेम रेंजों के बाहर के व्यवहार को नियंत्रित करने की अनुमति देते हैं।

Entity-स्तर के properties जैसे दृश्यता और छाया निर्माण को Geometry.visible, Geometry.cast_shadows और Geometry.receive_shadows के माध्यम से उजागर किया जाता है। Scene ग्राफ संबंधों को Entity.parent_node और Entity.parent_nodes के माध्यम से प्रबंधित किया जाता है, जबकि Node वस्तुएँ GlobalTransform को translation, rotation और scale के लिए उजागर करती हैं। Camera और Light entities Entity से विरासत में लेते हैं और excluded के माध्यम से बहिष्कार का समर्थन करते हैं।

देखें भी

Aspose.3D Python में 3D मॉडल हेरफेर के लिए कोर क्लासेस प्रदान करता है, जिसमें Scene, Mesh, Node, Geometry, और AnimationClip शामिल हैं। ये क्लासेस लगातार API सतह के माध्यम से python 3d visualization, python 3d game development, और 3d python workflows को समर्थन देती हैं।

 हिन्दी