1 wxUniversal README 2 ================== 3 4Welcome to wxUniversal! 5 6Acknowledgements: wxUniversal wouldn't have been written without the 7generous support of SciTech Software. Many thanks to Kendall Bennett and 8Tom Ryan! 9 100. Introduction 11--------------- 12 13wxUniversal is a port of wxWidgets which implements the various GUI controls 14by drawing them itself (using low level wxWidgets classes). Please see 15 16 http://www.wxwidgets.org/wxuniv.htm 17 18for more details about it. 19 20The advantage of wxUniversal is that you have precise control over the 21controls' appearance (it is not always possible to change all aspects of the 22native controls) and the theme support: the same program may be changed to 23look completely differently without changing a single line of its code but 24just changing the theme. 25 26Another advantage is that it makes writing ports of wxWidgets for other 27platforms (such as OS/2, BeOS or QNX) much simpler, so it is of special 28interest to people interested in porting wxWidgets to another platform. 29 30However, wxUniversal doesn't have a 100% native look and feel unlike the 31other wxWidgets ports - this is the price to pay for the extra flexibility. 32 331. Requirements and supported platforms 34--------------------------------------- 35 36wxUniversal is used together with another wxWidgets port which provides the 37"low level classes" mentioned above. Currently it can be built with wxMSW, 38wxGTK or wxX11. In any case, you should download the sources for the 39appropriate toolkit in addition to wxUniversal - in fact, you should download 40them first and then unpack wxUniversal in the same directory. 41 42The requirements for wxUniversal are the same as for the underlying low level 43toolkit. 44 452. Installing under Win32 46------------------------- 47 48If compiling from CVS, please copy include/wx/univ/setup0.h 49to include/wx/univ/setup.h before following these steps. 50 51a) Using Visual C++ 6.0/7.x 52 53 Follow wxMSW instructions but make sure to choose one of the "Universal" 54 configurations before building. 55 56b) Cygwin 57 58 Please refer to the Unix section below 59 60 Note that gcc's precompiled headers do not work on current versions of 61 Cygwin. If your version of Cygwin is affected you will need to use the 62 --disable-precomp-headers configure option. 63 64** the instructions may be out of date as for wxWidgets 2.5.2+ ** 65 66c) Other compilers 67 Borland: 68 in the wxwindows\src\msw directory run 69 'make -f makefile.b32 WXUSINGUNIV=1' to build the library and then run 70 'make -f makefile.b32 WXUSINGUNIV=1' in the sample directory which you wish 71 to build using the wxUniversal widgets. Use 'SET WXTHEME=GTK' [or WIN32 or METAL] 72 to test the existing themes 73 74Unfortunately we don't have makefiles for any other compilers yet. 75Please contact us if you would like to help us with creating one for the 76compiler you use. 77 78Note that you can use the wxUniversal classes, wxMSW and MicroWindows (from 79Century Software) to build a different variant of wxUniversal than that 80documented here. Please see docs/univ/readme.txt for further information. 81Note that this port is not up-to-date and probably needs work 82to compile. 83 84Note that by default, wxUniv under MSW uses PostScript printing, 85not Windows printing. To change to Windows printing, set 86wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW to 0 in include/wx/univ/setup.h 87before compiling. 88 893. Installing under Unix 90------------------------ 91 92Please refer to the installation instructions for wxGTK or wxX11. The only 93change for wxUniversal is that you must add "--enable-universal" switch to 94the configure command line and for wxX11 even this is unnecessary, i.e. it 95is enabled by default. 96 97If compiling from CVS, please copy include/wx/univ/setup0.h 98to include/wx/univ/setup.h before configuring. 99 1004. Running wxUniv programs 101-------------------------- 102 103wxUniv programs all honour the standard option "--theme" which allows to 104specify the theme to be used by name. Currently there are the following 105themes: 106 107a) win32 -- Windows 95 look and feel 108b) metal -- based on win32 but with gradient backgrounds 109c) gtk -- GTK+ 1.x standard look and feel 110 111Thus, to launch a program using gtk theme you may do "./program --theme=gtk". 112 113It is also possible to change the default theme for all wxUniv applications 114at once by setting the environment variable WXTHEME to the theme name. 115 1165. Documentation and support 117---------------------------- 118 119Please note that wxUniversal is not as mature as the other wxWidgets ports 120and is currently officially in alpha stage. In particular, it is not really 121intended for the end users but rather for developers at the current stage and 122this is why we don't provide any binaries for it. 123 124There is no separate documentation for wxUniversal, please refer to wxWidgets 125documentation instead. 126 127Support for wxUniversal is available from the same places as for wxWidgets 128itself, namely: 129 130* Usenet newsgroup comp.soft-sys.wxwindows 131 132* Mailing lists: see http://lists.wxwindows.org/ for more information 133 134* WWW page: http://www.wxwidgets.org/ 135 136 137 Hope you find wxUniversal useful! 138 139 Vadim Zeitlin 140 141 142This file is accurate for the version 2.3.4 of wxUniversal. It was last 143modified on Apr 15, 2002. 144 145