readme

在ｅｃｏｓ 下mingui 的移植开发

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,
            [e-mail]).
        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: [e-mail], and [e-mail]

    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