61 lines
2.6 KiB
Markdown
61 lines
2.6 KiB
Markdown
# libui: a portable GUI library for C
|
|
|
|
This README is being written.<br>
|
|
[](https://travis-ci.org/andlabs/libui)
|
|
|
|
## 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](https://github.com/andlabs/libui/issues/46).
|
|
|
|
## 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](https://msdn.microsoft.com/en-us/library/aa375197%28v=vs.85%29.aspx)
|
|
* 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](https://github.com/andlabs/ui). 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:
|
|
|
|
|
|
|
|
|
|
|
|
|