Add demo for loading model with Assimp

LWJGL / lwjgl3-demos

Demo suite for LWJGL 3

BSD 3-Clause "New" or "Revised" License

351 stars 89 forks source link

Add demo for loading model with Assimp #12

Closed zhanghai closed 7 years ago

zhanghai commented 7 years ago

This adds a demo for loading model with Wavefront obj and mtl format using Assimp. Rendering with lighting is also implemented in this demo.

I began to use LWJGL3 two weeks ago, but I didn't find any wiki/demo for how to load model with the new Assimp binding, so I referred to tutorials in C++ about Assimp and inspected the source of this binding, which took me a long period of time together with debugging. Hopefully this will make the experience easier for newcomers.

Screenshot: assimp-demo

httpdigest commented 7 years ago

Very nice! Two things:

I did not find any licensing/copyright information on the magnet model assets. Do you own the copyright? If not, please make sure its license allows inclusion into the lwjgl3-demos repository and add corresponding credits
You resolve the I/O resource of the model to a file name via ClassLoader.getResource().getFile(). This will not work when packaging the demo as a stand-alone jar via mvn package. Please see how other demos load assets from the classpath via DemoUtils.ioResourceToByteBuffer()

zhanghai commented 7 years ago

The magnet model is made by a friend of mine, and he has agreed to release it into public domain via the CC0 license, so I believe credits is not required in this case. Or is it still required?
I resolved the model resource with file path because in this way aiImportFile() can resolve the .mtl file under the same directory. I believed to use the DemoUtils.ioResourceToByteBuffer() method requires the implementation of an AiFileIO interface, but I did not know how it can be done according to information I had. Could you shed some light upon this? Or I'll also look into this later.