NAME    MiniGUI - a LinuxThreads based mini-GUI support system.IMPORTANCE    The source is uncompleted, and the MiniGUI is still underconstruction.    This document is also uncompleted.TABLE OF CONTENTS    0. Introduction    1. History    2. Installation    3. How to use MiniGUI    4. Description of MiniGUI functions    5. Goals    6. References    7. Known bugs and limitations    8. About the authors.0. INTRODUCTION    This is a mini graphics user interface (GUI) support system for Linux.     MiniGUI 0.2.xx is based on SVGALib and LinuxThread libraries, and now,    MiniGUI 0.3.xx, has a Graphics Abstract Layer (GAL) and a Input Abstract     Layer (IAL), so MiniGUI can run on many Graphics Engines,     including SVGALib and LibGGI.    There will be a native graphics engine of MiniGUI, which will be derived     from Allegro, a perfect game engine.    By using GAL and IAL, MiniGUI applications can run on X Window. This    makes debugging of applications and porting of MiniGUI to other     hardware easier.        MiniGUI defines some Win32-like APIs for the applications. By using the    MiniGUI, one application can create multiple windows, and can draw in    these windows without interfering each other.    You can find latest information about MiniGUI at our home page:        http://www.minigui.org/index.html.1. HISTORY    In this section, we give you a brief history description of MiniGUI:        1) Dec, 1998: Start to write.        2) Apr, 1999: Get the skeleton of MiniGUI, support multiple main             windows, and basic graphic device interfaces.        3) May, 1999: Support timer and menu. Get the sekleton of control             support.        4) Jun, 1999: Support Chinese input method (written by KANG Xiaoning,            kxn@263.net).        5) July, 1999: Support GIF and JPG image format (written by LI Zhuo).        6) Aug, 1999: Implemente standard controls (written by WEI Yongming,            originally by ZHAO Jianghua).        7) Sep, 1999: Dialog box and message box logics (written by             WEI Yongming).        8) Sep, 1999: Snapshot of screen or window (written by            WEI Yongming).        9) Jan., 2000:            VCOnGUI (Virtual Console on MiniGUI) version 0.2.02 released            (written by WEI Yongming).        10) Mar., 2000:            Linux distribution installer for HappyLinux released by Legend             (written by WEI Yongming).        11) Jun., 2000:            WEI Yongming move to Bluepoint Software and begin developing             version 0.3.xx.        12) Sep., 2000:            MiniGUI version 0.3.00 released.        13) Oct., 2000:            MiniGUI version 0.9.00 released. Version 0.9.xx are the preview            version of 1.0.2. INSTALLATION  2.0 Before Installation    If you want to use SVGALib as your graphics engine, please download     the modified svgalib-1.4.0-hz and vgagl4-0.1.0 from our    Web site ftp://ftp.minigui.org/pub/minigui/dep-libs, and     install these libraries in your system.  This may override your old     svgalib, but there is no harm to your system.    If you want to use LibGGI as your graphics engine, please download    latest GGI source from http://www.ggi-projects.org, and install it.    After installed graphics engine, please download minigui-0.3.xx.tgz,    miniguires-0.3.tgz, miniguiexec-0.3.xx.tgz, and miniguiapps-0.3.xx.tgz    from our site and extract these tarballs.  2.1 Installing resource files of MiniGUI    We must install resource files of MiniGUI first. Please follow    these steps to do this:        1) Using `tar' to extract miniguires-0.3.tgz. You can use            following command:           $ tar zxf miniguires-0.3.tgz        2) Change to new directory and run `make' as a super user:           $ su -c make  2.2 Configure and compile MiniGUI    MiniGUI uses automake and autoconf, so configuration and compilation    of MiniGUI is very easy:        1) Using `tar' to extract minigui-0.3.xx.tgz to a new directory:           $ tar zxf minigui-0.3.xx.tgz        2) Change to new directory and run `./configure':           $ ./configure        3) Run following commands to compile and install MiniGUI:           $ make; su -c 'make install';        4) By default, libraries of MiniGUI will be installed           `/usr/local/lib'. You should make sure that this directory           is listed in /etc/ld.so.conf file. And after installed, you           should run following command to update cache of shared library           system:            $ su -c ldconfig  2.3 Run demos and apps of MiniGUI    In miniguiexec-0.3.xx.tgz and miniguiapps-0.3.xx.tgz, there are    some demos and applications of MiniGUI. Before run them, you should    extract both tarballs and compile them:        1) Extract above tarballs by using `tar' command to new directories.        2) Run `make' to compile demos and applications.        3) Run 'make install' to install our applications.        4) Try to run demos and applications. As an example, you can go           miniguiexec03/amuze/ to run `amuze'.3. HOW TO USE MiniGUI    This section is under arrangement.4. DESCRIPTION OF MiniGUI FUNCTIONS    This section is under arrangement.5. GOALS    The goal of MiniGUI is keeping its features of small and exquisiteness     to provide a small windowing system support library. 6. KNOWN BUGS AND LIMITATIONS    o When use SVGALib as the graphics engine...    Because we use the vgagl functions in our MiniGUI, so MiniGUI can only    run in the 256 color mode or higher color modes and no mode-X. Although    MiniGUI can run in 16 color (4-planar) modes, the 256c or high/true color    modes are the prefer ones.    SVGALib and LinuxThread both use the SIGUSR1 and SIGUSR2, so it is     dangerous using both libraries in one application. We have modified     SVGALib to use other not used SIGNALs:            SIGUSR1 -> SIGUNUSED        SIGUSR2 -> SIGSTKFLT            We have added some functions to SVGALib to support Chinese (GB2312) string.    The functions are:        void gl_setccfont (int afw, int cfw, int fh, void *afdp, void *cfdp);    void gl_setccwritemode (int wm);    void gl_ccwrite (int x, int y, char* s);    void gl_ccwriten (int x, int y, int n, char *s);    void gl_setccfontcolors (int bg, int fg);    Using MiniGUI, no need to consider above functions.    The new modified SVGALib will be distributed with MiniGUI.     With vgagl4 library, you can run MiniGUI applications on a stantard VGA    card in 640x480x16c mode. However, the drawing speed is very slow.    To enable the support of stantard VGA card, you should remake the library    with defining _STD_VGA macro, and use a SVGA card (such as Trident TVGA    or S3) as a SVGALib driver, do not use VGA driver to support these stantard    VGA modes.    For some VESA BIOS compatible video cards, you can use the VESA driver    of SVGALib. To enable VESA driver, please edit the /etc/vga/libvga.config,    and add a line:        Chipset VESA    or delete the first comment character '#'.    When use SVGALib, applications based on MiniGUI do need superuser privilege    to set vedio mode.    NOTE: When use SVGALib, please disable any mouse acceleration in     /etc/vga/libvga.config.    o When use LibGGI as the graphics engine...    Because LibGGI has no any stable version, so you may encounter `core dump'    with LibGGI.     Applications based on MiniGUI do not need superuser privilege.9. ABOUT THE AUTHORS    The author of MiniGUI is WEI Yongming. He is living in Beijing, P.R.China.     You can contact with him by:        email: ymwei@minigui.org, and ymwei@263.net    or browse our HOME PAGE:    http://www.minigui.org    and MiniGUI's latest version and dependent libraries can be found at:        http://www.minigui.org/download.html    http://www.minigui.net/download.html    or    ftp://ftp.minigui.org/pub/minigui    ftp://ftp.minigui.net/pub/minigui        For other authors to see CREDITS.10. COPYING    Copyright (C) 1998, 1999, 2000, WEI Yongming.    Copyright (C) 2000, BluePoint Software.    MiniGUI is free woftware; you can redistribute it and/or modify it under     the terms of the GNU Library General Public License as published by the     Free Software Foundation; either version 2 of the License,     or (at your option) any later version.    This library is distributed in the hope that it will be useful,     but WITHOUT ANY WARRANTY; without even the implied warranty of     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.      See the GNU Library General Public License for more details.    You should have received a copy of the GNU Library General Public License     along with this library; if not, write to the Free Software Foundation, Inc.,     59 Temple Place - Suite 330, Boston, MA 02111-1307, USA