An immediate mode GUI for the Love2D framework, forked from https://github.com/coding-jackalope/Slab to submit patches

coding_jackalope e4d8ee316f [BUGFIX][Region]: Fixed issue where user input is locked up when using the mouse wheel. 5 years ago
Internal e4d8ee316f [BUGFIX][Region]: Fixed issue where user input is locked up when using the mouse wheel. 5 years ago
API.lua e4d8ee316f [BUGFIX][Region]: Fixed issue where user input is locked up when using the mouse wheel. 5 years ago
LICENSE b9bd559fab Update LICENSE 5 years ago
README.md 2719255fd5 [README]: Updated image reference. 5 years ago
Slab.lua 0339e21ca0 [Slab Test]: Test when Slab is not in the root directory. 5 years ago
SlabDebug.lua 12be7cff96 [Layout]: Fixed issue with row index accessing nil row. Use proper column width when computing size. 5 years ago
SlabTest.lua 6508b2524d [Resources]: Reduced size of gameicons.png. 5 years ago
Style.lua dec804c4f3 [Layout]: Fixed bug where the proper column width wasn't used for auto sized windows. 5 years ago
changelog.txt ab7cc3abf7 [Layout]: Documentation. 5 years ago
conf.lua 21a2b9e226 Initial check-in. 5 years ago
init.lua 21a2b9e226 Initial check-in. 5 years ago
main.lua 21a2b9e226 Initial check-in. 5 years ago

README.md

Slab

Slab is an immediate mode GUI toolkit for the Love 2D framework. This library is designed to allow users to easily add this library to their existing Love 2D projects and quickly create tools to enable them to iterate on their ideas quickly. The user should be able to utilize this library with minimal integration steps and is completely written in Lua and utilizes the Love 2D API. No compiled binaries are required and the user will have access to the source so that they may make adjustments that meet the needs of their own projects and tools. Refer to main.lua and SlabTest.lua for example usage of this library.

Usage

Integrating this library into existing projects is very simple.

local Slab = require 'Slab'

function love.load(args)
	love.graphics.setBackgroundColor(0.4, 0.88, 1.0)
	Slab.Initialize(args)
end

function love.update(dt)
	Slab.Update(dt)
  
	Slab.BeginWindow('MyFirstWindow', {Title = "My First Window"})
	Slab.Text("Hello World")
	Slab.EndWindow()
end

function love.draw()
	Slab.Draw()
end

For more detailed information on usage of this library, refer to the Wiki.

License

Slab is licensed under the MIT license. Please see the LICENSE file for more information.

Credits

  • Dear ImGui project built by Omar Cornut and various contributors. This project was the inspiration for building an Immediate Mode GUI for Love2D specifically. If anyone is building a game or application in C++, I highly recommend using this library and its rich toolset to speed up development.
  • Kenney.nl and the Tango Desktop Project for providing icons used in this project.