Update the changelog
[opencv] / otherlibs / _graphics / readme.txt
1 This folder contains libraries and headers of a few\rvery popular still image codecs used by highgui.
2 The libraries and headers are only to build Win32 and Win64 versions of OpenCV.
3 On UNIX systems all the libraries are automatically detected by configure script.
4
5 ------------------------------------------------------------------------------------\r
6 libjpeg 6b (6.2) - The Independent JPEG Group's JPEG software.\r             Copyright (C) 1994-1997, Thomas G. Lane.
7              See IGJ home page http://www.ijg.org
8              for details and links to the source code
9
10              HAVE_JPEG preprocessor flag must be set to make highgui use libjpeg.\r             On UNIX systems configure script takes care of it.
11
12 ------------------------------------------------------------------------------------\r
13 libpng 1.2.1 - Portable Network Graphics library.
14                Copyright (C) 1998-2001, Glenn Randers-Pehrson.
15                See libpng home page http://www.libpng.org
16                for details and links to the source code
17
18                HAVE_PNG preprocessor flag must be set to make highgui use libpng.\r               On UNIX systems configure script takes care of it.
19
20 ------------------------------------------------------------------------------------\r
21 libtiff 3.5.7 - Tag Image File Format (TIFF) Software
22                 Copyright (c) 1988-1997 Sam Leffler
23                 Copyright (c) 1991-1997 Silicon Graphics, Inc.
24                 See libtiff home page http://www.libtiff.org
25                 for details and links to the source code
26
27 \r                HAVE_TIFF preprocessor flag must be set to make highgui use libtiff.
28                 On UNIX systems configure script takes care of it.
29
30                 In this build support for ZIP (LZ77 compression), JPEG and LZW
31                 are included.\r
32 ------------------------------------------------------------------------------------\r
33 zlib 1.1.4 - General purpose LZ77 compression library
34              Copyright (C) 1995-2002 Jean-loup Gailly and Mark Adler.
35              See zlib home page http://www.gzip.org/zlib
36              for details and links to the source code
37
38              No preprocessor definition is needed to make highgui use this library -\r             it is included automatically if either libpng or libtiff are used.
39
40 ------------------------------------------------------------------------------------
41
42 jasper-1.701.0 - JasPer is a collection of software
43              (i.e., a library and application programs) for the coding
44              and manipulation of images.  This software can handle image data in a
45              variety of formats.  One such format supported by JasPer is the JPEG-2000
46              format defined in ISO/IEC 15444-1.
47              
48              Copyright (c) 1999-2000 Image Power, Inc.
49              Copyright (c) 1999-2000 The University of British Columbia
50              Copyright (c) 2001-2003 Michael David Adams
51
52              The JasPer license can be found in src/libjasper.
53              
54              OpenCV on Windows uses pre-built libjasper library
55              (lib/libjasper*). To get the latest source code,
56              please, visit the project homepage:
57              http://www.ece.uvic.ca/~mdadams/jasper/
58
59 ------------------------------------------------------------------------------------
60
61 openexr-1.4.0 - OpenEXR is a high dynamic-range (HDR) image file format developed
62                 by Industrial Light & Magic for use in computer imaging applications.
63
64              Copyright (c) 2004, Industrial Light & Magic, a division of Lucasfilm
65              Entertainment Company Ltd.  Portions contributed and copyright held by
66              others as indicated.  All rights reserved.
67
68              The project homepage: http://www.openexr.com/
69
70              OpenCV on Windows does not include openexr codec by default.
71              To add it, you will need to recompile highgui with OpenEXR support
72              using VS.NET2003 or VS.NET2005 (MSVC6 can not compile it):
73              1) download binaries (e.g. openexr-1.4.0-vs2005.zip)
74                 from the official site.
75              2) copy
76                 half.lib, iex.lib, ilmimf.lib ilmthread.lib imath.lib to
77                 _graphics/lib
78              3) copy include/openexr/*.h to _graphics/include/openexr
79              4) open _make/opencv.sln
80              5) in highgui/_highgui.h uncomment
81                 #define HAVE_ILMIMF 1
82              6) build debug/release configurations of highgui.
83
84 ------------------------------------------------------------------------------------
85
86 The folder lib also contains libvfw_*.a import libraries that enable to
87 build vfw camera/avi capture code of highgui with Mingw compiler.
88
89 The files have been taken from http://mywebpage.netscape.com/PtrPck/multimedia.htm site.\rBesides the libraries, you will also need the following headers that are missing in Mingw:
90 msacm.h, mmreg.h, vfw.h, vfwmsgs.h, verinfo.h, verinfo.ver, digitalv.h.
91 Copy them to <GCC_HOME>\include
92 You may take them, for example, from Microsoft Platform SDK or
93 Borland C++ 5.5 free compiler.
94
95 ------------------------------------------------------------------------------------