Simple and portable (but not inflexible) GUI library in C that uses the native GUI technologies of each platform it supports.
Go to file
Pietro Gagliardi 313ce47833 Started non-wrapping multiline entries. Implemented on Windows. 2016-05-22 13:56:36 -04:00
_wip Removed the old osxaltest. Not needed now. I'll just design grids against master. 2016-05-06 17:49:09 -04:00
build Fixed some OS X 10.7 build errors. 2016-05-14 23:44:07 -04:00
common Removed uiControlVerifyDestroy(); we could have just had it in uiFreeControl(). 2016-05-22 01:07:25 -04:00
darwin Fixed up uiWindow ownership mechanics in the Darwin backend. 2016-05-22 12:15:50 -04:00
doc More Core Text stuff. 2016-01-11 19:34:42 -05:00
examples Added a uiColorButton to the control gallery. 2016-05-18 14:40:03 -04:00
test Started non-wrapping multiline entries. Implemented on Windows. 2016-05-22 13:56:36 -04:00
unix Switched from using M_PI to a named constant uiPi. 2016-05-22 12:00:44 -04:00
windows Started non-wrapping multiline entries. Implemented on Windows. 2016-05-22 13:56:36 -04:00
.travis.yml Fixed the controlgallery example. Reenabled it in make examples. Changed .travis.yml to build the test first. 2016-01-06 19:38:27 -05:00
GNUmakefile Changed the release flag from NODEBUG to RELEASE. 2016-05-14 11:12:45 -04:00
LICENSE Split into a new repository and added a LICENSE. 2015-04-16 20:31:11 -04:00
README.md Added CRLF translation to uiMultilineEntry on Windows. More TODOs. 2016-05-22 13:42:37 -04:00
TODO.md Switched from using M_PI to a named constant uiPi. 2016-05-22 12:00:44 -04:00
buildnotes More TODOs. 2016-05-14 11:18:53 -04:00
oldhaiku.tgz Discontinued the Haiku port for now. 2016-04-24 14:18:56 -04:00
ui.h Started non-wrapping multiline entries. Implemented on Windows. 2016-05-22 13:56:36 -04:00
ui_darwin.h Removed uiControlVerifyDestroy(); we could have just had it in uiFreeControl(). 2016-05-22 01:07:25 -04:00
ui_unix.h Removed uiControlVerifyDestroy(); we could have just had it in uiFreeControl(). 2016-05-22 01:07:25 -04:00
ui_windows.h Removed uiControlVerifyDestroy(); we could have just had it in uiFreeControl(). 2016-05-22 01:07:25 -04:00

README.md

libui: a portable GUI library for C

This README is being written.
Build Status

Announcements

21 May 2016

  • I will now post announcements and updates here.
  • Now that Ubuntu 16.04 LTS is here, no earlier than next Saturday, 28 May 2016 at noon EDT, I will bump the minimum GTK+ version from 3.4 to 3.10. This will add a lot of new features that I can now add to libui, such as search-oriented uiEntries, lists of arbitrary control layouts, and more. If you are still running a Linux distribution that doesn't come with 3.10, you will either need to upgrade or use jhbuild to set up a newer version of GTK+ in a private environment.
  • You can decide if I should also drop OS X 10.7 here.

Updates

Note that today's entry may be updated later today.

  • 22 May 2016 ** Removed uiControlVerifyDestroy(); that is now part of uiFreeControl() itself. ** Added uiPi, a constant for π. This is provided for C and C++ programmers, where there is no standard named constant for π; bindings authors shouldn't need to worry about this. ** Fixed uiMultilineEntry not properly having line breaks on Windows.

Runtime Requirements

  • Windows: Windows Vista SP2 with Platform Update or newer
  • Unix: GTK+ 3.4 or newer
  • Mac OS X: OS X 10.7 or newer

Build Requirements

  • All platforms:
    • GNU make 3.81 or newer (Xcode comes with this; on Windows you will need to get it yourself)
  • Windows: Microsoft Visual Studio 2013 or newer (2013 is needed for va_copy())
    • MinGW is currently unsupported. MinGW-w64 support will be re-added once the following features come in:
      • Isolation awareness
      • Linker symbols for some functions such as TaskDialog() (which I thought I submitted...)
  • Unix: nothing specific
  • Mac OS X: nothing specific, so long as you can build Cocoa programs

(TODO write some notes on make variables and cross-compiling)

Documentation

Needs to be written. Consult ui.h and the examples for details for now.

Language Bindings

libui was originally written as part of my package ui for Go. Now that libui is separate, package ui has become a binding to libui. As such, package ui is the only official binding.

Other people have made bindings to other languages:

  • TODO list them here

Screenshots

From examples/controlgallery:

Windows

Unix

OS X