splashy is a simple and basic library for LÖVE, that allows the easy implementation of splash screens to any project.

To install, extract the splashy folder to somewhere in your project (usually a /libs folder)

Then setup your main.lua like this:

splashy = require 'path/to/splashy/folder'

function love.draw()

	splashy.draw()

end

function love.update(dt)

	splashy.update(dt)

end

Then you'll have a barebones installation complete!

You can see the code demo of the library here.

splashy.addSplash(image, duration, index, color, scale)

• image is a drawable (usually an image) to be drawed in a splash.
• duration is an optional argument, to set how long the image fade will last. It must be a positive number. (default: 2)
• index is an optional argument allowing to set custom splash index number for any reason you would need to do so.
• color is an optional argument that will determine the background color of the splash screen
• scale is an optional argument that will affect the final size of the splash screen image

splashy.onComplete(func)

• func is a callable function to be ran once all the splash screens are finished.

There are 2 main ways of using this:

splashy.onComplete(function() print("This is ran one time after all splashes are finished.") end)

splashy.onComplete(printFinishText)

function printFinishText()

	print("This is ran one time after all splashes are finished.")

end

Using this function is useful for switching gamestate.

This function skips the current splash screen onto the next one:

splashy.skipSplash()

Whilst this one skips all splashes, running the onComplete function:

splashy.skipAll()

Use this function to set the screen resolution that will be used in the internal calculations. This is useful if you use a screen scaling library, like push or TLfres.

splashy.setScreenSize (width, height)

tween.lua is used for the tweening/fading.

Check LICENCE.md for more info.

v1.0:

• First Release.

This library has/is a learning experience for me, if theres any problems be sure to raise them in the issues.

Pull requests are welcome :)