Browse Source

Update README.md

John Dodis 1 year ago
parent
commit
3d79c54e06
1 changed files with 32 additions and 1 deletions
  1. 32 1
      README.md

+ 32 - 1
README.md

@@ -1,3 +1,34 @@
 # lovr-ui2d
 
-WIP
+### An immediate mode GUI library for [LÖVR](https://lovr.org/)
+This is the sister project of [lovr-ui](https://github.com/immortalx74/lovr-ui) (a VR GUI library).
+It borrows concepts from the outstanding [Dear ImGui](https://github.com/ocornut/imgui) library and is inspired by [microui](https://github.com/rxi/microui), trying to be simple and minimal.
+
+https://github.com/immortalx74/lovr-ui2d/assets/29693328/3b1e15cc-948f-401f-a236-ee63c44e07ea
+
+**How to use:**
+ - Put the ui2d folder inside your project and require it: `UI2D = require "ui2d..ui2d"`
+ - Initialize the library by calling `UI2D.Init()` on `lovr.load()`
+ - Call `UI.InputInfo()` on `lovr.update()`
+ - Everything inside `UI2D.NewFrame()`/`UI2D.RenderFrame()` is your GUI
+ - `UI2D.RenderFrame()` returns a table of passes. Insert the main pass from `lovr.draw()` in that table and submit to LOVR.
+
+**Widgets:**
+
+ - Button
+ - ImageButton
+ - TextBox
+ - ListBox
+ - SliderInt
+ - SliderFloat
+ - Label
+ - CheckBox
+ - RadioButton
+ - TabBar
+ - Dummy
+ - ProgressBar
+ - CustomWidget
+ - Modal window
+ - Separator
+
+**API:(WIP)**