Manual/Table of Contents

From Agar

1. Introduction
   1. Why Portability?
   2. Why Agar?
   3. Installing Agar
   4. Getting Help
2. First steps in Agar Programming
   1. Hello World!
   2. Using the Agar API Reference
   3. Adding an Exit Button
   4. Introduction to Agar Events
   5. Introduction to Variable Bindings
   6. Event handling and drawing with a custom widget
3. Learning more about Agar
   1. Adding Menus
   2. Using Container Widgets
   3. Loading a File
4. A Guided Tour Through the Simple Widgets
   1. General Widget Parameters
   2. Widget Styles
   3. Buttons
   4. Widgets for Bounded Range Input
   5. Scroll Bars
   6. Text Entry Fields
   7. Text Labels
   8. Image Display
   9. Progress Bars
   10. Tree/List Views
   11. Table Views
   12. Tabular Tree Views
   13. Icons and Sockets
   14. Text Console
5. Using Agar Menus
6. Using Predefined Agar Dialogs
   1. Message boxes
   2. Question boxes
   3. File loading
7. Using Container Widgets
   1. Standard Horizontal and Vertical Packing
   2. Packing Widget in Rows and Columns
   3. Dividing Panes
   4. Scrolled Views
   5. Manual Pixel-Coordinate Packing
   6. Creating a Custom Container Widget
8. Some Thoughts on GUI Design
9. Data Structure Classes
   1. Agar Variables
   2. Linked Lists
   3. Arrays
   4. Trees
10. Graphics
    1. Low-level Widget Graphics
       1. Graphical Surfaces
       2. Animations
       3. Direct Drawing to a Frame Buffer
       4. Vector Drawing with OpenGL
       5. Built-in Widget Rendering Routines
    2. High-level Vector Graphics
       1. Basic VG: Using Predefined Scene Elements
       2. Displaying Scenes with VG_View
       3. Using Transformations
       4. Attaching Logic to Scene Elements
       5. Saving and Restoring Scenes
       6. Creating Custom Scene Elements
       7. Creating Custom VG_View Tools
       8. Geometrically-Constrained Vector Graphics
    3. High-level Raster Graphics
       1. Basic RG: Creating Tiles and Pixmaps
       2. Applying Features to RG Graphics
       3. Creating RG Animations
       4. Importing Vector Graphics into RG Graphics
       5. Displaying RG Graphics with RG_Tileview
       6. Implementing Custom Features
    4. Low-level 3D Graphics
       1. Displaying an OpenGL Scene in a GLView Widget
       2. Integrating Agar in an Existing GL Application
       3. Using OpenGL in Custom Widgets
    5. High-level 3D Graphics (FreeSG)
11. Text Processing
    1. Validating User Input
    2. Working with Regular Expressions
    3. Rendering Text to Graphical Surfaces
    4. Using Alternate Fonts
    5. Internationalization
12. Working with Files and Directories
    1. Reading a Text File
    2. Traversing a Directory
    3. Fetching File Information
13. Inter-Application Communication
    1. Agar Object Serialization
    2. Database Bound Objects
    3. Network Clients and Servers
14. Working with Numerical Values
    1. Using Numerical Widget Bindings
    2. Using Built-in Unit Conversion
15. Writing your Own Widgets
    1. Inheritance under Agar's Object System
    2. Implementing a Coordinate Selector
    3. Implementing a Browse Box
    4. Bundling Existing Widgets
       1. Bundling Labels
       2. Bundling Scrollbars
       3. Bundling Container Widgets
    5. Working with Surfaces
    6. Rendering Text
16. Focus Handling
17. Advanced Event Handling
    1. Variable Event Handler Arguments
    2. Named Event Handler Arguments
    3. Event Filters
    4. Event Forwarding
    5. Sending Synthetic Events
    6. Multithreaded Event Handling
18. Advanced Widget Bindings
    1. Safely Binding to String Buffers
    2. Multi-Type Bindings
    3. Function Bindings
    4. Attaching Locking Devices to Bindings
19. Debugging
20. Portability
    1. Why Portability is Desirable
    2. How to Write Portable Programs
    3. Porting to Embedded Systems
21. Using GUI Builders
22. Agar Network Programming
23. Interfacing Agar with Other Languages and Libraries
    1. Using Agar from Perl
    2. Using Agar from Ada
24. Sample Agar Projects
    1. Edacious
    2. Cadtools
25. A First Look at Agar 1.4