.. _stdlib_models_import_window_model:

===================
Model File Import
===================


++++++++++++++++++++++++++++++
Import Settings Description
++++++++++++++++++++++++++++++

.. image:: model_inspector_import.jpg
    :width: 300
    :alt: model_inspector_import

* **Scale**: The global scale of the scene.

* **Improve Cache Locality**: Reorders triangles for better vertex cache locality.
    This feature tries to improve the ACMR (average post-transform vertex cache miss ratio) for all meshes.
    The implementation runs in O(n) time.

.. note::
    This optimization may decrease actual rendering performance.
    It is recommended to profile the application before and after using this optimization to ensure it is beneficial.

* **Find Same Meshes**: Finds identical mesh instances and joins them into one.

.. note::
    This post-process can take a while because it compares all meshes with each other by vertices.

* **Join Meshes**: Joins meshes with the same materials and vertex layout.
    If a mesh has skinning, this process will be skipped.

* **Join Identical Vertices**: Merges identical vertices to reduce vertex count.

* **Remove Redundant Materials**: Searches for redundant or unreferenced materials and removes them.

* **Pre Transform Vertices**: Applies node transformations to vertices. It can also merge meshes with the same materials into one mesh.

* **Optimize Scene Tree**: Collapses and joins nodes without animations, bones, lights, or cameras assigned.

* **Flip UVs**: Flips all UV coordinates along the y-axis and adjusts material settings and bitangents accordingly.

* **Flip Winding Order**: Adjusts the output face winding order to be clockwise (CW). The default face winding order is counterclockwise (CCW).

* **Generate Normals**: Imports normals from the model file or generates them.
    - **ImportNormals**: Uses normals from the model.
    - **Hard Normals**: Ignores normals present in the model and generates new ones.
    - **SmoothNormals**: Ignores normals present in the model and generates and smooths new ones.

* **Import Meshes**: Enables or disables importing meshes from the model file.

* **Import Materials**: Enables or disables importing materials from the model file.