]>
Commit | Line | Data |
---|---|---|
1 | wxWidgets 2.5 for MGL installation | |
2 | ------------------------------------ | |
3 | ||
4 | IMPORTANT NOTE: | |
5 | ||
6 | If you experience problems installing, please re-read these | |
7 | instructions and other related files (todo.txt, bugs.txt and | |
8 | osname.txt for your platform if it exists) carefully before | |
9 | mailing wxwin-users or the author. Preferably, try to fix the | |
10 | problem first and then send a patch to the author. | |
11 | ||
12 | When sending bug reports tell us what version of wxWidgets you are | |
13 | using (including the beta) and what compiler on what system. One | |
14 | example: wxMGL 2.5.3, gcc 2.95.3, Redhat 7.0 | |
15 | ||
16 | First steps | |
17 | ----------- | |
18 | ||
19 | - Download SciTech MGL library (version 5.0) from http://www.scitechsoft.com. | |
20 | The downloads page is here (you need MGL version 5.0beta7 or newer): | |
21 | http://www.scitechsoft.com/products/embedded/mgl_home.html | |
22 | ||
23 | Install MGL according to provided instructions. In particular, make sure that | |
24 | MGL_ROOT and NUCLEUS_PATH environment variables are set before attempting to | |
25 | build wxMGL. | |
26 | ||
27 | Make sure you installed all MGL components, including the "fonts" package | |
28 | (it's called mgl50b7-font.tar.gz in Linux version). It is important to have | |
29 | SciTech's basic fonts in $(MGL_ROOT)/fonts directory (you may want to add | |
30 | Arial TrueType font for better output quality) and basic cursors in | |
31 | $(MGL_ROOT)/cursors. wxMGL depends on their presence. | |
32 | ||
33 | - Download wxMGL-x.y.z.tgz, where x.y.z is the version number. | |
34 | Download documentation in a preferred format, such as | |
35 | wxWidgets-HTML.zip or wxWidgets-PDF.zip. | |
36 | ||
37 | - Make a directory such as ~/wx and unarchive the files into this | |
38 | directory. | |
39 | ||
40 | - It is recommended that you install bison and flex; using yacc | |
41 | and lex may require tweaking of the makefiles. | |
42 | ||
43 | - You can now use configure or makefiles to build wxWidgets and the samples. | |
44 | In case of problems, please use GNU make. | |
45 | ||
46 | ||
47 | COMPILING | |
48 | ========= | |
49 | ||
50 | Following systems are supported by wxMGL so far: | |
51 | - Unix (Linux etc.) | |
52 | - MS-DOS (DJGPP and Watcom compilers) | |
53 | ||
54 | ||
55 | * Compiling using configure | |
56 | ---------------------------- | |
57 | ||
58 | These instructions apply to installation on a Unix system (such as Linux). Please | |
59 | see bellow for information on using configure on non-Unix platforms. | |
60 | ||
61 | If you compile wxWidgets on Linux for the first time and don't like to read | |
62 | install instructions just do (in the base dir): | |
63 | ||
64 | > ./configure --with-mgl | |
65 | > make | |
66 | > su <type root password> | |
67 | > make install | |
68 | > ldconfig | |
69 | > exit | |
70 | ||
71 | Afterwards you can continue with | |
72 | ||
73 | > make | |
74 | > su <type root password> | |
75 | > make install | |
76 | > ldconfig | |
77 | > exit | |
78 | ||
79 | If you want to remove wxWidgets on Unix you can do this: | |
80 | ||
81 | > su <type root password> | |
82 | > make uninstall | |
83 | > ldconfig | |
84 | > exit | |
85 | ||
86 | You can set many options to configure. Type | |
87 | ||
88 | > ./configure --help | |
89 | ||
90 | and you will get a list of supported options. | |
91 | ||
92 | ||
93 | * Using wxMGL library built with configure | |
94 | ------------------------------------------- | |
95 | ||
96 | 'make install' will install wx-config script that can (and should) be used | |
97 | to get compiler flags that are needed to build your program. wx-config --cxxflags | |
98 | will output necessary C++ compiler flags and wx-config --libs will list all | |
99 | needed libraries. See an example of wxWidgets application makefile: | |
100 | ||
101 | minimal: minimal.o | |
102 | $(CC) -o minimal minimal.o `wx-config --libs` | |
103 | ||
104 | minimal.o: minimal.cpp mondrian.xpm | |
105 | $(CC) `wx-config --cxxflags` -c minimal.cpp -o minimal.o | |
106 | ||
107 | ||
108 | * Using configure to build MS-DOS version | |
109 | ------------------------------------------ | |
110 | ||
111 | Even though configure is a Unix script, you can use it to build MS-DOS version | |
112 | of the wxMGL library. There are two possible ways to achieve this: you can | |
113 | either cross-compile from Unix or compile natively. Either way you will needed | |
114 | the DJGPP port of GCC compiler freely available from http://www.djgpp.org. You will | |
115 | also need DJGPP version of SciTech MGL (this must be built using native tools). | |
116 | ||
117 | Cross-compilation is very easy. It works like ordinary compilation with configure, | |
118 | you only have to specify the target: | |
119 | ||
120 | > ./configure --with-mgl --build=i586-linux --host=i586-pc-msdosdjgpp | |
121 | > make | |
122 | ||
123 | If you want to build wxMGL natively using DJGPP compiler, you will have to install | |
124 | a couple of Unix utilities. The easiest way to get them is to install the Cygwin | |
125 | package (available from RedHat, see http://freshmeat.net/search/?q=cygwin for exact | |
126 | URL). Cygwin contains win32 compiler, so make sure you did *not* install it! Once | |
127 | you have Cygwin utilities and DJGPP compiler in your PATH, run bash.exe and type | |
128 | ||
129 | > ./configure --with-mgl | |
130 | > make | |
131 | ||
132 | in wxWidgets top directory. You can build wxMGL in MS-DOS with configure, sorry. | |
133 | ||
134 | ||
135 | * Building wxMGL for MS-DOS using Watcom C/C++ | |
136 | ----------------------------------------------- | |
137 | ||
138 | You will need Watcom C/C++ compiler version 11 or newer (Watcom is going to be | |
139 | OpenSourced by SciTech, check out http://www.openwatcom.org). | |
140 | ||
141 | 1. Edit $(WXDIR)\include\wx\univ\setup.h to suit your needs (in same way as you | |
142 | do when compiling wxMSW). | |
143 | ||
144 | 2. Go to $(WXDIR)\src\mgl and run | |
145 | > wmake -f makefile.wat all | |
146 | ||
147 | 3. You can compile the samples by typing 'wmake -f makefile.mgl all' in sample | |
148 | directory if this file is available. If it is not, copy makefile.wat to | |
149 | makefile.mgl and replace the line that says | |
150 | ||
151 | !include $(WXDIR)\src\makeprog.wat | |
152 | ||
153 | with | |
154 | ||
155 | !include $(WXDIR)\src\mgl\makeprog.wat | |
156 | ||
157 | ||
158 | Bug reports | |
159 | ----------- | |
160 | ||
161 | Please send bug reports with a description of your environment, | |
162 | compiler and the error message(s) to the wxwin-developers mailing list at: | |
163 | ||
164 | wx-dev@lists.wxwindows.org | |
165 | ||
166 | Vaclav Slavik, Julian Smart, Robert Roebling and Vadim Zeitlin, February 2002. |