Blame - INSTALL - platform/external/libpng

blob: f8f400a341f15008c3331d7c0e93cd496f8f5042 [file] [log] [blame]

Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	1
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	2	Installing libpng version 1.0.9beta10 - January 16, 2001
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	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	13	might be called "libpng-1.0.9beta10" 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
				31	borland
Glenn Randers-Pehrson	5e5c1e1	2000-11-10 12:26:19 -0600	[diff] [blame]	32	msvc
				33	wince
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	34	scripts
				35	makefile.*
				36	pngtest.png
				37	etc.
				38	zlib
				39	README
				40	*.h
				41	*.c
				42	contrib
				43	etc.
				44
Glenn Randers-Pehrson	61c32d9	2000-02-04 23:40:16 -0600	[diff] [blame]	45	If the line endings in the files look funny, you may wish to get the other
				46	distribution of libpng. It is available in both tar.gz (UNIX style line
				47	endings) and zip (DOS style line endings) formats.
				48
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	49	If you are building libpng with MSVC, you can enter the libpng\msvc directory
Glenn Randers-Pehrson	15dac0b	2000-07-10 07:48:54 -0500	[diff] [blame]	50	and follow the instructions in msvc\README.txt. You can build libpng for
				51	WindowsCE by entering the libpng\wince directory and following the
				52	instructions in the README* files.
Glenn Randers-Pehrson	d436672	2000-06-04 14:29:29 -0500	[diff] [blame]	53
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	54	Else enter the zlib directory and follow the instructions in zlib/README,
				55	then come back here and choose the appropriate makefile.sys in the scripts
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	56	directory.
Glenn Randers-Pehrson	db66d44	2000-06-23 21:38:16 -0500	[diff] [blame]	57
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	58	The files that are presently available in the scripts directory
				59	include
				60
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	61	makefile.std => Generic UNIX makefile (cc, creates static libpng.a)
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	62	makefile.linux => Linux/ELF makefile (gcc, creates libpng.so.2.1.0.9beta10)
				63	makefile.gcmmx => Linux/ELF makefile (gcc, creates libpng.so.2.1.0.9beta10,
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	64	uses assembler code tuned for Intel MMX platform)
				65	makefile.gcc => Generic makefile (gcc, creates static libpng.a)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	66	makefile.knr => Archaic UNIX Makefile that converts files with
				67	ansi2knr (Requires ansi2knr.c from
				68	ftp://ftp.cs.wisc.edu/ghost)
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	69	makefile.aix => AIX makefile
Glenn Randers-Pehrson	5e5c1e1	2000-11-10 12:26:19 -0600	[diff] [blame]	70	makefile.cygwin => Cygwin/gcc makefile
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	71	makefile.dec => DEC Alpha UNIX makefile
				72	makefile.hpux => HPUX (10.20 and 11.00) makefile
Glenn Randers-Pehrson	68ea243	2000-04-01 21:10:05 -0600	[diff] [blame]	73	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]	74	makefile.intel => Intel C/C++ version 4.0 and later
Glenn Randers-Pehrson	68ea243	2000-04-01 21:10:05 -0600	[diff] [blame]	75	libpng.icc => Project file for IBM VisualAge/C++ version 4.0 or later
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	76	makefile.macosx => MACOS X Makefile
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	77	makefile.sgi => Silicon Graphics IRIX makefile (cc, creates static lib)
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	78	makefile.sggcc => Silicon Graphics (gcc, creates libpng.so.2.1.0.9beta10)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	79	makefile.sunos => Sun makefile
Glenn Randers-Pehrson	fbbb5ec	2001-01-15 22:01:20 -0600	[diff] [blame^]	80	makefile.solaris => Solaris 2.X makefile (gcc, creates libpng.so.2.1.0.9beta10)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	81	makefile.sco => For SCO OSr5 ELF and Unixware 7 with Native cc
				82	makefile.mips => MIPS makefile
				83	makefile.acorn => Acorn makefile
				84	makefile.amiga => Amiga makefile
				85	smakefile.ppc => AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
				86	(Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
				87	makefile.atari => Atari makefile
				88	makefile.beos => BEOS makefile for X86
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	89	makefile.bor => Borland makefile (uses bcc)
				90	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]	91	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]	92	makefile.tc3 => Turbo C 3.0 makefile
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	93	makefile.dj2 => DJGPP 2 makefile
				94	makefile.msc => Microsoft C makefile
				95	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]	96	assembler code tuned for Intel MMX platform)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	97	makefile.vcwin32 => makefile for Microsoft Visual C++ 4.0 and later (does
				98	not use assembler code)
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	99	makefile.os2 => OS/2 Makefile (gcc and emx, requires pngos2.def)
				100	pngos2.def => OS/2 module definition file used by makefile.os2
				101	makefile.watcom => Watcom 10a+ Makefile, 32-bit flat memory model
				102	makevms.com => VMS build script
Glenn Randers-Pehrson	520a764	2000-03-21 05:13:06 -0600	[diff] [blame]	103	descrip.mms => VMS makefile for MMS or MMK
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	104	pngdef.pas => Defines for a png32bd.dll with Borland C++ 4.5
				105	SCOPTIONS.ppc => Used with smakefile.ppc
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	106
				107	Copy the file (or files) that you need from the
				108	scripts directory into this directory, for example
				109
Glenn Randers-Pehrson	860ab2b	1999-10-14 07:43:10 -0500	[diff] [blame]	110	MSDOS example: copy scripts\makefile.msc makefile
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	111	UNIX example: cp scripts/makefile.std makefile
				112
				113	Read the makefile to see if you need to change any source or
				114	target directories to match your preferences.
				115
				116	Then read pngconf.h to see if you want to make any configuration
				117	changes.
				118
				119	Then just run "make test" which will create the libpng library in
				120	this directory and run a quick test that reads the "pngtest.png"
				121	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]	122	Look for "9782 zero samples" in the output of the test. For more
				123	confidence, you can run another test by typing "pngtest pngnow.png"
Glenn Randers-Pehrson	6d8f3b0	1999-10-23 08:39:18 -0500	[diff] [blame]	124	and looking for "289 zero samples" in the output. Also, you can
				125	run "pngtest -m *.png" in the "contrib/pngsuite" directory and compare
				126	your output with the result shown in contrib/pngsuite/README.
Glenn Randers-Pehrson	08a3343	1998-03-07 06:06:55 -0600	[diff] [blame]	127
				128	Most of the makefiles will allow you to run "make install" to
				129	put the library in its final resting place (if you want to
				130	do that, run "make install" in the zlib directory first if necessary).
				131
				132	Further information can be found in the README and libpng.txt
Glenn Randers-Pehrson	5e5c1e1	2000-11-10 12:26:19 -0600	[diff] [blame]	133	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^]	134	subdirectories of the LIB directory, and the manual pages libpng.3 and png.5.