Python API для создания, редактирования и конвертации 3D‑моделей

Начало работы с Aspose.3D для Python через .NET

Самый простой способ установить Aspose.3D for Python via .NET стабильный релиз — использовать pip. Пожалуйста, используйте следующую команду для беспроблемной установки.

pip install aspose-3d 

Создание и загрузка 3D-сцены через Python API

Aspose.3D for Python via .NET включает полную поддержку создания новых 3D‑сцен с нуля и их сохранения в любой поддерживаемый формат файла с помощью команд Python. Библиотека также предоставляет возможность чтения существующих 3D‑сцен, внесения изменений в существующие 3D, сохранения 3D‑сцены в PDF, открытия существующих сцен из защищённого паролем PDF, определения формата файла, извлечения 3D‑контента из PDF‑файла, установки параметров загрузки перед загрузкой 3D‑Obj файла и многое другое.

import aspose.threed as a3d

# For complete examples and data files, please go to https://github.com/aspose-3d/Aspose.3D-for-.NET

# The path to the documents directory.

# Create an object of the Scene class

scene = a3d.Scene()

# Save 3D scene document

scene.Save("document.fbx", a3d.FileFormat.FBX7500ASCII)

Рендеринг 3D-сцены через Python API

Aspose.3D for Python via .NET позволяет разработчикам программного обеспечения загружать и визуализировать 3D‑сцены в своих собственных приложениях на Python. Библиотека поддерживает высококачественную отрисовку 3D‑сцен, включая сглаживание (anti-aliasing), глубину резкости, размытие движения и многое другое. Она также поддерживает импорт и экспорт различных 3D‑форматов файлов, включая FBX, OBJ, STL и 3DS. Это означает, что вы можете легко импортировать существующие 3D‑модели в свою сцену или экспортировать свою 3D‑сцену в совместимый формат. Поддерживаются такие функции, как отбрасывание и получение теней на 3D‑геометрии, аппаратно‑ускоренная отрисовка 3D‑геометрии, рендеринг 3D‑вида в формате изображения с камеры, рендеринг панорамного вида 3D‑сцены и т.д. Ниже приведён пример кода, показывающий, как разработчики могут отрисовать панорамный вид 3D‑сцены и сохранить его в формате изображения.

from aspose.pydrawing.imaging import ImageFormat
from aspose.pydrawing import Color
import aspose.threed as a3d

# load the scene

scene = Scene.from_file("vc.glb")

# create a camera for capturing the cube map

cam = a3d.entities.Camera(a3d.entities.ProjectionType.PERSPECTIVE)
cam.near_plane = 0.1
cam.far_plane = 200
cam.rotation_mode = a3d.entities.RotationMode.FIXED_DIRECTION
scene.root_node.create_child_node(cam).transform.set_translation(5, 6, 0);

# create two lights to illuminate the scene

scene.root_node.create_child_node(a3d.entities.Light("", a3d.entities.LightType.POINT).transform.set_translation(-10, 7, -10)
light = a3d.entities.Light()
light.color = Color.cadet_blue
scene.root_node.create_child_node(light).transform.set_translation(49, 0, 49)

# create a renderer

# Create a cube map render target with depth texture, depth is required when rendering a scene.

rt = renderer.render_factory.create_cube_render_texture(a3d.render.RenderParameters(False), 512, 512)

# create a 2D texture render target with no depth texture used for image processing
final = renderer.render_factory.CreateRenderTexture(a3d.render.RenderParameters(False, 32, 0, 0), 1024 * 3 , 1024)

# a viewport is required on the render target

rt.create_viewport(cam, a3d.utilities.RelativeRectangle.from_scale(0, 0, 1, 1))
renderer.render(rt)

# execute the equirectangular projection post-processing with the previous rendered cube map as input

equirectangular = renderer.get_post_processing("equirectangular")

# Specify the cube map rendered from the scene as this post processing's input

equirectangular.input = rt.targets[0]

# Execute the post processing effect and save the result to render target final

renderer.execute(equirectangular, final)

# save the texture into disk

final.targets[0].save("panorama.png", ImageFormat.PNG)

Работа с анимацией в 3D-документе

Aspose.3D for Python via .NET позволяет разработчикам создавать и работать с анимациями в 3D‑документах, используя библиотеку Python. Библиотека включает многочисленные возможности для работы с анимациями, такие как рендеринг анимированной сцены, настройка целевой камеры в 3D‑файле, создание скелетных анимаций, работа с морф‑таргетами и смешивание нескольких анимаций. Ниже приведён пример, демонстрирующий, как создать простую анимацию с помощью команд Python.

import clr
clr.AddReference("Aspose.3D")
from Aspose.ThreeD import *

# create a new scene
scene = Scene()

# create a new camera
camera = Camera()
camera.Name = "Camera"
scene.RootNode.CreateChildNode(camera)

# create a new mesh
mesh = Mesh()
mesh.Name = "Mesh"
vertices = Vector3[]
vertices.append(Vector3(0, 0, 0))
vertices.append(Vector3(0, 1, 0))
vertices.append(Vector3(1, 1, 0))
vertices.append(Vector3(1, 0, 0))
mesh.Vertices = vertices
mesh.Triangles = [0, 1, 2, 0, 2, 3]

# create a new node for the mesh
meshNode = Node()
meshNode.Name = "MeshNode"
meshNode.Translation = Vector3(0, 0, 0)
meshNode.CreateChildNode(mesh)

# add the mesh node to the scene
scene.RootNode.CreateChildNode(meshNode)

# create a new animation track for the mesh node
track = AnimationTrack(meshNode, AnimationTargetType.Translation)

# create a new keyframe at time 0
keyframe1 = Keyframe()
keyframe1.Time = 0
keyframe1.Value = Vector3(0, 0, 0)
track.Keyframes.Add(keyframe1)

# create a new keyframe at time 1
keyframe2 = Keyframe()
keyframe2.Time = 1
keyframe2.Value = Vector3(0, 0, 5)
track.Keyframes.Add(keyframe2)

# create a new animation clip
clip = AnimationClip("Clip")
clip.Duration = 1
clip.Tracks.Add(track)

# add the animation clip to the scene
scene.Animations.Add(clip)

# save the scene to a file
scene.Save("animation.fbx", FileFormat.FBX7400ASCII)

Работа с полигонами с использованием Python API

Aspose.3D for Python via .NET позволяет разработчикам добавлять и управлять полигональными сетками в их 3D‑моделях внутри Python‑приложений. Библиотека поддерживает различные функции, связанные с управлением полигональными сетками, такие как загрузка полигональной сетки из файла, создание полигональной сетки, преобразование всех полигонов в треугольники в 3D‑модели, экспорт полигональной сетки в файл и многое другое. Ниже приведён пример, показывающий, как пользователи могут создать полигональную сетку, создав объект Mesh и добавив в него вершины и грани.

# Create a mesh
mesh = Mesh()

# Add vertices
mesh.Vertices.Add(Vector3(0, 0, 0))
mesh.Vertices.Add(Vector3(0, 0, 1))
mesh.Vertices.Add(Vector3(0, 1, 0))
mesh.Vertices.Add(Vector3(1, 0, 0))

# Add faces
mesh.Faces.AddPolygonFace(0, 1, 2)
mesh.Faces.AddPolygonFace(0, 1, 3)
mesh.Faces.AddPolygonFace(0, 2, 3)
mesh.Faces.AddPolygonFace(1, 2, 3)

# Export the polygon mesh to a file

# Create a scene and add the mesh to it
scene = Scene()
scene.RootNode.CreateChildNode(mesh)

# Save the scene to a file
scene.Save("mesh.obj", FileFormat.WavefrontOBJ)