Python içinde 3D Modelleri Yükleme

Aspose.3D FOSS for Python, yerel bağımlılıkları olmadan 3D dosyalarını açmak için basit bir API sunar. Bir dosyayı bir nesneye yükledikten sonra Scene nesne, düğüm hiyerarşisini gezebilir ve sahnedeki her ağ için ham geometri verilerini okuyabilirsiniz.

Adım Adım Kılavuz

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)

Yaygın Sorunlar ve Çözümler

Çağırırken FileNotFoundError Scene.from_file()

Yol, çalışma zamanında çalışma dizinine göre mutlak ya da doğru bir göreli yol olmalıdır. Kullan pathlib.Path güvenilir yollar oluşturmak için:

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 dosyası yüklendikten sonra boştur

STL dosyaları üçgenleri ham yüzeyler (facets) olarak depolar, indeksli bir ağ (mesh) olarak değil. Yükleme sonrasında, çokgenler bu yüzeylerden sentezlenir. Eğer polygons boş görünüyor, kontrol edin len(mesh.control_points); eğer sayı 3’ün katıysa, geometri indekslenmemiş biçimde depolanır ve ardışık üç köşe bir üçgen oluşturur.

Koordinat sistemi uyumsuzluğu (model döndürülmüş veya yansıtılmış görünüyor)

Farklı araçlar farklı konvansiyonlar kullanır (Y-up vs Z-up, sol el vs sağ el). Ayarla ObjLoadOptions.flip_coordinate_system = True veya kök düğümünün üzerine bir dönüş uygulayın Transform yükleme sonrasında.

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

Bir düğümün varlık listesi, ağ olmayan varlıklar (kameralar, ışıklar) içerebilir. Her zaman şununla koruyun isinstance(entity, Mesh) dönüştürmeden önce.

Sık Sorulan Sorular (SSS)

Hangi 3D formatlarını yükleyebilirim?

OBJ (Wavefront), STL (ikili ve ASCII), glTF 2.0 / GLB, COLLADA (DAE) ve 3MF. FBX dosya tokenizasyonu kısmen destekleniyor ancak tam ayrıştırma henüz tamamlanmadı.

Bir OBJ dosyasını yüklemek aynı zamanda .mtl malzemeyi?

Evet, şu zaman ObjLoadOptions.enable_materials = True (varsayılan). Kütüphane şunu arar .mtl dosyayı aynı dizinde .obj dosya. Eğer .mtl eksikse, geometri yine de yüklenir ve bir uyarı verilir.

Bir dosyayı yol yerine bayt akışından yükleyebilir miyim?

Evet. scene.open() herhangi bir dosya benzeri nesneyi bir .read() metoduyla birlikte bir dosya yolu dizesi de kabul eder. Açık bir ikili akış (örneğin,., io.BytesIO) doğrudan. Scene.from_file() yalnızca bir dosya yolu dizesi kabul eder.

Yüzey normallerini nasıl alırım?

Yükleme sonrası kontrol edin mesh.get_element(VertexElementType.NORMAL). Bu bir VertexElementNormal ki data liste, referans başına bir normal vektör içerir, … göre eşlenir mapping_mode ve reference_mode.

from aspose.threed.entities import Mesh, VertexElementType

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

Kütüphane, birden fazla dosyayı eşzamanlı olarak yüklemek için thread-safe mı?

Her Scene Nesne bağımsızdır. Ayrı dosyaları ayrı Scene örnekler ayrı iş parçacıklarından güvenlidir, tek bir Scene iş parçacıkları arasında harici kilitleme olmadan.