कैसे लोड करें 3D मॉडल Python में

Aspose.3D FOSS for Python एक सरल API प्रदान करता है 3D फ़ाइलें खोलने के लिए, बिना किसी मूल निर्भरताओं के। फ़ाइल को एक Scene ऑब्जेक्ट में, आप नोड पदानुक्रम को पार कर सकते हैं और दृश्य में प्रत्येक मेष के लिए कच्चा ज्यामिति डेटा पढ़ सकते हैं।.

स्टेप बाय स्टेप गाइड

pip install aspose-3d-foss

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

##Automatic format detection
scene = Scene.from_file("model.obj")

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

from aspose.threed import Scene, Node

scene = Scene.from_file("model.obj")

def walk(node: Node, depth: int = 0) -> None:
    indent = "  " * depth
    print(f"{indent}Node: {node.name!r}")
    for child in node.child_nodes:
        walk(child, depth + 1)

walk(scene.root_node)

from aspose.threed import Scene
from aspose.threed.entities import Mesh

scene = Scene.from_file("model.obj")

for node in scene.root_node.child_nodes:
    for entity in node.entities:
        if isinstance(entity, Mesh):
            mesh: Mesh = entity
            print(f"Mesh '{node.name}': "
                  f"{len(mesh.control_points)} vertices, "
                  f"{len(mesh.polygons)} polygons")

            # First vertex position
            if mesh.control_points:
                v = mesh.control_points[0]
                print(f"  First vertex: ({v.x:.4f}, {v.y:.4f}, {v.z:.4f})")

            # First polygon face (list of control-point indices)
            if mesh.polygons:
                print(f"  First polygon: {mesh.polygons[0]}")

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

options = ObjLoadOptions()
options.flip_coordinate_system = True   # Convert right-hand Y-up to Z-up
options.scale = 0.01                    # Convert centimetres to metres
options.enable_materials = True         # Load .mtl material file
options.normalize_normal = True         # Normalize all normals to unit length

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

सामान्य समस्याएँ और समाधान

FileNotFoundError कॉल करने पर Scene.from_file()

पथ को रनटाइम पर कार्य निर्देशिका के सापेक्ष पूर्ण या सही होना चाहिए। उपयोग करें pathlib.Path विश्वसनीय पथ बनाने के लिए:

from pathlib import Path
from aspose.threed import Scene

path = Path(__file__).parent / "assets" / "model.obj"
scene = Scene.from_file(str(path))

mesh.polygons STL फ़ाइल लोड करने के बाद खाली है

STL फ़ाइलें त्रिकोणों को कच्चे फ़ैसेट के रूप में संग्रहीत करती हैं, न कि एक अनुक्रमित मेष के रूप में। लोड करने के बाद, बहुभुज उन फ़ैसेट से संश्लेषित किए जाते हैं। यदि polygons खाली दिखता है, जाँचें len(mesh.control_points); यदि गणना 3 का गुणज है तो ज्यामिति अनइंडेक्स्ड रूप में संग्रहीत होती है और प्रत्येक क्रमिक तीन शीर्ष बिंदु एक त्रिकोण बनाते हैं।.

निर्देशांक प्रणाली का मेल नहीं (मॉडल घुमाया या प्रतिबिंबित दिख रहा है)

विभिन्न टूल अलग-अलग सम्मेलनों का उपयोग करते हैं (Y‑up बनाम Z‑up, बाएँ‑हाथ बनाम दाएँ‑हाथ)। सेट ObjLoadOptions.flip_coordinate_system = True या रूट नोड के लिए एक घूर्णन लागू करें Transform लोड करने के बाद।.

AttributeError: 'NoneType' object has no attribute 'polygons'

किसी नोड की एंटिटी सूची में गैर‑मेश एंटिटीज़ (कैमरे, लाइट्स) हो सकते हैं। हमेशा … के साथ गार्ड रखें isinstance(entity, Mesh) कास्ट करने से पहले।.

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

मैं कौन‑से 3D फ़ॉर्मेट लोड कर सकता हूँ?

OBJ (Wavefront), STL (बाइनरी और ASCII), glTF 2.0 / GLB, COLLADA (DAE), और 3MF। FBX फ़ाइल टोकनाइज़ेशन आंशिक रूप से समर्थित है लेकिन पूर्ण पार्सिंग अभी तक पूरी नहीं हुई है।.

क्या OBJ फ़ाइल लोड करने से भी … लोड हो जाता है? .mtl सामग्री?

हाँ, जब ObjLoadOptions.enable_materials = True (डिफ़ॉल्ट). लाइब्रेरी खोजती है .mtl फ़ाइल उसी निर्देशिका में जहाँ .obj फ़ाइल। यदि .mtl ग़ायब है, ज्यामिति अभी भी लोड हो जाती है और एक चेतावनी जारी की जाती है।.

क्या मैं पथ के बजाय बाइट स्ट्रीम से फ़ाइल लोड कर सकता हूँ?

हाँ।. scene.open() किसी भी फ़ाइल-समतुल्य ऑब्जेक्ट को स्वीकार करता है जिसमें एक .read() विधि के साथ-साथ फ़ाइल पाथ स्ट्रिंग भी। एक खुला बाइनरी स्ट्रीम पास करें (उदाहरण के लिए,., io.BytesIO) सीधे।. Scene.from_file() केवल फ़ाइल पथ स्ट्रिंग को स्वीकार करता है।.

मैं सतह के नॉर्मल कैसे प्राप्त करूँ?

लोड करने के बाद, जाँचें mesh.get_element(VertexElementType.NORMAL). यह एक लौटाता है VertexElementNormal जिसका data सूची में प्रत्येक संदर्भ के लिए एक सामान्य वेक्टर होता है, जो अनुसार मैप किया गया है mapping_mode और reference_mode.

from aspose.threed.entities import Mesh, VertexElementType

normals = mesh.get_element(VertexElementType.NORMAL)
if normals:
    print(normals.data[0])  # First normal vector

क्या लाइब्रेरी एक साथ कई फ़ाइलों को लोड करने के लिए थ्रेड-सेफ़ है?

प्रत्येक Scene वस्तु स्वतंत्र है। अलग-अलग फ़ाइलों को अलग-अलग में लोड करना Scene विभिन्न थ्रेड्स से instances सुरक्षित है जब तक आप एक ही को साझा नहीं करते Scene threads के बीच external locking के बिना।.