texture:releaseSelf()

类型 函数
对象 TextureResource
库 graphics.*
版本 版本 2024.3703
另请参阅 graphics.releaseTextures()
TextureResource

概述

graphics.newTexture() API预加载纹理/图像并防止其被处置，即使没有显示对象使用它。 要释放 TextureResource 对象并恢复纹理的自动管理，您必须通过调用 texture:releaseSelf() 来释放它。

或者，在更广泛的范围内，可以使用 graphics.releaseTextures() 来释放共享相同 类型 参数的所有纹理对象。

注意事项

调用 texture:releaseSelf() 后，只有 texture 句柄被释放并变为无效。 所有使用 TextureResource 的显示对象都将保留其句柄。 TextureResource 本身只有在没有显示对象使用它之后才会被处置。

示例

local texture = graphics.newTexture( { type="image", filename="background.png" } )

-- If you no longer need the texture, release it to prevent memory leaks
texture:releaseSelf()