projects / wxWidgets.git / blame
| Commit | Line | Data |
|---|---|---|
| 2bcdcf7e VZ |
1 | wxUniversal README |
| 2 | ================== | |
| 3 | ||
| 4 | Welcome to wxUniversal! | |
| 5 | ||
| 6 | Acknowledgements: wxUniversal wouldn't have been written without the | |
| 7 | generuous support of SciTech Software. Many thanks to Kendall Benett and | |
| 8 | Tom Ryan! | |
| 9 | ||
| 10 | 0. Introduction | |
| 11 | --------------- | |
| 12 | ||
| 13 | wxUniversal is a port of wxWindows which implements the various GUI controls | |
| 14 | by drawing them itself (using low level wxWindows classes). Please see | |
| 15 | ||
| 16 | http://www.wxwindows.org/wxuniv.htm | |
| 17 | ||
| 18 | for more details about it. | |
| 19 | ||
| 20 | The advantage of wxUniversal is that you have precise control over the | |
| 21 | controls appearance (it is not always possible to change all aspects of the | |
| 22 | native controls) and the theme support: the same program may be changed to | |
| 23 | look completely differently without changing a single line of its code but | |
| 24 | just changing the theme. | |
| 25 | ||
| 26 | Another advantage is that it makes writing ports of wxWindows for other | |
| 27 | platforms (such as OS/2, BeOS or QNX) much simpler, so it is of special | |
| 28 | interest to the people interested in porting wxWindows to another platform. | |
| 29 | ||
| 30 | However, wxUniversal doesn't have the 100% native look and feel unlike the | |
| 31 | other wxWindows ports - this is the price to pay for the extra flexibility. | |
| 32 | ||
| 33 | 1. Requirments and supported platforms | |
| 34 | -------------------------------------- | |
| 35 | ||
| 36 | wxUniversal is used together with another wxWindows port which provides the | |
| 37 | "low level classes" mentioned above. Currently it can be built either with | |
| 38 | wxMSW or wxGTK. In any case, you should download the sources for the | |
| 39 | appropriate toolkit in addition to wxUniversal - in fact, you should download | |
| 40 | them first and then unpack wxUniversal in the same directory. | |
| 41 | ||
| 42 | The requirments for wxUniversal are the same as for the underlying low level | |
| 43 | toolkit. | |
| 44 | ||
| 45 | 2. Installing under Win32 | |
| 46 | ------------------------- | |
| 47 | ||
| 48 | a) Using Visual C++ 6.0 | |
| 49 | ||
| 50 | Simply open the src/wxUniv.dsw file in MSDEV and build it. | |
| 51 | ||
| 52 | b) Cygwin | |
| 53 | ||
| 54 | Please refer to the Unix section below | |
| 55 | ||
| 56 | c) Other compilers | |
| 57 | ||
| 58 | Unfortunately we don't have the makefiles for any other compilers yet. | |
| 59 | Please contact us if you would like to help us with creating one for the | |
| 60 | compiler you use. | |
| 61 | ||
| 62 | 3. Installing under Unix | |
| 63 | ------------------------ | |
| 64 | ||
| 65 | Please refer to the installation instructions for wxGTK. The only change for | |
| 66 | wxUniversal is that you must add "--enable-univ" switch to the configure | |
| 67 | command line. | |
| 68 | ||
| 69 | 4. Documentation and support | |
| 70 | ---------------------------- | |
| 71 | ||
| 72 | Please note that wxUniversal is not as mature as the other wxWindows ports | |
| 73 | and is currently officially in alpha stage. In particular, it is not really | |
| 74 | intended for the end users but rather for developers at the current stage and | |
| 75 | this is why we don't provide any binaries for it. | |
| 76 | ||
| 77 | There is no separate documentation for wxUniversal, please refer to wxWindows | |
| 78 | documentation instead. | |
| 79 | ||
| 80 | Support for wxUniversal is available from the same places as for wxWindows | |
| 81 | itself, namely: | |
| 82 | ||
| 83 | * Usenet newsgroup comp.soft-sys.wxwindows | |
| 84 | ||
| 85 | * Mailing lists: see http://lists.wxwindows.org/ for more information | |
| 86 | ||
| 87 | * WWW page: http://www.wxwindows.org/ | |
| 88 | ||
| 89 | ||
| 90 | Hope you will find wxUniversal useful! | |
| 91 | ||
| 92 | Vadim Zeitlin | |
| 93 | ||
| 94 | ||
| 95 | This file is accurate for the version 2.3.2 of wxUniversal. It was last | |
| 96 | modified on Dec 11, 2001. | |
| 97 | ||
| 98 |