Function ResolveInstance

engine/gameobject/src/gameobject/gameobject_script.cpp:404–424

* Get instance utility function helper. * The function will use the default "this" instance by default * but if lua_gettop(L) == instance_arg, i.e. an instance reference is specified, * the argument instance_arg will be resolved to an instance. The function * only accepts instances in "this" collection. Otherwise a lua-error will be raised. * @param L lua state * @par

     * @return instance handler
     */
    static Instance* ResolveInstance(lua_State* L, int instance_arg)
    {
        ScriptInstance* i = ScriptInstance_Check(L);
        Instance* instance = i->m_Instance;
        if (lua_gettop(L) == instance_arg && !lua_isnil(L, instance_arg)) {
            dmMessage::URL receiver;
            dmScript::ResolveURL(L, instance_arg, &receiver, 0x0);
            if (receiver.m_Socket != dmGameObject::GetMessageSocket(i->m_Instance->m_Collection->m_HCollection))
            {
                luaL_error(L, "function called can only access instances within the same collection.");
            }

            instance = GetInstanceFromIdentifier(instance->m_Collection->m_HCollection, receiver.m_Path);
            if (!instance)
            {
                luaL_error(L, "Instance %s not found", lua_tostring(L, instance_arg));
                return 0; // Actually never reached
            }
        }
        return instance;
    }

    void GetComponentFromLua(lua_State* L, int index, HCollection collection, const char* component_ext, dmGameObject::HComponent* out_component, dmMessage::URL* url, dmGameObject::HComponentWorld* out_world)
    {