===========================================
Asset Importer
===========================================
Asset Importer is the UI frontend that utilizes extension omni.kit.asset_converter to convert other formats into USD. It mainly supports OBJ, FBX, and glTF formats currently.

Importing Assets in |composer| (Video)
-----------------------------------------

This video shows how to use the Import and Convert Feature.

.. raw:: html

    <div style="width: 100%;display: inline-block;position: relative;">
        <div id="dummy" style="margin-top: 56%;">
        </div>
        <div align="center">
        <div id="kaltura_player_1" style="position:absolute;top:0;left:0;left: 0;right: 0;bottom:0;border:solid thin black;"></div>
        <script type="text/javascript" src="https://cdnapisec.kaltura.com/p/2935771/embedPlaykitJs/uiconf_id/46302491"></script>
        <script type="text/javascript">
            try {
            var kalturaPlayer = KalturaPlayer.setup({
            targetId: "kaltura_player_1",
            provider:
            { partnerId: 2935771, uiConfId: 46302491 }
            });
            kalturaPlayer.loadMedia(
            {entryId: '1_o203424d'}
            );
            } catch (e)
            { console.error(e.message) }
        </script>
        </div>
    </div>


Importing files
------------------------

Importing assets is done by right clicking in the Content Browser and selecting Import and Convert.
Accepted File Formats for conversion are FBX, OBJ and GLTF.

.. image:: /content/images/kit_reference-guide_import_fbx.png
	:align: center

Selecting a file will trigger a dialogue giving options on the import function.

.. image:: /content/images/kit_reference-guide_import_options.png
	:align: center

========================= ==========================================================
Option                    Use
========================= ==========================================================
Materials                 | Checked will import materials and textures if available.
UsdPreviewSurface         | Checked will import materials as UsdPreviewSurface instead of MDL.
                          | "Import Materials" must be checked for this option to work.
Cameras                   | Checked will import cameras if present in the asset.
Lights                    | Checked will import lights if present in the asset. This only applies
                          | to FBX import currently.
Smooth Normals            | Assigns/Reassigns Smoothing Groups
Meter as World Unit       | Checked will import the asset with 1 meter per world unit.
                          | By default, it will import the asset with 1 centimeter per world unit.
Create /World             | Checked will import asset with the root prim as path "/World".
Merge Static Meshes       | Checked will merge all static meshes if possible as a single one.
Convert to                | The target folder of outputs.
========================= ==========================================================