Description
This folder contains resources for building a simple demo decompressing and rendering Draco within Unity.
If you are looking for more information on using Draco within Unity, DracoUnity is a much better resource. There are more samples as well as support for more platforms.
In this folder we currently support two types of usages:
- Import Draco compressed mesh as assets during design time.
- Load/decode Draco files in runtime.
Prerequisite
To start, you need to have the Draco unity plugin. You can either use the prebuilt libraries provided in this folder or build from source. Note that the plugin library for different platforms has different file extension.
Platform | Library name |
---|---|
Mac OS | dracodec_unity.bundle |
Android | libdracodec_unity.so |
Windows | dracodec_unity.dll |
Prebuilt Library
We have built library for several platforms:
Platform | Tested Environment |
---|---|
.bundle | macOS Sierra + Xcode 8.3.3 |
armeabi-v7a(.so) | Android 8.1.0 |
.dll | Win10 + Visual Studio 2017 |
Build From Source
See BUILDING.md for information on building Draco Unity plug-ins from source.
Create Draco Demo Unity Project
Create a new 3D project in Unity.
Copy Library to Your Project
Copy the plugin library to your Unity project in Assets/Plugins/
.
For Android Arm7:
cp path/to/your/libdracodec_unity.so path/to/your/Unity/Project/Assets/Plugins/Android/libs/armeabi-v7a/
For Android Arm8:
cp path/to/your/libdracodec_unity.so path/to/your/Unity/Project/Assets/Plugins/Android/libs/arm64-v8a/
For Mac:
cp path/to/your/dracodec_unity.bundle path/to/your/Unity/Project/Assets/Plugins/
For Win:
cp path/to/your/dracodec_unity.dll path/to/your/Unity/Project/Assets/Plugins/
Copy Unity Scripts to Your Project
cp unity/DracoDecodingObject.cs path/to/your/Unity/Project/Assets/
cp unity/DracoMeshLoader.cs path/to/your/Unity/Project/Assets/
Player Settings Change
Open player settings. Make sure Allow unsafe code
is checked, so Unity can load our plug-ins.
Copy Draco Mesh to Your Project
Because Unity can only recognize file extensions known to Unity, you need to change your compressed .drc file to .drc.bytes so that Unity will recognize it as a binary file. For example, if you have file bunny.drc
then change the file name to bunny.drc.bytes
.
cp path/to/your/bunny.drc path/to/your/Unity/Project/Assets/Resources/bunny.drc.bytes
Load Draco Assets in Runtime
For example, please see DracoDecodingObject.cs for usage. To start, you can create an empty GameObject and attach this script to it. DracoDecodingObject.cs will load bunny.drc.bytes
by default.
Enable Library in Script Debugging
If you have library for the platform you are working on, e.g. dracodec_unity.bundle
for Mac or dracodec_unity.dll
for Windows. You should be able to use the plugin in debugging mode.
Import Compressed Draco Assets
In this section we will describe how to import Draco files (.drc) to Unity as other 3D formats at design time, e.g. obj, fbx. Note that importing Draco files doesn't mean the Unity project will export models as Draco files.
Copy DracoFileImporter.cs which enables loading (This file is only used for import Draco files):
cp DracoFileImporter.cs path/to/your/Unity/Project/Assets/Editor/
If you have followed the previous steps, you just need to copy your asset, e.g. bunny.drc.bytes
, to Your/Unity/Project/Assets/Resources
, the project will automatically load the file and add the models to the project.