.. _stdlib_model_scripting:

====================
Model Scripting
====================

++++++++++++++++++++++
Model Asset Request
++++++++++++++++++++++

The simplest way to get a model asset from code::

    let model = request_model("model.fbx")


++++++++++++++++++++++
Model Instantiation
++++++++++++++++++++++

.. line-block::

    Each model asset contains a prefab resource, so we can use the prefab API to instantiate models.

    :ref:`request_prefab (path: string) : PrefabId <function-prefab_resource_request_prefab_string>`
    :ref:`instantiate_prefab (prefabId: PrefabId; data: NodeData = NodeData()) : NodeId <function-prefab_resource_instantiate_prefab_PrefabId_NodeData>`


Example::

    // Request prefab from file "model.fbx"
    let prefab = request_prefab("model.fbx")
    // Instantiate prefab at position (10, 0, 0) with scale 2
    let root = instantiate_prefab(prefab, float3(10, 0, 0), quat4(), float3(2))