Function LuaNewTexture

engine/gui/src/gui_script.cpp:2187–2232

create new texture * Dynamically create a new texture. * * @name gui.new_texture * @param texture_id [type:string|hash] texture id * @param width [type:number] texture width * @param height [type:number] texture height * @param type [type:string|constant] texture type * * - `"rgb"` - RGB * - `"rgba"` - RGBA * - `"l"` - LUMINANCE

     * ```
     */
    static int LuaNewTexture(lua_State* L)
    {
        int top = lua_gettop(L);
        (void) top;

        const dmhash_t name = dmScript::CheckHashOrString(L, 1);

        int width = luaL_checkinteger(L, 2);
        int height = luaL_checkinteger(L, 3);
        const char* type_str = luaL_checkstring(L, 4);
        size_t buffer_size;
        luaL_checktype(L, 5, LUA_TSTRING);
        const char* buffer = lua_tolstring(L, 5, &buffer_size);
        Scene* scene = GuiScriptInstance_Check(L);

        bool flip = false;
        if (top > 5)
        {
            luaL_checktype(L, 6, LUA_TBOOLEAN);
            flip = (bool)lua_toboolean(L, 6);
        }

        // If we don't flip the image, it will appear upside down using OGL texture coords,
        // since we will upload the data top-row first instead of bottom-row first.
        // This is actually what users expect the flip switch to mean, so we invert the
        // flip here so the default case will be to "correctly" flip the image.
        flip = !flip;

        dmImage::Type type = ToImageType(L, type_str);
        dmImage::CompressionType compression_type = ToImageCompressionType(type_str);
        Result r = NewDynamicTexture(scene, name, width, height, type, compression_type, flip, buffer, buffer_size);

        if (r == RESULT_OK)
        {
            lua_pushboolean(L, 1);
            lua_pushnil(L);
        }
        else
        {
            lua_pushboolean(L, 0);
            lua_pushnumber(L, r);
        }

        assert(top + 2 == lua_gettop(L));
        return 2;
    }

    /*# delete texture
     * Delete a dynamically created texture.