TextureResourceCanvas

概述

当指定的 类型 为 "canvas" 时，由 graphics.newTexture() 创建的对象。此纹理资源是一个内存中纹理，可以通过向其中渲染显示对象来修改该纹理。它类似于 帧缓冲对象 或 渲染目标纹理。

属性

方法

需要注意的地方

• 此类型的对象都需要手动纹理管理。如欲将其从内存中释放，在不再需要之对象时，必须 释放 对象。

• 在 Android 上，在应用暂停时，会释放纹理。这会导致它们被清除，并在应用恢复后变得无效。 يمكنك使用 texture:invalidate( "cache" )（文档）来恢复纹理的内容，前提是缓存没有被手动操作。

示例

local tex = graphics.newTexture( { type="canvas", width=128, height=128 } )

-- Create display object with texture as contents
local rect = display.newImageRect(
    tex.filename,  -- "filename" property required
    tex.baseDir,   -- "baseDir" property required
    display.contentWidth,
    display.contentHeight
)
rect.x = display.contentCenterX
rect.y = display.contentCenterY

-- Set background color to be applied if texture is cleared
tex:setBackground( 0, 0, 1 )

-- Create a circle and draw/render it to the texture
local circ = display.newCircle( 0, 0, 64 )
circ:setFillColor( { type="gradient", color1={0,0.2,1}, color2={0.8,0.8,0.8}, direction="down" } )
tex:draw( circ )

-- Create a polygon and draw/render it to the texture
local poly = display.newPolygon( 0, 0, {0,-55,14,-18,52,-18,22,8,32,45,0,22,-32,45,-22,8,-52,-18,-14,-18} )
poly:setFillColor( 0.2, 1, 0.2 )
tex:draw( poly )

-- Schedule texture objects to be rendered to texture before next frame
tex:invalidate()

-- Function to restore texture on resume
local function onSystemEvent( event )
    if ( event.type == "applicationResume" ) then
        tex:invalidate( "cache" )
    end
end

-- Set up a system event listener
Runtime:addEventListener( "system", onSystemEvent )