Advanced Usage

ufbx

The Lightweight FBX Importer is designed to streamline the configuration process, abstracting complex settings for most users. However, for those who require fine-grained control over the loading process or need to configure advanced options, the ufbx library—used internally by the importer—offers a comprehensive set of features and APIs. The official ufbx documentation provides detailed information on all available options.

Note: Utilizing these advanced features requires proficiency in unsafe C# programming, including expertise in pointers and memory management.

Official ufbx C API

Explore the complete ufbx C API reference:
Official ufbx API Documentation

ufbx C# Wrapper API

The ufbx C# wrapper replicates the functionality of the original ufbx C API, providing a familiar interface for C# developers:
ufbxWrapper API Documentation

Important Disclaimer

Before working directly with the ufbx API, please review the Disclaimer page for critical information and guidelines.

stb_image

The Lightweight FBX Importer uses Unity's built-in texture loader by default, which supports only PNG and JPEG textures. However, it also includes stb_image, which supports a wider range of texture formats (JPEG, PNG, TGA, BMP, PSD, GIF, HDR, PIC). To enable stb_image in the Lightweight FBX Importer, add USE_STB_IMAGE to your Script Define Symbols in the Player Settings.

Multi-Thread

Multi-threaded model parsing is disabled by default in the Lightweight FBX Importer. To enable it, add USE_THREADS to your Script Define Symbols in the Player Settings. This option only works with asynchronous loading methods and only on Unity platforms that support threading.