/usr/share/doc/libraw-dev/Install-LibRaw.html is in libraw-doc 0.18.8-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>LibRaw Compilation and Installation</title>
</head>
<body>
<a href=index.html>[back to Index]</a>
<h1>LibRaw Compilation and Installation</h1>
<p>LibRaw is distributed in the form of source codes. For further use, they should be compiled (and, if desired, placed into
system folders with libraries and include-files).</p>
<a name="unix"></a>
<h2>Unix Systems (FreeBSD, Linux, Mac OS X)</h2>
<p>
To build the library, you will need a working C++ compiler (gcc ver. 3.x or 4.x will be OK; other compilers have
not been tested) and the make utility. No other libraries or utilities are required.</p>
<p>
LibRaw has been tested on 32- and 64-bit Unix systems working on x86- (and AMD64-) compatible processors.
Building and work on other architectures have not been tested.
</p>
<h3>Compilation of Library and Examples</h3>
<p>
Unpack the downloaded distribution package. If you wish to use LibRaw-demosaic-pack(s), unpack these archives
too:
</p>
<pre>
tar xzvf LibRaw-X.YY.tar.gz
tar xzvf LibRaw-demosaic-pack-GPL2-X.YY.tar.gz
tar xzvf LibRaw-demosaic-pack-GPL3-X.YY.tar.gz
tar xzvf LibRaw-X.YY.tar.gz
</pre>
<p>Go to LibRaw directory and run <b>./configure</b> and <b>make</b>:
</p>
<pre>
cd LibRaw-X.YY
./condigure # with optional args
make
</pre>
<p>As a result, you will compile</p>
<ul>
<li>Library libraw.a in the lib/ folder</li>
<li><a href=Samples-LibRaw.html>Examples</a> in the bin/ folder (source codes of examples are in the samples/ folder).</li>
</ul>
<p>In the current version, only static libraries are built:</p>
<ul>
<li>libraw.a: non-thread-safe version</li>
<li>libraw_r.a: thread-safe</li>
</ul>
<h3>Build parameters</h3>
<p>
./configure script have some non-standard parameters:
</p>
<dl>
<dt>
--enable-openmp<br/>
--disable-openmp
</dt>
<dd>
Enable/disable OpenMP support if compiler supports it.
OpenMP is enabled by default.
</dd>
<dt>
--enable-lcms<br/>
--disable-lcms
</dt>
<dd>
Enable/disable LCMS color engine support. If enabled, ./configure will try to
find lcms library. Both LCMS-1.x and LCMS-2.x are supported
LCMS support is enabled by default
</dd>
<dt>
--enable-examples<br/>
--disable-examples
</dt>
<dd>
Enables/disables examples compilation and installation. Enabled by default
</dd>
<dt>
--enable-demosaic-pack-gpl2<br/>
--enable-demosaic-pack-gpl2=FOLDERNAME<br/>
--enable-demosaic-pack-gpl2=no<br/>
--disable-demosaic-pack-gpl2
</dt>
<dd>
Enables/disables support of additional demosaic methods licensed under GPL2
You need to download and unpack LibRaw-demosaic-pack-GPL2 archive to use
this feature.<br/>
./configure will try to find demosaic pack in:
<ul>
<li>If folder is specified via --enable-demosaic-pack-gpl2=FOLDERNAME
command-line option, then only this folder will be checked.
</li>
<li>If no folder is specified in --enable-demosaic-pack-gpl2 switch:
<ul>
<li>./LibRaw-demosaic-pack-GPL2 (in LibRaw folder)</li>
<li>../LibRaw-demosaic-pack*GPL2* - upper level folder</li>
</ul>
If several ../LibRaw-demosaic-pack*GPL2* folders exists in upper level
catalog, then ./configure will NOT use any of them due of ambiguity.
Specify exact folder name in this case using
--enable-demosaic-pack-gpl2=FOLDERNAME
</li>
</ul>
</dd>
<dt>
--enable-demosaic-pack-gpl3<br/>
--enable-demosaic-pack-gpl3=FOLDERNAME<br/>
--enable-demosaic-pack-gpl3=no<br/>
--disable-demosaic-pack-gpl3
</dt>
<dd>
Same as above, but for GPL3-licensed demosaic pack.
</dd>
</dl>
<h3>Installation and Usage</h3>
<p>To install the library, run</p>
<pre>
sudo make install
</pre>
<p>
It will place the libraries in <b>/usr/local/lib</b>, the include-files in <b>/usr/local/include</b> (subfolder of
libraw) and LibRaw samples to <b>/usr/local/bin</b>. You can override installation path by using
./configure script.
<br/>
To use LibRaw, add the following parameters to the compiler call (when building your own projects):
</p>
<ul>
<li>Path to include-files: -I/usr/local/include</li>
<li>Path to libraries: -L/usr/local/lib</li>
<li>Library: -lraw (ordinary version) or -lraw_r (thread-safe version).</li>
</ul>
<h2>Windows: Building under Cygwin</h2>
<p>
Building and installation are completely similar to <a href="#unix">building and installation under Unix systems</a>.
</p>
<h2>Windows: Native Building</h2>
<p>
Building under Windows has three steps:
</p>
<ul>
<li>Unpack the distribution package (if you have got no tar+gzip, take the LibRaw distribution package in the .ZIP format) and go to folder
LibRaw-X.YYY.
</li>
<li>Set the environment parameters so that the compiler/linker would find the libraries and include-files. For Visual C++, this is
done by running <b>vcvars32.bat</b>.
</li>
<li>
Run<br/>
<b>nmake -f Makefile.msvc</b><br/>
</li>
</ul>
<p>
If all paths are set correctly and the include-files/libraries have been found, then the following will be compiled:</p>
<ul>
<li>Library libraw_static.lib in folder lib</li>
<li>Dynamic library bin/libraw.dll and linking library for it lib/libraw.lib</li>
<li>Examples in folder bin/.</li>
</ul>
<p>Only the thread-safe library is built under Win32, but it can be used with non-threaded applications as well. All examples are linked
with the dynamic library (DLL); if static linking is necessary, one should link applications with library libraw_static.lib and
set the preprocessor option /DLIBRAW_NODLL during compilation.
</p>
<p>
Windows-version compiles without LCMS support for now.
</p>
<p>
During building of DLL, all public functions are exported; further, the exported subset may be reduced.
</p>
<p>
Unfortunately, paths to include/ libraries depend on the way Visual C (or other compiler) is installed; therefore, it is impossible
to specify some standard paths in Makefile.msvc.
</p>
<h2>Windows Installation</h2>
<p>
No installation under Windows is supported. It is assumed that all DLLs will be supplied together with the software using them
(and this software will perform the installation). Accordingly, in building of programs using LibRaw, the paths to libraries, DLLs,
and include-files should be specified manually.
</p>
<a href=index.html>[back to Index]</a>
</body>
</html>
|