Element-functions
Pedro Gimeno edited this page 5 years ago

Raw Functions

The following functions are defined within an element. Neither is called explicitly.

element = Gspot[elementtype](wiki/this, Gspot, label, pos, parent)

Element constructor. See Elements

element:draw(pos)

Draws element this.

Called by Gspot:draw()

Inherited Functions

The following functions are inherited from Gspot.util

element:setshape(shape)

Sets element.shape = shape or 'rect' and sets element.pos.r if not set.

element:drawshape(pos)

Draws element's shape based on element.shape and pos

element:rect(mode)
element.rect(pos, mode)

A shortcut to love.graphics.rectangle(mode, element.pos.x, element.pos.y, element.pos.w, element.pos.h) or love.graphics.rectangle(mode, pos.x, pos.y, pos.w, pos.h)

element:setimage(img)
element:setimage()

Loads image img or element.img using love.graphics.newImage(img) and returns the resulting image.

Called by Gspot:element()

element:drawimage()

Draws the element's image, positioned relative to the element, preserving colour and transparency.

element:setfont(font, size)
element:setfont(size)
element:setfont()

Loads font font or element.style.font using love.graphics.newFont(font, size) or love.graphics.newFont(size) and sets element.style.font.

If no parameters are set, clones element.style without a font index, allowing styling to fall back on parent.style

Called by Gspot.text.load()

element:getpos()

Returns a new pos representing element's absolute position.

element:withinrect(rect)
element.withinrect(pos, rect)
element.withinrect(element, rect)

Returns trueif point pos.x, pos.y or element.pos.x, element.pos.y lies within the bounds of rect or rect.pos.

Returns false otherwise.

element:containstpoint(point)

Where point is a table containing at least x, y.

Returns true if point falls within the bounds of element's shape.

element:withinrect(point)

Where rect is a table containing at least x, y, w, h.

Returns true if point falls within the bounds of rectangle rect.

element:getdist(target)
element.getdist(pos, target)
element.getdist(element, target)

Returns the distance between points pos.x, pos.y or element.pos.x, element.pos.y and target.x, target.y or target.pos.x, target.pos.y.

element:withinradius(radius)
element.withinradius(pos, radius)
element.withinradius(element, radius)

Returns trueif point pos.x, pos.y or element.pos.x, element.pos.y lies within radius.r of point radius.x, radius.y or radius.pos.x, radius.pos.y.

Returns false otherwise.

element:getparent()

Returns the topmost element (lowest in draw order) of element's heirarchy, or element if element has no parent.

element:getmaxh()

Returns the accrued height of element's children.

element:getmaxw()

Returns the accrued width of element's children.

element:addchild(child, autostack)

Adds child to element.children, sets child.parent to element, and re-assigns child.style's inheritance.

If autostack is a number, stacks child this many across, before starting a new line. If autostack is "grid", stacks child across, limiting to element.pos.w before starting a new line. If autostack is "horizontal" or "vertical", stacks child beside or below element.children, excluding element.scroller.

element:remchild(child)

Removes child from element.children sets child.parent to nil, adjusts child.pos to maintain its absolute positioning, and re-assigns child.style's inheritance to Gspot.style without changing values.

element:replace(replacement)

Replaces element with replacement, at the same level in the draw order.

element:getlevel()

Returns element's position in the draw order, lower values being drawn first.

element:setlevel(level)

Shifts element and it's children to level in the draw order. If not level, brings element and its children to the top, placing them last in draw order, in their proper order.

element:show()

Sets element.display to true, so it will be drawn and respond to input.

Repeats this process for all elements lower down in the element heirarchy.

element:hide()

Sets element.display to false, so it will no longer be drawn or respond to input.

Repeats this process for all elements lower down in the element heirarchy.

element:focus()

Gives element focus, allowing it to accept keyboard input.

Use Gspot:unfocus() to unset focus. See Gspot functions