object.maskScaleY

Type Number
Object DisplayObject
Library display.*
Revision Release 2024.3703
Keywords image mask, masking, clipping, bit mask
See also object.maskScaleX

Overview

Retrieves or sets the y-scale factor for the display object’s corresponding mask object, if any.

Gotchas

Increasing this value above 1.0 will increase the masked object’s content height (object.contentHeight).

Example

-- Image to be masked
local image = display.newImageRect( "image.png", 768, 1024 )
 
-- Mask
local mask = graphics.newMask( "circlemask.png" )
image:setMask( mask )
image.maskScaleX = 0.5
image.maskScaleY = 0.5