Как да заредим 3D модели в Python

Aspose.3D FOSS for Python предоставя прост API за отваряне на 3D файлове без никакви native зависимости. След като заредите файл в обект 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 (binary and 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 екземпляри от отделни нишки е безопасно, стига да не споделяте един единствен Scene между нишките без външно заключване.