AuroraMiddleware/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
801423ee34
wxWidgets/docs/mgl/install.txt
Vadim Zeitlin 3cb332c155 Remove unnecessary mondrian.{ico,xpm} files from samples directory. 
Standardize on using sample.rc and sample icon in all the samples, it was
confusing that some of them used it and other didn't, without any apparent
logic.

Remove the now unnecessary icon files, including the dialogs sample icon which
seemed to be corrupted (this closes #11146).

Also replace multiple OS/2 resource files with a single one in the sample
directory. The OS/2 projects/makefiles would need to be updated to use them.

Remove dialogs sample icon.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@64645 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-06-20 17:42:33 +00:00

253 lines
8.6 KiB
Plaintext
Raw Blame History

wxWidgets for MGL installation
------------------------------
IMPORTANT NOTE:
wxMGL is currently in need of some work to bring it up to the
standard of some of the other wxWidgets ports.
If you experience problems installing, please re-read these
instructions and other related files (todo.txt, bugs.txt and
osname.txt for your platform if it exists) carefully before
mailing wxwin-users or the author. Preferably, try to fix the
problem first and then send a patch to the author.
When sending bug reports tell us what version of wxWidgets you are
using (including the beta) and what compiler on what system. One
example: wxMGL 2.8.0, gcc 2.95.3, Redhat 7.0
First steps
-----------
- Download SciTech MGL library from http://www.scitechsoft.com. The
downloads page is here (you need MGL version 5.0beta7 or newer):
http://scitechsoft.com/products/dev/mgl_download/mgl_down.html
Install MGL according to provided instructions. In particular, make sure that
MGL_ROOT and NUCLEUS_PATH environment variables are set before attempting to
build wxMGL.
Make sure you installed all MGL components, including the "fonts" package
(it's called mgl_<ver>-font.tar.gz in Linux version). It is important to have
SciTech's basic fonts in $(MGL_ROOT)/fonts directory (you may want to add
Arial TrueType font for better output quality) and basic cursors in
$(MGL_ROOT)/cursors. wxMGL depends on their presence.
- Download wxMGL-x.y.z.tgz, where x.y.z is the version number.
Download documentation in a preferred format, such as
wxWidgets-HTML.zip or wxWidgets-PDF.zip.
- Make a directory such as ~/wx and unarchive the files into this
directory.
- You can now use configure or makefiles to build wxWidgets and the samples.
In case of problems, please use GNU make.
COMPILING
=========
Following systems are supported by wxMGL so far:
- Unix (Linux etc.)
- MS-DOS (DJGPP and Watcom compilers)
* Compiling using configure
----------------------------
These instructions apply to installation on a Unix system (such as Linux). Please
see below for information on using configure on non-Unix platforms.
If you compile wxWidgets on Linux for the first time and don't like to read
install instructions just do (in the base dir):
> ./configure --with-mgl
> make
> su <type root password>
> make install
> ldconfig
> exit
Afterwards you can continue with
> make
> su <type root password>
> make install
> ldconfig
> exit
If you want to remove wxWidgets on Unix you can do this:
> su <type root password>
> make uninstall
> ldconfig
> exit
You can set many options to configure. Type
> ./configure --help
and you will get a list of supported options.
* Using wxMGL library built with configure
-------------------------------------------
'make install' will install wx-config script that can (and should) be used
to get compiler flags that are needed to build your program. wx-config --cxxflags
will output necessary C++ compiler flags and wx-config --libs will list all
needed libraries. See an example of wxWidgets application makefile:
minimal: minimal.o
$(CXX) -o minimal minimal.o `wx-config --libs`
minimal.o: minimal.cpp
$(CXX) `wx-config --cxxflags` -c minimal.cpp -o minimal.o
* Using configure to build MS-DOS version
------------------------------------------
Even though configure is a Unix script, you can use it to build MS-DOS version
of the wxMGL library. There are two possible ways to achieve this: you can
either cross-compile from Unix or compile natively. Either way you will needed
the DJGPP port of GCC compiler freely available from:
http://www.delorie.com/djgpp/getting.html
Scitech MGL must be compiled natively, and to do this you will need to download
the following files (from the current/v2 and current/v2gnu directories). You
should get the latest versions available rather than the exact versions shown
below, they are just an example of what to look for:
djdev203.zip B 1,530,778 020811 DJGPP development kit 2.03
bnu2161b.zip B 3,483,132 050708 GNU Binutils 2.16.1 for DJGPP V2
gcc344b.zip B 3,772,211 050527 GNU GCC 3.4.4 for DJGPP V2
gpp344b.zip B 4,026,725 050527 GNU C++ Compiler 3.4.4 for DJGPP V2
If you want to build wxMGL natively using the DJGPP compiler, you will have to
install a couple of Unix utilities. I think the following is the minimum that
will work:
bsh204b.zip B 454,308 020106 GNU Bash shell 2.04 for DJGPP V2
fil41b.zip B 1,738,170 030830 GNU fileutils 4.1 for DJGPP V2
find41b.zip B 306,826 010505 GNU findutils 4.1 for DJGPP V2
grep24b.zip B 254,997 000116 GNU Grep 2.4 for DJGPP V2
mak3791b.zip B 272,798 020106 GNU Make 3.79.1 for DJGPP V2
sed414b.zip B 159,920 050331 GNU Sed 4.1.4 for DJGPP V2
shl2011b.zip B 1,195,021 020419 GNU sh-utils 2.01 for DJGPP V2
You'll probably also want a debugger:
gdb611b.zip B 1,585,648 040629 GNU GDB Debugger 6.1.1 for DJGPP V2
And maybe some of these:
faq230b.zip B 679,865 000203 FAQ 2.30 for DJGPP v2.03
dif281b.zip B 402,859 040911 GNU Diffutils 2.8.1 for DJGPP V2
gwk314b.zip B 968,667 050321 GNU Awk 3.1.4 for DJGPP V2
gzip135b.zip B 146,138 041215 GNU gzip 1.3.5 for DJGPP V2
lss374b.zip B 199,805 020405 GNU Less 374 for DJGPP V2
pat254b.zip B 114,250 040326 GNU Patch 2.5.4 for DJGPP V2
tar112ab.zip B 236,427 000305 GNU Tar 1.12a for DJGPP V2
whic211b.zip B 86,296 000911 GNU which 2.11 for DJGPP V2
The system you compile on must support long file names. You can use Windows 9x
or an x86 version of Windows 2000/XP or later. For example:
C:\>set MGL_ROOT=c:/scitech
C:\>set DJGPP=c:/djgpp/djgpp.env
C:\>PATH=c:\djgpp\bin
C:\>set PS1=\w\$
C:\>bash
c:/$ mkdir build
c:/$ cd build
c:/build$ ../wxWidgets/configure
c:/build$ make
c:/build$ cd samples/minimal
c:/build/samples/minimal$ make
Cross-compilation is very easy. It works like ordinary compilation with
configure, you only have to specify the target:
> ./configure --with-mgl --build=i586-linux --host=i586-pc-msdosdjgpp
> make
For this to work, you must have installed a cross compiler on your system.
Linux rpms are available here:
http://ap1.pp.fi/djgpp/gcc/cross-compiler/index.html
NetBSD has a binary package which can be installed with:
# pkg_add cross-i386-msdosdjgpp
For other systems you will need to obtain the djgpp sources and compile them
yourself.
* Building wxMGL for MS-DOS using Watcom C/C++
-----------------------------------------------
<Note: this section is currently out of date>
You will need Watcom C/C++ compiler version 11 or newer (Watcom is going to be
OpenSourced by SciTech, check out http://www.openwatcom.org).
1. Edit $(WXDIR)\include\wx\univ\setup.h to suit your needs (in same way as you
do when compiling wxMSW).
2. Go to $(WXDIR)\src\mgl and run
> wmake -f makefile.wat all
3. You can compile the samples by typing 'wmake -f makefile.mgl all' in sample
directory if this file is available. If it is not, copy makefile.wat to
makefile.mgl and replace the line that says
!include $(WXDIR)\src\makeprog.wat
with
!include $(WXDIR)\src\mgl\makeprog.wat
Compilation notes for MGL with gcc
----------------------------------
The mvis library doesn't compile with current versions of gcc. However wxMGL
does not use this part of MGL, so it can be taken out of the compile, e.g.:
--- scitech/src/makefile.orig 2004-04-15 20:36:32.000000000 +0100
+++ scitech/src/makefile 2005-04-26 01:50:12.000000000 +0100
@@ -88,7 +88,7 @@
# Target to build libraries for one compiler for SciTech MGL Graphics Library
-all_mgl: $(T_PM) $(T_GCONSOLE) $(T_SNAP) $(T_TECH) $(T_MVIS) $(T_FIXED) \
+all_mgl: $(T_PM) $(T_GCONSOLE) $(T_SNAP) $(T_TECH) $(T_FIXED) \
$(T_GM) $(T_GLUT) $(T_MGL)
@$(ECHO) =============================================================================
@$(ECHO) DONE: Single compiler MGL build completed successfully!
The following small change is also required to include/tcl/hashmap.hpp:
--- scitech/include/tcl/hashtab.hpp.orig 2006-01-20 19:51:12.000000000 +0000
+++ scitech/include/tcl/hashtab.hpp 2006-01-22 14:12:12.000000000 +0000
@@ -60,7 +60,7 @@
TCHashTableNode **prev;
friend class TCGenHashTable;
- friend ostream& operator << (ostream& o,TCGenHashTable& h);
+ friend ostream& operator << (ostream& o, class TCGenHashTable& h);
public:
// Constructor to satisfy some compilers :-(
TCHashTableNode() {};
Bug reports
-----------
Please send bug reports with a description of your environment,
compiler and the error message(s) to the wxwin-developers mailing list at:
wx-dev@lists.wxwidgets.org
Vaclav Slavik, Julian Smart, Robert Roebling and Vadim Zeitlin, February 2002.
Mike Wetherell 2005/2006
Reference in New Issue View Git Blame Copy Permalink