|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| ChangeLogs/ | H | 03-May-2022 | - | | |
| Packages/ | H | 24-Aug-2015 | - | 2,838 | 2,245 |
| ada-core/ | H | 07-May-2022 | - | 13,553 | 10,279 |
| ada-demos/ | H | 03-May-2022 | - | 4,770 | 3,781 |
| ada-gui/ | H | 04-Sep-2015 | - | 26,732 | 21,598 |
| au/ | H | 07-May-2022 | - | 1,574 | 1,248 |
| core/ | H | 03-May-2022 | - | 38,461 | 32,615 |
| demos/ | H | 03-May-2022 | - | | |
| dev/ | H | 07-May-2022 | - | 2,550 | 1,933 |
| gui/ | H | 07-May-2022 | - | 85,422 | 73,209 |
| math/ | H | 07-May-2022 | - | 29,112 | 21,317 |
| mk/ | H | 03-May-2022 | - | 55,223 | 45,463 |
| p5-Agar/ | H | 11-Sep-2015 | - | 9,991 | 5,008 |
| po/ | H | 05-Sep-2015 | - | 5,063 | 3,586 |
| tests/ | H | 07-May-2022 | - | 19,096 | 16,680 |
| tools/ | H | 12-Sep-2015 | - | 5,661 | 5,175 |
| vg/ | H | 07-May-2022 | - | 9,374 | 7,806 |
| LICENSE | H A D | 25-Mar-2016 | 1.3 KiB | 25 | 20 |
| LICENSE-Vera | H A D | 25-Mar-2016 | 5.8 KiB | 125 | 97 |
| Makefile | H A D | 25-Mar-2016 | 4.7 KiB | 145 | 127 |
| Makefile.config | H A D | 25-Mar-2016 | 0 | 1 | 0 |
| Makefile.proj | H A D | 24-Aug-2015 | 1.3 KiB | 37 | 2 |
| README | H A D | 24-Aug-2015 | 3.6 KiB | 88 | 73 |
| RELEASE-1.5.0 | H A D | 25-Mar-2016 | 11 KiB | 185 | 180 |
| configure | H A D | 03-May-2022 | 328 KiB | 10,158 | 9,825 |
| configure.in | H A D | 25-Mar-2016 | 19.7 KiB | 797 | 753 |
README
1 _ _ _ ___
2 / _ \ / _ \ / _ \ | _ \
3 | |_| | | (_| | | |_| | | |_) |
4 |_| |_| \__, | |_| |_| |_| |_|
5 |___/
6
7What is it?
8-----------
9Agar is a type of sugar polymer obtained from seaweed and red algae. Agar
10becomes gelatinous in water and is primarly used as a culture medium for
11microbiological work. Agar is also the name of an open source GUI toolkit.
12
13Agar is designed to work with any graphics system, under any platform. The
14interface between Agar and the underlying OS is implemented as a modular
15"driver". Some Agar drivers are designed to work with a native window
16system (e.g., "glx", "wgl" and "cocoa"). Other Agar drivers (such as
17"sdlfb" and "sdlgl") work with a single display, with Agar providing a
18built-in window manager. Since Agar provides a consistent programming
19interface, developers need not to be aware of the underlying platform.
20
21A set of general-purpose widgets are included in the Agar-GUI library.
22Agar is designed such that new widgets can be easily implemented as part
23of a separate third-party library or application. The appearance of Agar
24GUI elements is configurable both programmatically and parametrically.
25
26The Agar-Core library provides various utility and portability interfaces,
27as well as the object system used by Agar, AG_Object(3). The object system
28implements inheritance, serialization, virtual functions, timers, threads,
29and variable bindings. Agar-Core contains no GUI-related code; applications
30may link to Agar-Core without linking to Agar-GUI.
31
32Agar is entirely thread-safe when built with thread support. Thread-safety
33considerations are documented in the API reference; see AG_Threads(3) for
34details.
35
36Documentation
37-------------
38- The online API Reference. This is a detailed description of all
39 public Agar structures, objects and functions, at:
40 http://libagar.org/man3
41- On Unix-like platforms, the API reference is also available in
42 traditional manual page format; see AG_Intro(3).
43- The Agar Manual (work in progress), at:
44 http://libagar.org/man/.
45
46Installation
47------------
48Step-by-step installation guides are available for various platforms.
49Refer to the "Installation Guides" section of the Agar documentation
50page at: http://libagar.org/docs/.
51
52Availability
53------------
54Download the most recent Agar version from the Agar home page at:
55http://libagar.org/download.html.
56
57Portability
58-----------
59Agar is portable to many different platforms, including FreeBSD, IRIX,
60Linux, MacOS Classic, MacOS X, NetBSD, OpenBSD, Solaris and Windows. Agar
61has been used on ARM embedded devices. It has even been ported to game
62consoles such as the GP2x, the Nintendo Gamecube/Wii and the Xbox. See:
63http://libagar.org/portable.html.
64
65License
66-------
67Agar is freely distributable under the terms the "new" BSD license:
68http://libagar.org/license.html.
69
70How to contribute
71-----------------
72See: http://libagar.org/contribute.html.
73
74Libraries and toolkits based on Agar
75------------------------------------
76Here are some useful libraries which implement new Agar widgets and
77extend Agar's functionality toward more specific applications:
78
79Agar-AU Portable audio interface (bundled, use `agar-au-config`)
80Agar-MATH General-purpose math library (bundled, use `agar-math-config`)
81Agar-VG Vector graphics library (bundled, use `agar-vg-config`)
82Agar-RG Raster graphics library (bundled, use `agar-rg-config`)
83Agar-DEV Developer/debugging tools (bundled, use `agar-dev-config`)
84FreeSG 2D/3D graphics engine (http://freesg.org/)
85Edacious Electronics design (http://edacious.org/)
86CADTools Computer-aided design (http://cadtools.hypertriton.com/)
87
88