Asynchronous Importer and run-time Loader for Unity
Requires Unity 5.5.4 or higher.
Load 3D models (currently only OBJ) into Unity scene, both at run-time and in Editor mode, importing them into unity project as assets. To exploit the same features implemented in the run-time loader it can also be used as asset importer (a prefab with its dependencies is created in the project).
3D models can be loaded both from files and from URLs.
OBJ model imported with AsImpL
Some improvements are made in OBJ import compared with the current version of Unity: * bump map * bump map is converted into a normal map * computation of normal maps and tangents * specular map * specular map is converted to glossness map (metallic texture) * reflection map * reflection map is replaced with the ambient reflection (skybox or reflection probes, if available) * opacity map * diffuse and opacity maps are blended together in the albedo texture * vertex colors * if vertex colors are available (and no material library is defined) they are loaded and used to color the mesh * flag to use an Unlit shader for materials with the lighting rendered to the diffuse texture * vertical axis conversion * mesh colliders * mesh colliders can optionally be generated from the loaded mesh, even with convex mesh generation
Example of a model imported with AsImpL (left) and Unity 5.5 (right)
Example of models imported with AsImpL (above) and Unity 5.5 (below)
This project was started because of these requirements (partly addressed by some existing projects): * load models in an asynchronous way (without "freezing" the scene during loading) * load more models concurrently * show the loading progress on a UI * import the loaded models as assets into Unity projects * prepare the loader to be extended with different file formats
A menu AsImpL is added to the Unity Editor main menu, with a sub-menu Import OBJ model that opens a window. In this window you can set paths and import settings, then you can press Import to start importing the selected model. A progress bar shows the import progress and phase until the model has been loaded (or until you press Cancel to abort the process). A utility menu item
Capture screenshotwas added to take a screenshot, the file is named automatically and saved into the main project folder, then the folder is opened in your file manager.
A sub-menu Import OBJ model [AsImpL] is added to the Unity Editor Asset menu. It opens a window where you can set paths and import settings, then you can press Import to start importing the selected model. A progress bar shows the import progress and phase until the model has been loaded (or until you press Cancel to abort the process). To the Window menu a sub-menu item
Capture screenshot [AsImpL]is added to take a screenshot, the file is named automatically and saved into the main project folder, then the folder is opened in your file manager.
An example scene is provided to demonstrate how the importer can be connected to a UI and extended with new features.
The code in this project should be prepared to be extended for supporting other file formats. Even if the only supported format is currently OBJ, the idea is to create a common framework on which the support for other formats could be developed, allowing the exchange of data with other applications.
The import process is divided into separate phases: * texture asset import (if importing assets) * file parsing and data filling * game object creation in Unity scene * materials, meshes and prefab assets creation (if importing assets)
You can find the complete AsImpL documentation in
Documentationfolder both as compressed HTML and zipped HTML.
To load some OBJ files you can add a ObjectImporter to a game object and call its ImportModelAsync() method from a MonoBehavior, see
001_Import_SimpleTestexample scene in
Assets/AsImpL/Examples, where you can find also a more advanced example in
002_Import_CustomImporter. In EXAMPLES.md you can find details about each example.
This work started looking at the Runtime OBJ Loader, from which some source code (in particular TextureLoader.cs and parts of LoaderObj) came. The OBJ file loader is inspired by Runtime OBJ Loader, unity-obj-loader, unity-remote-obj-loader and all the people who shared their ideas (e.g. Bartek Drozdz). The first asynchronous loading implementation comes from unity-remote-obj-loader. The triangulation implementation is derived from Erik Nordeus's tutorial.
Thanks in advance to all the people who contributed and will contribute in any way to this project.
Contributions from you are welcome!
If you find bugs or you have any new idea for improvements and new features you can raise an issue on GitHub (please follow the suggested template, filling the proper sections). To open issues or make pull requests please follow the instructions in CONTRIBUTING.md.
Code released under the MIT License.
This is on GitHub.
To try this project with Unity press the button Clone or download and choose Download ZIP. Save and unzip the archive to your hard disk and then you can open it with Unity.