1
Installation instructions for the win32/msdev port of plplot
2
============================================================
6
This file contains information on how to compile and run the
7
plplot library using MS Visual C++ on PCs running MS Windows
8
98/NT/2000 (the current distribution has not been tested on
9
neither 95 nor XP however it should normally work on these
10
two versions of Windows as well.)
12
Please note that the work on the win32/msdev port is under
13
progress. These instructions will tell you how to build
14
the plplot.lib library and all the C examples except x14c
15
and x17c. However, the work on the plplot.dll is not yet
16
finished. For more information about the win32/msdev port
17
of plplot please see plplot/sys/win32/msdev/README.TXT.
22
You'll need MS Visual C++ version 5, 6 or higher for building
23
plplot. You might be able to use an earlier version of Visual C++
24
but you will probably not be able to use the provided makfiles.
25
You will also need to make sure that you can execute the "nmake"
26
command on a MS-DOS promt command line.
31
You can extract the sources of plplot in any directory you want.
36
4.1 Open a MS-DOS prompt window.
37
4.2 Change directory to plplot\sys\win32\msdev
38
4.3 Type "nmake". The files needed for the compilation of
39
plplot will be copied to plplot\tmp.
40
4.4 Change directory to plplot\sys\win32\msdev\plplib.
41
4.5 Type "nmake plplib.mak". The plplot.lib library will
42
be built and placed in the same directory.
43
4.6 Change directory to plplot\sys\win32\msdev\Examples.
44
4.7 Type "nmake Examples.mak". All C examples will be
45
built except x14c and x17c in the plplot/tmp
46
directory. (For comments about the examples see
47
plplot\sys\win32\msdev\README.TXT.)
52
You can run the C examples directly from plplot\tmp. However,
53
if you would like to run your programs in a different directory
54
you have to make sure that plplot can find the font files
55
(located in plplot/lib with the extension .fnt):
57
5.1 Set the environment variable PLPLOT_HOME to point to
58
where you have installed plplot, e.g.
59
SET PLPLOT_HOME="C:\PLPLOT"
60
(see plplot\FAQ number 1.12)
61
5.2 or simply make sure that the font files are in the same
62
directory where you execute your plplot program.
65
6. Comments & suggestions
67
If you have comments or suggestions on how to improve the
68
win32/msdev port of plplot please dont't hesitate to contact
75
European Synchrotron Radiation Facility
76
email: svensson@esrf.fr
1
Installation instructions for the win32/msdev port of plplot
2
============================================================
6
This file contains information on how to compile and run the
7
plplot library using MS Visual C++ on PCs running MS Windows
8
98/NT/2000/XP (the current distribution has not been tested on
9
Windows 95 however it should normally work on this version of
12
Please note that the work on the win32/msdev port is well
13
advanced, but not finished yet. These instructions will tell
14
you how to build the plplot.lib and plplotd.dll libraries and
15
all the C examples except x14c and x17c.
17
For more information about the win32/msdev port
18
of plplot please see plplot/sys/win32/msdev/README.TXT.
23
You'll need MS Visual C++ version 5, 6 or higher for building
24
plplot. You might be able to use an earlier version of Visual C++
25
but you will probably not be able to use the provided makfiles.
26
You will also need to make sure that you can execute the "nmake"
27
command on a MS-DOS prompt command line.
32
You can extract the sources of plplot in any directory you want.
34
Note about the sources directly from CVS:
36
If you obtain the sources via anonymous CVS from the CVS repository,
37
then be aware that one header file will be missing: the file
38
"plhershey-unicode.h". This file is normally generated by the
39
UNIX/Linux build process and is part of the PLplot distribution (the
40
compressed tar-file). It is not generated as yet as part of the
41
Windows build process.
42
Currently, a practical solution is to get the latest tar-file and
43
extract that file from it.
47
4.1 Open a MS-DOS prompt window.
48
4.2 Change directory to plplot\sys\win32\msdev
49
4.3 Type "nmake". The files needed for the compilation of
50
plplot will be copied to plplot\tmp.
51
4.4 Change directory to plplot\sys\win32\msdev\plplib.
52
4.5 Type "nmake plplib.mak". The plplot.lib library will
53
be built and placed in the same directory.
54
4.6 Change directory to plplot\sys\win32\msdev\Examples.
55
4.7 Type "nmake Examples.mak". All C examples will be
56
built except x14c and x17c in the plplot/tmp
57
directory. (For comments about the examples see
58
plplot\sys\win32\msdev\README.TXT.)
63
You can run the C examples directly from plplot\tmp. However,
64
if you would like to run your programs in a different directory
65
you have to make sure that plplot can find the font files
66
(located in plplot/lib with the extension .fnt):
68
5.1 Set the environment variable PLPLOT_HOME to point to
69
where you have installed plplot, e.g.
70
SET PLPLOT_HOME="C:\PLPLOT"
71
(see plplot\FAQ number 1.12)
72
5.2 or simply make sure that the font files are in the same
73
directory where you execute your plplot program.
76
6. Building and using the DLL
78
You must compile with the flag __PLDLL_H__ defined.
79
This is necessary to select the correct prototypes.
80
It is unfortunate, but there is - currently - no transparant
83
Some more remarks (running the examples):
84
- If an example program can not find the PLplot DLL at run-time,
85
it may display a message box saying so, or it may simply stop without
86
any output. The latter happens if you start it in a DOS-box (at least
87
that is the case on my computer, running Windows XP).
88
- If the example program can not find the font files, it will stop
89
after you have selected a device. It will probably display a message
90
to that effect, but unless you run it in a DOS-box, the message will
91
disappear very quickly.
94
7. Building and using PLplot for Java on Windows
96
(Information kindly supplied by Ali Mohammed)
98
I used the following steps to compile a jni enabled dll on windows
101
1. Microsoft Visual C compiler version 12.00. It is part of Visual Studio 6.
102
2. nmake.exe utility. It is downloadable from microsoft.com
106
7.1. download the latest tarball from the following link
107
http://plplot.sourceforge.net/cvs-tarball/
109
7.2. Use winzip to expand the compressed tar file to the C drive.
110
On my machine I have it installed under c:\plplot
112
7.3. open "c:\plplot\src\plcore.c" file in a text editor.
113
search for "getcwd()" and change it to "_getcwd()".
116
7.4. Open up a dos shell in windows. Go to the following folder
117
c:\plplot\sys\win32\msdev
118
type "nmake" and press enter. (Assuming nmake is defined in the
121
7.5. Within dos shell go to the following folder
122
c:\plplot\sys\win32\msdev\plplib
123
type "nmake plplib.mak" and press enter
125
7.6. make a folder "core" under c:\plplot
126
create a text file in this folder with the name "run.bat"
127
Type in following in this file.
129
set JAVA_HOME=C:\j2sdk1.4.2_01
130
cl /I%JAVA_HOME%\include /I%JAVA_HOME%\include\win32 /Id:\plplot\include /LD c:/plplot/bindings/java/plplotjavac_wrap.c /Fejplplot.dll /link c:\plplot\sys\win32\msdev\plplib\plplot.lib /NOD USER32.lib GDI32.lib KERNEL32.LIB MSVCRT.LIB
132
make appropriate changes based on your system environment
133
Run this batch file from command prompt.
135
On successful completion of all the above steps you will have jplplot.dll in
136
"c:\plplot\core" folder.
138
Any java application using plplot APIs should load this dll first.
141
System.load("jplplot.dll");
144
If you have any questions or difficulty, please feel free to email me.
149
email: solent@sympatico.ca
152
8. Building and using it under MicroSoft's .NET
154
PLplot, from version 5.5.3, can be built and used in MicroSoft's .NET
155
environment, if you use the C++ or C bindings. Previous versions
156
used an obsolete keyword which the C compiler under .NET complained
160
It appears that the C/C++ compiler in .NET2003 has an optimisation
161
bug/quirk which can make contour and shade drawings look bad. This means
162
that you have to turn off the optimisation for this compiler (by default
163
it is turned on in the PLplot makefile!)
166
9. Some build details
168
Because the build environment on Windows is completely different than
169
the one on Linux and UNIX, it is not possible to configure the build
170
process as smoothly as under Linux/UNIX. In particular, the options
171
in the header file "plconfig.h" are fixed in the file "makefile" in
175
10. Comments & suggestions
177
If you have comments or suggestions on how to improve the
178
win32/msdev port of plplot please dont't hesitate to contact
183
WL | Delft Hydraulics
184
email: arjen.markus@wldelft.nl
185
PLplot mailing lists: plplot-general@lists.sourceforge.net (general usage)
186
plplot-devel@lists.sourceforge.net (questions regarding