इंस्टॉलेशन

Python 3.7–3.12 की आवश्यकता है. Pure Python: कोई संस्करण की आवश्यकता नहीं है.

Aspose.3D FOSS for Python PyPI पर एक शुद्ध-Python पैकेज के रूप में वितरित किया जाता है। कोई नेटिव एक्सटेंशन कंपाइल करने की आवश्यकता नहीं है, कोई सिस्टम लाइब्रेरी स्थापित करने की आवश्यकता नहीं है, और कोई Microsoft Office या अन्य थर्ड‑पार्टी रनटाइम आवश्यक नहीं है।.

आवश्यकताएँ

1. Install via pip (Recommended)

Aspose.3D FOSS को स्थापित करने का सबसे सरल तरीका PyPI से सीधे है:

pip install aspose-3d-foss

pip पैकेज को डाउनलोड और स्थापित करेगा और इसे आपके एनवायरनमेंट में रिकॉर्ड करेगा। पोस्ट‑इंस्टॉल कॉन्फ़िगरेशन की आवश्यकता नहीं है।.

पुनरुत्पादक बिल्ड्स के लिए एक पिन्ड संस्करण स्थापित करने के लिए:

pip install aspose-3d-foss==26.1.0

2. Set Up a Virtual Environment (Recommended for Projects)

वर्चुअल एनवायरनमेंट का उपयोग लाइब्रेरी को अन्य Python प्रोजेक्ट्स से अलग रखता है और संस्करण संघर्षों से बचाता है।.

एक वर्चुअल एनवायरनमेंट बनाएँ और सक्रिय करें:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

सक्रिय किए गए एनवायरनमेंट के भीतर लाइब्रेरी स्थापित करें:

pip install aspose-3d-foss

पुनरुत्पादकता के लिए निर्भरताओं को रिकॉर्ड करें:

pip freeze > requirements.txt

दूसरे मशीन पर एनवायरनमेंट को पुनः बनाने के लिए:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

स्थापना के बाद, यह सत्यापित करें कि लाइब्रेरी सही ढंग से इम्पोर्ट होती है:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

अपेक्षित आउटपुट:

Aspose.3D FOSS installed successfully
Root node name: RootNode

आप pip के साथ स्थापित संस्करण भी जांच सकते हैं:

pip show aspose-3d-foss

यह संस्करण, लेखक, और लाइसेंस (MIT) को प्रिंट करेगा।.

त्वरित प्रारंभ: एक सीन लोड करें और उसका निरीक्षण करें

निम्नलिखित स्क्रिप्ट एक 3D फ़ाइल लोड करती है, प्रत्येक मेष नोड की जानकारी प्रिंट करती है, और सीन को GLB फ़ॉर्मेट में पुनः निर्यात करती है:

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

##Load an OBJ file with material support
options = ObjLoadOptions()
options.enable_materials = True
options.flip_coordinate_system = False

scene = Scene()
scene.open("model.obj", options)

##Print the scene hierarchy
print(f"Top-level nodes: {len(scene.root_node.child_nodes)}")

for node in scene.root_node.child_nodes:
    if node.entity is None:
        continue
    mesh = node.entity
    print(f"  Node: {node.name}")
    print(f"    Vertices: {len(mesh.control_points)}")
    print(f"    Polygons: {len(mesh.polygons)}")
    if node.material:
        print(f"    Material: {type(node.material).__name__}")

##Re-export to GLB (binary glTF)
scene.save("output.glb")
print("Saved output.glb")

यदि आपके पास अभी तक OBJ फ़ाइल नहीं है, तो लाइब्रेरी स्क्रैच से भी एक सीन बना सकती है:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

प्लेटफ़ॉर्म नोट्स

Windows, macOS, Linux: लाइब्रेरी सभी प्लेटफ़ॉर्म पर समान है। कोई प्लेटफ़ॉर्म-विशिष्ट कोड पाथ या बाइनरी एक्सटेंशन नहीं हैं।.

Docker / सर्वरलेस: क्योंकि कोई सिस्टम-पैकेज निर्भरताएँ नहीं हैं, लाइब्रेरी स्लिम Docker इमेजेज़ (जैसे python:3.12-slim) अतिरिक्त apt या yum पैकेज स्थापित किए बिना।.

CI/CD: जोड़ें pip install aspose-3d-foss आपके CI पाइपलाइन के निर्भरता चरण में। कोई अतिरिक्त सेटअप आवश्यक नहीं है।.

Conda: यदि आपका प्रोजेक्ट Conda का उपयोग करता है, तो Conda वातावरण के भीतर PyPI से लाइब्रेरी स्थापित करें:

conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss

अतिरिक्त संसाधन

• उत्पाद पृष्ठ: अवलोकन, फीचर सारांश, और प्रशंसापत्र
• डेवलपर गाइड: कोड उदाहरणों के साथ पूर्ण API संदर्भ
• विशेषताएँ और कार्यक्षमताएँ: फ़ॉर्मेट समर्थन, सीन ग्राफ, सामग्री, गणितीय उपयोगिताएँ, और अधिक