Blame - INSTALL - platform/external/libpng

blob: efd61ea44edbcd13b598e1b8b8f125793effcc90 [file] [log] [blame]

Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	1
Glenn Randers-Pehrson	c1bfe68	2002-03-06 22:08:00 -0600	[diff] [blame^]	2	Installing libpng version 1.2.2beta3 - March 7, 2002
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	3
				4	Before installing libpng, you must first install zlib. zlib
				5	can usually be found wherever you got libpng. zlib can be
				6	placed in another directory, at the same level as libpng.
				7	Note that your system might already have a preinstalled
Glenn Randers-Pehrson	5c6aeb2	1998-12-29 11:47:59 -0600	[diff] [blame]	8	zlib, but you will still need to have access to the
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	9	zlib.h and zconf.h include files that correspond to the
				10	version of zlib that's installed.
				11
				12	You can rename the directories that you downloaded (they
Glenn Randers-Pehrson	c1bfe68	2002-03-06 22:08:00 -0600	[diff] [blame^]	13	might be called "libpng-1.2.2beta3" or "lpng109" and "zlib-1.1.3"
Glenn Randers-Pehrson	5c6aeb2	1998-12-29 11:47:59 -0600	[diff] [blame]	14	or "zlib113") so that you have directories called "zlib" and "libpng".
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	15
				16	Your directory structure should look like this:
				17
				18	.. (the parent directory)
				19	libpng (this directory)
				20	INSTALL (this file)
				21	README
				22	*.h
				23	*.c
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	24	contrib
				25	gregbook
Glenn Randers-Pehrson	d436672	2000-06-04 14:29:29 -0500	[diff] [blame]	26	msvctest
Glenn Randers-Pehrson	6d8f3b0	1999-10-23 08:39:18 -0500	[diff] [blame]	27	pngminus
				28	pngsuite
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	29	visupng
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame]	30	projects
Glenn Randers-Pehrson	3097f61	2001-05-07 14:52:45 -0500	[diff] [blame]	31	beos
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame]	32	borland
Glenn Randers-Pehrson	5e5c1e1	2000-11-10 12:26:19 -0600	[diff] [blame]	33	msvc
Glenn Randers-Pehrson	b182893	2001-06-23 08:03:17 -0500	[diff] [blame]	34	netware.txt
				35	wince.txt
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	36	scripts
				37	makefile.*
				38	pngtest.png
				39	etc.
				40	zlib
				41	README
				42	*.h
				43	*.c
				44	contrib
				45	etc.
				46
Glenn Randers-Pehrson	61c32d9	2000-02-04 23:40:16 -0600	[diff] [blame]	47	If the line endings in the files look funny, you may wish to get the other
				48	distribution of libpng. It is available in both tar.gz (UNIX style line
				49	endings) and zip (DOS style line endings) formats.
				50
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	51	If you are building libpng with MSVC, you can enter the libpng\msvc directory
Glenn Randers-Pehrson	b182893	2001-06-23 08:03:17 -0500	[diff] [blame]	52	and follow the instructions in msvc\README.txt.
				53
				54	You can build libpng for WindowsCE by entering the downloading and installing
				55	the libpng\wince directory as instructed in the projects\wince.txt file, and
				56	then following the instructions in the README* files. Similarly, you can
				57	build libpng for Netware as instructed in projects\netware.txt.
Glenn Randers-Pehrson	d436672	2000-06-04 14:29:29 -0500	[diff] [blame]	58
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	59	Else enter the zlib directory and follow the instructions in zlib/README,
				60	then come back here and choose the appropriate makefile.sys in the scripts
Glenn Randers-Pehrson	d56aca7	2000-11-23 11:51:42 -0600	[diff] [blame]	61	directory.
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	62
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	63	The files that are presently available in the scripts directory
				64	include
				65
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	66	makefile.std => Generic UNIX makefile (cc, creates static libpng.a)
Glenn Randers-Pehrson	c1bfe68	2002-03-06 22:08:00 -0600	[diff] [blame^]	67	makefile.linux => Linux/ELF makefile (gcc, creates libpng12.so.0.1.2.2beta3)
				68	makefile.gcmmx => Linux/ELF makefile (gcc, creates libpng12.so.0.1.2.2beta3,
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	69	uses assembler code tuned for Intel MMX platform)
				70	makefile.gcc => Generic makefile (gcc, creates static libpng.a)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	71	makefile.knr => Archaic UNIX Makefile that converts files with
				72	ansi2knr (Requires ansi2knr.c from
				73	ftp://ftp.cs.wisc.edu/ghost)
Glenn Randers-Pehrson	d56aca7	2000-11-23 11:51:42 -0600	[diff] [blame]	74	makefile.aix => AIX makefile
Glenn Randers-Pehrson	5e5c1e1	2000-11-10 12:26:19 -0600	[diff] [blame]	75	makefile.cygwin => Cygwin/gcc makefile
Glenn Randers-Pehrson	5cded0b	2001-11-07 07:10:08 -0600	[diff] [blame]	76	makefile.darwin => Darwin makefile
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	77	makefile.dec => DEC Alpha UNIX makefile
Glenn Randers-Pehrson	3097f61	2001-05-07 14:52:45 -0500	[diff] [blame]	78	makefile.hpgcc => HPUX makefile using gcc
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	79	makefile.hpux => HPUX (10.20 and 11.00) makefile
Glenn Randers-Pehrson	68ea243	2000-04-01 21:10:05 -0600	[diff] [blame]	80	makefile.ibmc => IBM C/C++ version 3.x for Win32 and OS/2 (static)
Glenn Randers-Pehrson	ec61c23	2000-05-16 06:17:36 -0500	[diff] [blame]	81	makefile.intel => Intel C/C++ version 4.0 and later
Glenn Randers-Pehrson	68ea243	2000-04-01 21:10:05 -0600	[diff] [blame]	82	libpng.icc => Project file for IBM VisualAge/C++ version 4.0 or later
Glenn Randers-Pehrson	d56aca7	2000-11-23 11:51:42 -0600	[diff] [blame]	83	makefile.macosx => MACOS X Makefile
Glenn Randers-Pehrson	3097f61	2001-05-07 14:52:45 -0500	[diff] [blame]	84	makefile.netbsd => NetBSD/cc makefile, uses PNGGCCRD
Glenn Randers-Pehrson	c1bfe68	2002-03-06 22:08:00 -0600	[diff] [blame^]	85	makefile.openbsd => OpenBSD makefile
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	86	makefile.sgi => Silicon Graphics IRIX makefile (cc, creates static lib)
Glenn Randers-Pehrson	c1bfe68	2002-03-06 22:08:00 -0600	[diff] [blame^]	87	makefile.sggcc => Silicon Graphics (gcc, creates libpng12.so.0.1.2.2beta3)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	88	makefile.sunos => Sun makefile
Glenn Randers-Pehrson	c1bfe68	2002-03-06 22:08:00 -0600	[diff] [blame^]	89	makefile.solaris => Solaris 2.X makefile (gcc, creates libpng12.so.0.1.2.2beta3)
				90	makefile.so9 => Solaris 9 makefile (gcc, creates libpng12.so.0.1.2.2beta3)
				91	makefile.32sunu => Sun Ultra 32-bit makefile
				92	makefile.64sunu => Sun Ultra 64-bit makefile
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	93	makefile.sco => For SCO OSr5 ELF and Unixware 7 with Native cc
				94	makefile.mips => MIPS makefile
				95	makefile.acorn => Acorn makefile
				96	makefile.amiga => Amiga makefile
				97	smakefile.ppc => AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
				98	(Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
				99	makefile.atari => Atari makefile
				100	makefile.beos => BEOS makefile for X86
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	101	makefile.bor => Borland makefile (uses bcc)
				102	makefile.bc32 => 32-bit Borland C++ (all modules compiled in C mode)
Glenn Randers-Pehrson	61c32d9	2000-02-04 23:40:16 -0600	[diff] [blame]	103	makefile.bd32 => To make a png32bd.dll with Borland C++ 4.5
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	104	makefile.tc3 => Turbo C 3.0 makefile
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	105	makefile.dj2 => DJGPP 2 makefile
				106	makefile.msc => Microsoft C makefile
				107	makefile.vcawin32 => makefile for Microsoft Visual C++ 5.0 and later (uses
Glenn Randers-Pehrson	61c32d9	2000-02-04 23:40:16 -0600	[diff] [blame]	108	assembler code tuned for Intel MMX platform)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	109	makefile.vcwin32 => makefile for Microsoft Visual C++ 4.0 and later (does
				110	not use assembler code)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	111	makefile.os2 => OS/2 Makefile (gcc and emx, requires pngos2.def)
				112	pngos2.def => OS/2 module definition file used by makefile.os2
				113	makefile.watcom => Watcom 10a+ Makefile, 32-bit flat memory model
				114	makevms.com => VMS build script
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	115	descrip.mms => VMS makefile for MMS or MMK
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	116	pngdef.pas => Defines for a png32bd.dll with Borland C++ 4.5
				117	SCOPTIONS.ppc => Used with smakefile.ppc
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	118
				119	Copy the file (or files) that you need from the
				120	scripts directory into this directory, for example
				121
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	122	MSDOS example: copy scripts\makefile.msc makefile
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	123	UNIX example: cp scripts/makefile.std makefile
				124
				125	Read the makefile to see if you need to change any source or
				126	target directories to match your preferences.
				127
				128	Then read pngconf.h to see if you want to make any configuration
				129	changes.
				130
				131	Then just run "make test" which will create the libpng library in
				132	this directory and run a quick test that reads the "pngtest.png"
				133	file and writes a "pngout.png" file that should be identical to it.
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	134	Look for "9782 zero samples" in the output of the test. For more
				135	confidence, you can run another test by typing "pngtest pngnow.png"
Glenn Randers-Pehrson	6d8f3b0	1999-10-23 08:39:18 -0500	[diff] [blame]	136	and looking for "289 zero samples" in the output. Also, you can
				137	run "pngtest -m *.png" in the "contrib/pngsuite" directory and compare
				138	your output with the result shown in contrib/pngsuite/README.
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	139
				140	Most of the makefiles will allow you to run "make install" to
				141	put the library in its final resting place (if you want to
				142	do that, run "make install" in the zlib directory first if necessary).
				143
				144	Further information can be found in the README and libpng.txt
Glenn Randers-Pehrson	5e5c1e1	2000-11-10 12:26:19 -0600	[diff] [blame]	145	files, in the individual makefiles, in png.h, in the README files in
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame]	146	subdirectories of the LIB directory, and the manual pages libpng.3 and png.5.