Fast OBJ importer for Unity

A fast obj importer and reader for Unity. Should have runtime support.

This package uses the thisistherk/fast_obj implementation for reading OBJ files, which is licensed under the MIT License.

How to add this to your project

Follow the guide in https://docs.unity3d.com/Manual/upm-ui-giturl.html, and use the following git url:

https://github.com/equinor/FastObjUnity.git#v1.0.0 (Replace the version tag with the latest "Release" version you want to use)

How to use

Unity does not allow to override native importers so we have to cheat. There are two possible workarounds:

• A: Rename your OBJ files to *.obj_fast before import
• or B: Add definition flag FASTOBJ_AUTORENAME in Project Settings -> Script Compilation -> Scripting Define Symbols of your Unity project

Limitations and known issues

• Only ASCII file paths are supported
• Only ASCII file encoding is supported
• Only triangulated meshes are supported
• Skips materials and textures

Benchmarks

Intel Xeon Gold 6136 3.00GHz, 128 GB RAM, Samsung SSD 970 EVO Plus 2TB

OBJ size	Groups	Triangles	Vertices	Unity 2020.3.12f1 native	FastObjUnity (raw)	FastObjUnity (Optimize)
182 MB	1	1 533 557	1 561 241	00:32:25	00:00:16	00:06:54

How to build native library

Requirements

• CMake 3.10 or later
• Visual Studio 2019 or later

git clone https://github.com/equinor/FastObjUnity
cd FastObjUnity
git submodule update --init
cd NativePlugin~
mkdir build
cd build
cmake ..

Open generated solution file.

Build.

Code of Conduct

This project follows the Equinor Code of Conduct: https://github.com/equinor/opensource/blob/master/CODE_OF_CONDUCT.md