Sprite:setLayoutParameters

Available since: Gideros 2018.9

Class: Sprite

Description

Gideros Layout arranges a sprite's children into cells of a grid. With this method, you tell the parent's sprite how the rows and columns of the layout grid should be sized.

If there is extra space available after applying minimum widths and heights, it is distributed according to relative weights of each row/column.

Gideros layout system is heavily based on Java GridBagLayout principle. See here for more explanation: https://www.math.uni-hamburg.de/doc/java/tutorial/uiswing/layout/gridbag.html

The following parameters apply:

• columnWidths: an array of minimum width for each column
• rowHeights: an array of minimum height for each row
• columnWeights: an array of relative weights for each column
• rowWeights: an array of relative weights for each row
• insetTop: the top margin
• insetLeft: the left margin
• insetBottom: the bottom margin
• insetRight: the right margin

Specifying a nil table will clear layout parameters.

Sprite:setLayoutParameters(layout)

Parameters

layout: (table) Table of layout parameters.

Examples

Example:

-- LAYOUT CONSTRAINTS @hgy29
local ticket = Bitmap.new(Texture.new("gfx/vip/ticket.png"))
local text = Bitmap.new(Texture.new("gfx/vip/text.png"))
 
-- Use auto layout on ticket to center text automatically
ticket:setLayoutParameters{ rowWeights = {1}, columnWeights = {1} }
text:setLayoutConstraints{}

ticket:addChild(text)
stage:addChild(ticket)