What is it?
Agar is a type of sugar polymer obtained from seaweed and red algae. It becomes gelatinous in water and is primarly used as a culture medium for microbiological work. Agar (or LibAgar) is also the name of an open source GUI toolkit, a set of software libraries for building graphical user interfaces.
Agar works with a wide variety of platforms and graphics systems, from modern desktops to classic consoles and embedded devices. Its low-level layers are modular, extensible and easily ported to new hardware platforms and graphics systems. Standard drivers include:
- cocoa (MacOS, OpenGL, multi-window)
- glx (X Windows, OpenGL, multi-window)
- sdl2fb (SDL 2.0, frame-buffer, single-window)
- sdl2gl (SDL 2.0, OpenGL, single-window)
- sdl2mw (SDL 2.0, OpenGL, multi-window)
- sdlfb (SDL 1.2, frame-buffer, single-window)
- sdlgl (SDL 1.2, OpenGL, single-window)
- wgl (Windows, OpenGL, multi-window)
For graphics systems without multi-window capabilities (or cases where a MDI-style interface is preferred over desktop integration), a single-window mode is provided in which case Agar provides its own internal window manager.
Agar's cascading Style Engine separates presentation details from underlying code. Style attributes including typography, colors, paddings and spacings of widgets can be assigned from a style sheet using a common language. Style Editor tool allows style changes to be viewed in real-time.
While Agar includes a standard library of general-purpose widgets, it is also designed to be extended externally. New Agar widgets can be implemented as part of an application or of an external library. Complex user interface elements can be realized often in few lines of code. The class registration interface simplifies the process.
To aid debugging, the Debug version performs type checking, object-validity and class-membership tests against object pointers passed to API calls at run-time. Agar is thread-safe when built with threads support. Public API calls are reentrant unless documented otherwise, although Agar does not rely on threads for its own operation.
Libraries included (stable)
- CORE: Platform, I/O, object system (non graphical)
- GUI (Base): GUI base framework
- GUI (Widgets): GUI standard widgets
- MATH: Matrices, vectors & advanced rendering methods
- NET: Network interface, HTTP application server
- VG: Vector graphics
Libraries included (beta)
- AU: Audio interface library
- SG: General-purpose 3D engine
- SK: Sketches with constraints
- MAP: Tile engine
How to install
See the provided INSTALL.md or an online installation guide:
- on BSD
- on Linux
- on MacOS
- on Unix
- on Windows with MingGW32
- on Windows with MingGW64
- on Windows with Visual Studio
Availability
Latest Stable Release
Latest Development Sources
- Main Repo: https://dev.csoft.net/agar/trunk
- On GitHub: JulNadeauCA/libagar
License
- BSD 2-Clause License
- OFL 1.1 (core fonts)
Contributing
- Sign up to the Patreon for exclusive content including articles, code and tutorials.
- Contribute by donating, supporting our sponsors, reporting bugs or submitting code.