README
README.unix
1To build png2ico on a Unix-like platform simply issue the command
2
3 make
4
5You need to have libpng installed. Furthermore, the Makefile uses the
6GNU C++ compiler g++ by default. If you don't have g++, change the Makefile to
7use your compiler instead.
8
9There should be no problems building the program on a GNU/Linux system. If you
10can provide information about building on other platforms, let me know.
11
12The Makefile does not have an install target. To install the program, just
13copy the binary png2ico to wherever you want it (e.g. /usr/local/bin/) and
14the manpage doc/png2ico.1 to an appropriate directory
15(e.g. /usr/local/man/man1/).
16
README.win
1The following instructions describe how to build png2ico under Windows,
2using Borland C++ 5.5 (which can be downloaded free of charge). If you
3manage to build png2ico with a different Windows compiler, please send me
4appropriate build instructions.
5
61. Preconditions
7
81.1 STLport
9
10png2ico needs the hash_map class which is not included in the BC++ 5.5
11package by default. You can install STLport (www.stlport.org) to overcome
12this. I have had no trouble installing STLport 4.0 but later versions didn't
13work for me.
14
15Note that you should not add a -I line to bcc32.cfg. If you do this, libpng
16and/or zlib may fail to build. Instead, change the STLPORT_DIR line in
17makefile.bcc32 according to your installation.
18
191.2 libpng
20
21png2ico needs libpng (www.libpng.org). I have successfully used version
221.2.3 for building png2ico. Later versions may or may not work.
23Extract libpng into a directory named libpng inside the directory where
24png2ico.cpp is located, so that from png2ico.cpp's directory, the path
25libpng\png.h is valid.
26
271.3 zlib
28
29libpng needs zlib (www.zlib.org). I have successfully used version 1.1.4
30for building libpng 1.2.3.
31Extract zlib into a directory zlib so that from the directory where
32png2ico.cpp is located, zlib's header is accessible as zlib\zlib.h.
33
34
352. Building
36
37I assume that the Borland build tools are all in the PATH. You should
38especially make sure that the program "make" found through PATH is the
39proper one.
40
41Now start the build with the command
42
43 make -f makefile.bcc32
44
45If you set up everything properly, this will build zlib, then libpng, then
46png2ico.exe.
47
48
493. Troubleshooting
50
51If you encounter problems AND have solutions for them, I'll be happy to
52add them to this file if you mail me.
53If you have only problems without solutions, I'm sorry, but you're on your
54own. I can't help you. I was pretty happy myself when I finally managed to
55compile png2ico under Windows. I do all my development under Linux and have
56only little experience with build tools under Windows.
57If you absolutely can't get it to work, just use the precompiled .exe file.
58
59
60