xref: /minix3/common/dist/zlib/contrib/vstudio/readme.txt (revision 44bedb31d842b4b0444105519bcf929a69fe2dc1)
1*44bedb31SLionel SambucBuilding instructions for the DLL versions of Zlib 1.2.3
2*44bedb31SLionel Sambuc========================================================
3*44bedb31SLionel Sambuc
4*44bedb31SLionel SambucThis directory contains projects that build zlib and minizip using
5*44bedb31SLionel SambucMicrosoft Visual C++ 7.0/7.1, and Visual C++ .
6*44bedb31SLionel Sambuc
7*44bedb31SLionel SambucYou don't need to build these projects yourself. You can download the
8*44bedb31SLionel Sambucbinaries from:
9*44bedb31SLionel Sambuc  http://www.winimage.com/zLibDll
10*44bedb31SLionel Sambuc
11*44bedb31SLionel SambucMore information can be found at this site.
12*44bedb31SLionel Sambuc
13*44bedb31SLionel Sambuc
14*44bedb31SLionel SambucBuild instructions for Visual Studio 7.x (32 bits)
15*44bedb31SLionel Sambuc--------------------------------------------------
16*44bedb31SLionel Sambuc- Uncompress current zlib, including all contrib/* files
17*44bedb31SLionel Sambuc- Download the crtdll library from
18*44bedb31SLionel Sambuc    http://www.winimage.com/zLibDll/crtdll.zip
19*44bedb31SLionel Sambuc  Unzip crtdll.zip to extract crtdll.lib on contrib\vstudio\vc7.
20*44bedb31SLionel Sambuc- Open contrib\vstudio\vc7\zlibvc.sln with Microsoft Visual C++ 7.x
21*44bedb31SLionel Sambuc  (Visual Studio .Net 2002 or 2003).
22*44bedb31SLionel Sambuc
23*44bedb31SLionel SambucBuild instructions for Visual Studio 2005 (32 bits or 64 bits)
24*44bedb31SLionel Sambuc--------------------------------------------------------------
25*44bedb31SLionel Sambuc- Uncompress current zlib, including all contrib/* files
26*44bedb31SLionel Sambuc- For 32 bits only: download the crtdll library from
27*44bedb31SLionel Sambuc    http://www.winimage.com/zLibDll/crtdll.zip
28*44bedb31SLionel Sambuc  Unzip crtdll.zip to extract crtdll.lib on contrib\vstudio\vc8.
29*44bedb31SLionel Sambuc- Open contrib\vstudio\vc8\zlibvc.sln with Microsoft Visual C++ 8.0
30*44bedb31SLionel Sambuc
31*44bedb31SLionel SambucBuild instructions for Visual Studio 2005 64 bits, PSDK compiler
32*44bedb31SLionel Sambuc----------------------------------------------------------------
33*44bedb31SLionel Sambucat the time of writing this text file, Visual Studio 2005 (and
34*44bedb31SLionel Sambuc  Microsoft Visual C++ 8.0) is on the beta 2 stage.
35*44bedb31SLionel SambucUsing you can get the free 64 bits compiler from Platform SDK,
36*44bedb31SLionel Sambuc  which is NOT a beta, and compile using the Visual studio 2005 IDE
37*44bedb31SLionel Sambucsee http://www.winimage.com/misc/sdk64onvs2005/ for instruction
38*44bedb31SLionel Sambuc
39*44bedb31SLionel Sambuc- Uncompress current zlib, including all contrib/* files
40*44bedb31SLionel Sambuc- start Visual Studio 2005 from a platform SDK command prompt, using
41*44bedb31SLionel Sambuc  the /useenv switch
42*44bedb31SLionel Sambuc- Open contrib\vstudio\vc8\zlibvc.sln with Microsoft Visual C++ 8.0
43*44bedb31SLionel Sambuc
44*44bedb31SLionel Sambuc
45*44bedb31SLionel SambucImportant
46*44bedb31SLionel Sambuc---------
47*44bedb31SLionel Sambuc- To use zlibwapi.dll in your application, you must define the
48*44bedb31SLionel Sambuc  macro ZLIB_WINAPI when compiling your application's source files.
49*44bedb31SLionel Sambuc
50*44bedb31SLionel Sambuc
51*44bedb31SLionel SambucAdditional notes
52*44bedb31SLionel Sambuc----------------
53*44bedb31SLionel Sambuc- This DLL, named zlibwapi.dll, is compatible to the old zlib.dll built
54*44bedb31SLionel Sambuc  by Gilles Vollant from the zlib 1.1.x sources, and distributed at
55*44bedb31SLionel Sambuc    http://www.winimage.com/zLibDll
56*44bedb31SLionel Sambuc  It uses the WINAPI calling convention for the exported functions, and
57*44bedb31SLionel Sambuc  includes the minizip functionality. If your application needs that
58*44bedb31SLionel Sambuc  particular build of zlib.dll, you can rename zlibwapi.dll to zlib.dll.
59*44bedb31SLionel Sambuc
60*44bedb31SLionel Sambuc- The new DLL was renamed because there exist several incompatible
61*44bedb31SLionel Sambuc  versions of zlib.dll on the Internet.
62*44bedb31SLionel Sambuc
63*44bedb31SLionel Sambuc- There is also an official DLL build of zlib, named zlib1.dll. This one
64*44bedb31SLionel Sambuc  is exporting the functions using the CDECL convention. See the file
65*44bedb31SLionel Sambuc  win32\DLL_FAQ.txt found in this zlib distribution.
66*44bedb31SLionel Sambuc
67*44bedb31SLionel Sambuc- There used to be a ZLIB_DLL macro in zlib 1.1.x, but now this symbol
68*44bedb31SLionel Sambuc  has a slightly different effect. To avoid compatibility problems, do
69*44bedb31SLionel Sambuc  not define it here.
70*44bedb31SLionel Sambuc
71*44bedb31SLionel Sambuc
72*44bedb31SLionel SambucGilles Vollant
73*44bedb31SLionel Sambucinfo@winimage.com
74