diff --git a/README.md b/README.md index 2816bf19..655548ac 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ A mature cross-platform windowing system and GUI system for embedded and IoT dev ## INTRODUCTION -MiniGUI is a mature cross-platform windowing system and GUI (Graphics +MiniGUI is a mature cross-platform windowing system and a GUI (Graphics User Interface) support system for embedded systems and smart IoT devices. This is the version 3.2.x of MiniGUI maintained by WEI Yongming (Vincent Wei, https://github.com/VincentWei). @@ -32,31 +32,36 @@ embedded systems or smart IoT devices based-on Linux/uClinux, eCos, and other traditional RTOSes, such as VxWorks, ThreadX, Nucleus, pSOS, uC/OS-II, and OSE. -This is the MiniGUI core source tarball, which provides windowing +This is the MiniGUI core source tree, which provides windowing and graphics interfaces as well as a lot of standard controls (tookit). Besides MiniGUI core, FMSoft also provides some components for the developers to develop app much easier: + * mGUtils: A MiniGUI component which contains miscellaneous utilities + like ColorSelectionDialogBox, FileOpenDialogBox, and so on. + * mGPlus: A MiniGUI component which provides support for advanced graphics functions like path, gradient, anti-aliase stretch, and color combination. + * mGEff: mGEff provides an animation framework for MiniGUI app. + It also provides some popular UI/UE special effects. + * mGNCS: This component provides a new control set for MiniGUI app. By using mGNCS, you can use miniStudio to develop MiniGUI app in WYSIWYG way. - * mGEff: mGEff provides an animation framework for MiniGUI app. - It also provides some popular UI/UE special effects. + * mGNCS4Touch: This component provides some new controls, which are + compliant to the new control API spec of mGNCS, for devices with + a touch screen. + +There are also some legacy MiniGUI components. We will not maintain these +components for MiniGUI core v3.2: * mGi: An input method component for MiniGUI. This component provides some typical input methods (such as softkey, hand-writing, and predict text input for mobile phone) for MiniGUI apps. - * mGUtils: A MiniGUI component which contains miscellaneous utilities - like ColorSelectionDialogBox, FileOpenDialogBox, and so on. - -There are also some legacy MiniGUI components: - * mGp: A printing component for MiniGUI. By using mGp, you can print out the graphics created by MiniGUI app to general-purpose printers. @@ -104,6 +109,34 @@ You can also download it from the official site of MiniGUI. http://www.minigui.com/en/download +## A BRIEF BUILDING INSTRUCTION + +This instruction assumes that you are using Ubuntu Linux. + +### Prerequisites + + * Building tools: autoconf + * Dependent libraries (all are optional): + * libjpeg64-dev + * libpng12-dev + * libfreetype6-dev + +### Building + +MiniGUI core uses GNU autoconf/automake scripts to configure and build the project. + +Run + + $ ./configure; make; sudo make install + +to configure, make, and install the headers and the libraries. + +MiniGUI core also provides some configuration options to customize the features. +For more information, please run + + $ ./configure --help + + ## NEW FEATURES IN VERSION 3.2.x We introduce some new features in MiniGUI Version 3.2.x: @@ -273,10 +306,9 @@ messages to consult@minigui.com. Q: Is GPL'd MiniGUI free for commercial use? A: Simply no. FMSoft releases MiniGUI under GPLv3 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 - these GPL'd versions for commerce, you should get the commercial - license from FMSoft first. + It is free for those who are 100% GPL and those who never copy, modify + and distribute MiniGUI. But if you want to use these GPL'd versions + for commerce, you should get the commercial license from FMSoft first. Q: Which operating system does MiniGUI support? @@ -286,20 +318,14 @@ A: MiniGUI can run on Linux/uClinux, uC/OS-II, eCos, ThreadX, pSOS, Q: Which architecture does MiniGUI support? -A: Intel x86, ARM (ARM7/AMR9/StrongARM/xScale), PowerPC, MIPS, - DragonBall, ColdFire, Blackfin, and so on. +A: x86 32/64-bit, ARM 32/64-bit (Cortex A7, Cortex A9, ARM7/AMR9/StrongARM/xScale), + PowerPC, MIPS, DragonBall, ColdFire, Blackfin, and so on. 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. -## COPYING - -Copyright (C) 2002~2017, Beijing FMSoft Technologies Co., Ltd. - -Copyright (C) 1998~2002, WEI Yongming - ## NOT FREE FOR COMMERCIAL USE MiniGUI and its components are licensed under the GPL license. @@ -311,3 +337,35 @@ We provide you the commercial license of MiniGUI according to the number of the run-time binary copies of MiniGUI. If you are interested in the commercial license of MiniGUI, please write to sales@minigui.com. + +## COPYING + +Copyright (C) 2002~2018, Beijing FMSoft Technologies Co., Ltd. + +Copyright (C) 1998~2002, WEI Yongming + +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 3 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, see . + +Or, + +As this program is a library, any link to this program must follow +GNU General Public License version 3 (GPLv3). If you cannot accept +GPLv3, you need to be licensed from FMSoft. + +If you have got a commercial license of this program, please use it +under the terms and conditions of the commercial license. + +For more information about the commercial license, please refer to +. +