Skip to content

jr-garcia/AssimpCy

Repository files navigation

AssimpCy

PyPI - version PyPI - Python Version PyPI - Satus PyPI - License PyPI - Downloads

BUILD STATUS

Linux Build Status

Documentation Build Status


Fast Python bindings for Assimp, Cython-based, BSD3 license.

It uses the same function names as the original library, so examples from c++ tutorials can be used with minor changes.

It has been tested on:

  • Windows 7, 10
  • Linux
  • Mac
  • Python 3.7 - 3.10
  • Pypy

Example usage:

from assimpcy import aiImportFile, aiPostProcessSteps as pp 
flags = pp.aiProcess_JoinIdenticalVertices | pp.aiProcess_Triangulate 
scene = aiImportFile('somemodel.3ds', flags)
print('Vertex 0 = {}'.format(scene.mMeshes[0].mVertices[0]))

Matrices, quaternions and vectors are returned as Numpy arrays.


Requirements:

  • Numpy >= 1.21.3

(Assimp 5.0.1 is included in the binary wheel)

Open Asset Import Library (assimp)

Copyright (c) 2006-2016, assimp team
All rights reserved.

Installation:

The easiest way is with Pip:

pip install assimpcy

If that doesn't work on your system, please check Installation for instructions.


Missing:

  • Cameras
  • Lights
  • Export functionality

Those might be added in the future.


Documentation

Read The Docs


Bugs report and Contributioms

Please follow the guide on the wiki


And what about the name? Well, cyassimp was already taken 😞