FAB
Floating Action Buttons are the most important buttons in Material-Design, they are used to highlight the most important action in the whole activity.
They are just a circle with an icon, but they also have shadows.
Since shadows are rather expensive on the hardware, the libraries provide preset assets for circles with shadows.
Well the FAB lib is intended to create those circles with shadows. It has 5 levels of Z-Depth (just like the Shadow library):
Using this lib is pretty straight forward, first require the fab.lua into your project:
local fab = require "material-love.libs.fab"The API is the same as with circles, except that it doesn't require the first parameter (Draw Mode):
fab(x,y,radius,depth)Here depth is the Z-Depth, that, as said before, should be a value from 1 to 5 (Floating point values are not valid).
If the radius value is nil it will default to 28 which is the default for a FAB button, if it is "mini" then it will be 20.
The color used to draw the FAB button is the one set with love.graphics.setColor()
Note: You should take into account that this lib first draws a white background for the circle, so it will delete the content behind it. if you want to draw something on top try using a stencil and canvas to do so.
FAB doesnt take care of the icon by itself, read the documentation for Icons and DrawIcons in order to know how to get an icon on top of your FAB Button.
This files are required in order to use the FAB lib in your project, be sure to have them all
libs/fab.luaassets/fab-1.pngassets/fab-2.pngassets/fab-3.pngassets/fab-4.pngassets/fab-5.png