object:invalidate()

Type Function
Object SnapshotObject
Library display.*
Return value none
Revision Release 2024.3703
Keywords invalidate, render to texture
See also display.newSnapshot()
snapshot.canvas
snapshot.group

Overview

Invalidating snapshots tells Corona to invalidate its texture cache and re-render the children to a texture on the next render pass.

Unlike most other objects in Corona, snapshots will not automatically recognize when children have been modified. This is because there's a cost to rendering to a texture.

Syntax

snapshot:invalidate()
snapshot:invalidate( "canvas" )

Group vs Canvas