Instalación

Requiere Python 3.7–3.12. Instalar con ‘pip install aspose-3d-foss’.Pure Python: no se requiere compilación.

Aspose.3D FOSS para Python se distribuye como un paquete puro-Python en PyPI. No hay extensiones nativas que compilar, no hay bibliotecas del sistema que instalar y no se requiere Microsoft Office ni otro tiempo de ejecución de terceros.

Requisitos previos

1. Install via pip (Recommended)

La forma más sencilla de instalar Aspose.3D FOSS es directamente desde PyPI:

pip install aspose-3d-foss

pip descargará e instalará el paquete y lo registrará en tu entorno. No se necesita configuración posterior a la instalación.

Para instalar una versión fijada para compilaciones reproducibles:

pip install aspose-3d-foss==26.1.0

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

Usar un entorno virtual mantiene la biblioteca aislada de otros proyectos Python y evita conflictos de versiones.

Crear y activar un entorno virtual:

##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

Instalar la biblioteca dentro del entorno activado:

pip install aspose-3d-foss

Registrar dependencias para reproducibilidad:

pip freeze > requirements.txt

Para recrear el entorno en otra máquina:

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

3. Verify the Installation

Después de instalar, verifica que la biblioteca se importe correctamente:

from aspose.threed import Scene

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

Producto esperado :

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

También puedes comprobar la versión instalada con pip:

pip show aspose-3d-foss

Esto mostrará la versión, el autor y la licencia (MIT).

Inicio rápido: Cargar una escena y examinarla

El siguiente script carga un archivo 3D, imprime información sobre cada nodo de malla y vuelve a exportar la escena al formato 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")

Si aún no tienes un archivo OBJ, la biblioteca también puede crear una escena desde cero:

from aspose.threed import Scene

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

Notas de la plataforma

Windows, macOS, Linux: La biblioteca es idéntica en todas las plataformas. No hay rutas de código específicas de la plataforma ni extensiones binarias.

Docker / serverless: Debido a que no hay dependencias de paquetes del sistema, la biblioteca funciona dentro de imágenes Docker slim (como python:3.12-slim) sin instalar paquetes adicionales de apt o yum.

CI/CD: Agregar pip install aspose-3d-foss a la etapa de dependencias de tu canal CI. No se requiere configuración adicional.

Conda: Si su proyecto usa Conda, instale la biblioteca desde PyPI dentro de un entorno Conda:

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

Recursos adicionales

• Página del producto: Visión general, resumen de características y testimonios
• Guía del desarrollador: Referencia completa de la API con ejemplos de código
• Características y funcionalidades: Soporte de formatos, grafo de escena, materiales, utilidades matemáticas y más