Pop.Box/docs/Skins.md
2016-04-16 23:57:21 -07:00

1.4 KiB

Skins

Note: This system is mostly an after-thought right now, and will probably be replaced with something else entirely.

Skins are simple tables containing information to style a variety of elements. Use pop.skin() to apply a skin to an element and its children. Skins are loaded from the skins directory.

Note: Skins are only applied on elements as-is. You can't change elements added in the future by setting a skin, or change a skin to modify elements that have had it applied. In the future, I might change this. (This skinning system is basically a placeholder.)

Usage: pop.skin(element, skin, depth)

  • element is the element to start with.
  • skin is the skin (a table).
  • depth is how many levels of children of the element should be skinned. Defaults to skinning as many levels of children as there are.

Alternately, you can think of depth as a boolean for "don't recurse". By setting it to true, you can stop skinning children. false (and default behavior) will skin all levels of children.

What's inside a skin

  • color - A table of RGBA values (see love.graphics.setColor), used as a foreground color (currently for text elements only).
  • background - A supported Drawable, used for backgrounds (currently used on box elements only).
  • font - A Font.