readme

这是ARM嵌入式系统的实验教程中的MINIGUI的实验源代码！

        4) By default, libraries of MiniGUI will be installed in `/usr/local/lib'. 
           You should make sure that this directory is listed in `/etc/ld.so.conf' 
           file. And after having installed them, you should run 
           the following command to update the cache of shared library system:

           $ su -c ldconfig

        5) If you want to specify which features MiniGUI provides, you 
           can run

           $ ./configure --help

           to see the complete configuration options listed, then disable or 
           enable some features by using command line switches. For example, 
           if you do not want MiniGUI to load JPEG pictures via the function 
           LoadBitmap, you can use 

           $ ./configure --disable-jpgsupport

        6) Note that some features of MiniGUI depend on other libraries.
           Please make sure that you have installed them.


  4.4 Run demos of MiniGUI

    If you have installed MiniGUI version 1.1.xx or later, you should use 
    our new demo system called `MDE'. 'MDE' is a comprehensive demostration 
    environment for MiniGUI version 1.5.x, more pretty and useful.

    Before running the demo programs, you should extract these tarballs 
    and compile them:

        1) Extract the tarball to a new directory by using `tar' command.

        2) Run `./configure' and `make' to compile the demos. If you have
           configured and installed MiniGUI as `MiniGUI-Threads', please
           use the following configuration option:

            ./configure --disable-lite

        3) Try to run demos and applications. 

        4) If you compiled and installed MiniGUI as `MiniGUI-Lite', 
           you should first run a server program, and then run other demos. 
           Building MDE will create a program called `mginit', which is the
           server providing a virtual console on MiniGUI-Lite:

            $ cd mginit
            $ ./mginit

        5) If you compiled and installed MiniGUI as `MiniGUI-Threads', 
           you can run the program directly. As an example, you can go to 
           `mde-1.5.x/same/' to run `same':

            $ cd same
            $ ./same


5. HISTORY

    Three years have pasted since MiniGUI was initially created at the end of
    1998, and now it becomes much reliable and stable. During the past years, 
    many remarkable changes have taken place in the MiniGUI project.

    At the original, the version 0.2.xx was based on SVGALib and PThread 
    (LinuxThreads). Then the version 0.3.xx had many enhanced features 
    including Graphics Abstract Layer (GAL), Input Abstract Layer (IAL), 
    and the support for multiple charsets and multiple fonts. 

    In version 1.0.00, we designed MiniGUI-Lite, which was more fit for 
    some complex embedded systems, such as PDAs, Thin-Clients, or STBs. 
    MiniGUI-Lite made the embedded systems more stable and efficient. 
    The version 1.0.00 provided the Native engine based on Linux 
    FrameBuffer device directly as well. 

    In the developing version 1.1.00 of MiniGUI, we re-wrote the GAL and GDI 
    interfaces, and provided some advanced video features, such as raster 
    operation, transparent blitting, alpha blending, and video hardware 
    acceleration. We also provided some important GDI functions, such as 
    Ellipse, Arc, Polygon, and FloodFill.

    A brief history description of the developement progress lay below:

        0)  1994 ~ 1996:    MiniGUI DOS version.
        1)  Dec, 1998:      Began to write.
        2)  Apr, 1999:      The skeleton of MiniGUI, windowing sub-system 
                            and basic graphics device interfaces.
        3)  May, 1999:      Timer, menu, and the sekleton of control sub-system.
        4)  Jun, 1999:      Chinese input method (by Kang Xiaoning).
        5)  July, 1999:     GIF and JPG loading support (by LI Zhuo).
        6)  Aug, 1999:      Some standard controls (Portion by Zhao Jianghua).
        7)  Sep, 1999:      Dialog boxes and message boxes.
        8)  Sep, 1999:      Snapshot of screen or window.
        9)  Jan., 2000:     VCOnGUI (Virtual Console on MiniGUI) version 0.2.02.
        10) Mar., 2000:     Linux distribution installer based-on MiniGUI for 
                            HappyLinux 1.0.
        11) Jun., 2000:     Began to develop version 1.0.xx.
        12) Sep., 2000:     MiniGUI version 0.3.06 released.
        13) Oct., 2000:     MiniGUI version 0.9.00 released. 
        14) Nov., 2000:     MiniGUI version 0.9.96 released. 
        15) Jan., 2001:     MiniGUI version 0.9.98 released. You can build 
                            MiniGUI-Lite from this version.
        16) Jan., 2001:     MiniGUI version 1.0.00Beta1 released.
        17) Feb., 2001:     MiniGUI version 1.0.00Pre1 released.
        18) Apr., 2001:     MiniGUI version 1.0.00 released (2001/04/16).
        18) Sep., 2001:     MiniGUI version 1.1.0Pre1 released (2001/09/12).
        19) Sep., 2001:     MiniGUI version 1.0.9 released (2001/09/17), 
                            this will be the last version of
                            source branch 1.0.x. 
        20) Oct., 2001:     MiniGUI version 1.1.0Pre4 released (2001/10/22). 
                            This version have new GAL and GDI interfaces.
        21) Mar., 2002:     MiniGUI official version 1.1.0 released (2002/03/08). 
                            MiniGUI API Reference documentation version 0.9 released.
        22) Mar., 2002:     MiniGUI API Reference documentation version 1.0 released.
        23) Apr., 2002:     MiniGUI the new stable version 1.2.0 released (2002/04/11). 
        24) Sep., 2002:     The main developers of MiniGUI founded a new software 
                            corporation: Beijing Feynman Software Technology Co., Ltd..
                            And the development and maintenance of MiniGUI changes from 
                            loosely-knit team to business organization.
        25) Mar., 2003:     MiniGUI official version 1.2.5 released (2003/03/23).
        25) May., 2003:     MiniGUI official version 1.2.6 released (2003/05/18).
        26) Sep., 2003:     MiniGUI official version 1.3.1 released (2003/09/11).
        27) Jan., 2004:     MiniGUI official version 1.5.1 released (2004/01/18).
        28) Feb., 2004:     MiniGUI tested on eCos and uC/OS-II.
        29) Jun., 2004:     MiniGUI tested on VxWorks.
        30) Oct., 2004:     MiniGUI official version 1.6.0 released.


6. ABOUT THE AUTHORS

    The original author of MiniGUI is Wei Yongming, and now MiniGUI is maintained by
    Feynman Software. More information, please browse our home page:

    http://www.minigui.com
    http://www.minigui.org

    The latest source and dependent libraries of MiniGUI can be found at:
    
    http://www.minigui.com/product/index.shtml
    http://www.minigui.com/download/index.shtml

    For other authors, see CREDITS.


7. IF YOU HAVE A PROBLEM

    We have built several mailing lists for MiniGUI project. If you have
    any problem, advice or comment, please send a message to the
    mailing lists. Note that you should subscribe the mailing lists
    first, then you will have right to send messages to the mailing
    lists.

    * minigui-users: the mailing list for MiniGUI Generic Users.
      Please visit

            http://lists.minigui.net/cgi-bin/mailman/listinfo/minigui-users

      to subscribe it.

    * minigui-devel: the mailing list for MiniGUI Application Developers.
      Please visit

            http://lists.minigui.net/cgi-bin/mailman/listinfo/minigui-devel

      to subscribe it.

    * minigui-ecos: the mailing list for eCos + MiniGUI users.
      Please visit:

            http://lists.minigui.net/cgi-bin/mailman/listinfo/minigui-ecos

      to subscribe it.

    Please visit

    http://www.minigui.com/training/support.shtml

    for more information.


8. LITTLE FAQ

    Q: Is MiniGUI free-download edition free for commercial use?
    A: Simply no. MiniGUI is licensed under the GPL license. 
       It is free for those who are 100% GPL and those who never copy, 
       modify and distribute MiniGUI. But if you want to use it for 
       commerce, you should get the commercial license from 
       Feynman Software first.

    Q: Which operating system does MiniGUI support?
    A: MiniGUI can run on Linux, uClinux, uC/OS-II, eCos, and VxWorks.
       Any other real-time OS can be supported theoretically.

    Q: Which hardware platform does MiniGUI support?
    A: Intel x86, ARM (ARM7/AMR9/StrongARM/xScale), PowerPC, MIPS, 
       M68K (DragonBall/ColdFire), such kind of hardware platforms.

    Q: Does MiniGUI offer the support for grey LCD with 4bpp (bits per pixel)?
    A: Yes, it offers. It even offers the support for 1bpp and 2bpp LCD. 
       However, you should use the old GAL and GDI, not the new GAL and GDI.


9. COPYING

    Copyright (C) 2002~2004, Beijing Feynman Software Technology Co., Ltd.
    Copyright (C) 1998~2002, Wei Yongming
    Portion copyright (C) 2000~2001, Zheng Xiang and others.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program 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 General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


10. IF YOU ARE DEVELOPING COMMERCIAL OR PROPRIETARY SOFTWARE BY USING MINIGUI

    The edition you downloaded freely from our site may only be used to 
    develop GPL (non-proprietary) Software. The COPYING file explains 
    what you may or may not do with the free edition.

    If you are using MiniGUI for developing commercial, proprietary, or other
    software not covered by the terms listed in the COPYING file, you
    must have a commercial license for MiniGUI. Please see
    http://www.minigui.com/product/index.html for how to obtain this. 

    If you are interested in the commercial MiniGUI licensing, please write
    to [e-mail].  Other mail can be sent to [e-mail].