Function Script_Set

engine/gameobject/src/gameobject/gameobject_script.cpp:768–860

sets a named property of the specified game object or component, or a material constant * * @name go.set * @param url [type:string|hash|url] url of the game object or component having the property * @param property [type:string|hash] id of the property to set * @param value [type:number|boolean|hash|url|vector3|vector4|quaternion|resource] the value to set * @param [o

     * go.set("#my_component", "some_property", some_value, { keys = { "root", "child_node" } })
     */
    int Script_Set(lua_State* L)
    {
        DM_LUA_STACK_CHECK(L, 0);

        DM_HASH_REVERSE_MEM(hash_ctx, 256);
        ScriptInstance* i = ScriptInstance_Check(L);
        Instance* instance = i->m_Instance;
        dmMessage::URL sender;
        dmScript::GetURL(L, &sender);
        dmMessage::URL target;
        dmScript::ResolveURL(L, 1, &target, &sender);
        if (target.m_Socket != dmGameObject::GetMessageSocket(i->m_Instance->m_Collection->m_HCollection))
        {
            luaL_error(L, "go.set can only access instances within the same collection.");
        }
        dmhash_t property_id = 0;

        if (lua_isstring(L, 2))
        {
            property_id = dmHashString64(lua_tostring(L, 2));
        }
        else
        {
            property_id = dmScript::CheckHash(L, 2);
        }

        dmGameObject::HInstance target_instance = dmGameObject::GetInstanceFromIdentifier(dmGameObject::GetCollection(instance), target.m_Path);
        if (target_instance == 0)
        {
            return luaL_error(L, "could not find any instance with id '%s'.", dmHashReverseSafe64Alloc(&hash_ctx, target.m_Path));
        }

        LuaToPropertyOptionsResult options_result = {};

        if (lua_gettop(L) > 3)
        {
            LuaToPropertyOptions(L, 4, &options_result);
        }

        if (lua_istable(L, 3))
        {
            lua_pushvalue(L, 3);
            lua_pushnil(L);
            while (lua_next(L, -2) != 0)
            {
                if (!lua_isnumber(L, -2))
                {
                    return luaL_error(L, "Trying to set property value '%s' as array with a non-integer key.", dmHashReverseSafe64Alloc(&hash_ctx, property_id));
                }

                int32_t table_index_lua = lua_tonumber(L, -2);

                if (table_index_lua < 1)
                {
                    return luaL_error(L, "Trying to set property value '%s' as array with a negative key (%d) is not permitted.", dmHashReverseSafe64Alloc(&hash_ctx, property_id), table_index_lua);
                }

                dmGameObject::PropertyVar property_var;