source: general/graphlib/libraw.xml@ 1c2e98f

trunk
Last change on this file since 1c2e98f was 253ae3f, checked in by Bruce Dubbs <bdubbs@…>, 10 days ago

Update to LibRaw-0.21.3.
  • Property mode set to 100644
File size: 9.7 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libraw-download-http "https://www.libraw.org/data/LibRaw-&libraw-version;.tar.gz">
8 <!ENTITY libraw-download-ftp " ">
9 <!ENTITY libraw-md5sum "b9d2b96a8e30ed76ff5b0da19f3fbe81">
10 <!ENTITY libraw-size "1.4 MB">
11 <!ENTITY libraw-buildsize "27 MB">
12 <!ENTITY libraw-time "0.1 SBU (Using parallelism=4)">
13 <!ENTITY dcraw-manpage-url "https://linux.die.net/man/1/dcraw">
14]>
15
16<sect1 id="libraw" xreflabel="libraw-&libraw-version;">
17 <?dbhtml filename="libraw.html"?>
18
19
20 <title>libraw-&libraw-version;</title>
21
22 <indexterm zone="libraw">
23 <primary sortas="a-libraw">libraw</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to libraw</title>
28
29 <para>
30 <application>Libraw</application> is a library for reading RAW files
31 obtained from digital cameras (CRW/CR2, NEF, RAF, DNG, and others).
32 </para>
33
34 &lfs122_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&libraw-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&libraw-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &libraw-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &libraw-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &libraw-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &libraw-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70 <bridgehead renderas="sect3">libraw Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Recommended</bridgehead>
73 <para role="recommended">
74 <xref linkend="libjpeg"/>,
75 <xref linkend="jasper"/>, and
76 <xref linkend="lcms2"/>
77 </para>
78<!--
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <ulink url="http://www.libraw.org/download">LibRaw-demosaic-pack-GPL2</ulink> and
82 <ulink url="http://www.libraw.org/download">LibRaw-demosaic-pack-GPL3</ulink>
83 </para>
84-->
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of libraw</title>
89
90 <para>
91 Install <application>libraw</application> by running the following
92 commands:
93 </para>
94
95<screen><userinput>./configure --prefix=/usr \
96 --enable-jpeg \
97 --enable-jasper \
98 --enable-lcms \
99 --disable-static \
100 --docdir=/usr/share/doc/libraw-&libraw-version; &amp;&amp;
101make</userinput></screen>
102
103 <para>
104 This package does not come with a test suite.
105 </para>
106
107 <para>
108 Now, as the <systemitem class="username">root</systemitem> user:
109 </para>
110
111<screen role="root"><userinput>make install</userinput></screen>
112
113 </sect2>
114
115 <sect2 role="commands">
116 <title>Command Explanations</title>
117
118 <para>
119 <parameter>--enable-jpeg</parameter>: This switch enables
120 support for JPEG images. Remove it if you don't have
121 <xref linkend="libjpeg"/> installed.
122 </para>
123
124 <para>
125 <parameter>--enable-jasper</parameter>: This switch enables
126 support for JPEG2000 images. Remove it if you don't have
127 <xref linkend="jasper"/> installed.
128 </para>
129
130 <para>
131 <parameter>--enable-lcms</parameter>: This switch enables
132 support for color management. Remove it if you don't have
133 <xref linkend="lcms2"/> installed.
134 </para>
135
136 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
137 href="../../xincludes/static-libraries.xml"/>
138
139 </sect2>
140
141 <sect2 role="content">
142 <title>Contents</title>
143
144 <note>
145 <para>
146 All of the installed programs are examples of using libraw.
147 </para>
148 </note>
149
150 <segmentedlist>
151 <segtitle>Installed Programs</segtitle>
152 <segtitle>Installed Library</segtitle>
153 <segtitle>Installed Directories</segtitle>
154
155 <seglistitem>
156 <seg>
157 4channels, dcraw_emu, dcraw_half, half_mt, mem_image,
158 multirender_test, postprocessing_benchmark, raw-identify,
159 simple_dcraw, and unprocessed_raw
160 </seg>
161 <seg>
162 libraw.so and libraw_r.so
163 </seg>
164 <seg>
165 /usr/include/libraw and
166 /usr/share/doc/libraw-&libraw-version;
167 </seg>
168 </seglistitem>
169 </segmentedlist>
170
171 <variablelist>
172 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
173 <?dbfo list-presentation="list"?>
174 <?dbhtml list-presentation="table"?>
175
176 <varlistentry id="_4channels">
177 <term><command>4channels</command></term>
178 <listitem>
179 <para>
180 generates four TIFF files from RAW data, with one file per channel
181 </para>
182 <indexterm zone="libraw _4channels">
183 <primary sortas="b-_4channels">4channels</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="dcraw_half">
189 <term><command>dcraw_half</command></term>
190 <listitem>
191 <para>
192 emulates running "dcraw -h" (see
193 <ulink url="&dcraw-manpage-url;"> DCRAW manpage</ulink>)
194 </para>
195 <indexterm zone="libraw dcraw_half">
196 <primary sortas="b-dcraw_half">dcraw_half</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="mem_image">
202 <term><command>mem_image</command></term>
203 <listitem>
204 <para>
205 emulates running "dcraw [-4] [-6] [-e]" (see
206 <ulink url="&dcraw-manpage-url;"> DCRAW manpage</ulink>)
207 </para>
208 <indexterm zone="libraw mem_image">
209 <primary sortas="b-mem_image">mem_image</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="postprocessing_benchmark">
215 <term><command>postprocessing_benchmark</command></term>
216 <listitem>
217 <para>
218 creates eight different renderings from one source file.
219 The first and fourth one should be identical
220 </para>
221 <indexterm zone="libraw postprocessing_benchmark">
222 <primary sortas="b-postprocessing_benchmark">
223 postprocessing_benchmark</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="simple_dcraw">
229 <term><command>simple_dcraw</command></term>
230 <listitem>
231 <para>
232 emulates running "dcraw [-D] [-T] [-v] [-e] [-4]" (see
233 <ulink url="&dcraw-manpage-url;"> DCRAW manpage</ulink>)
234 </para>
235 <indexterm zone="libraw simple_dcraw">
236 <primary sortas="b-simple_dcraw">simple_dcraw</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="dcraw_emu">
242 <term><command>dcraw_emu</command></term>
243 <listitem>
244 <para>
245 is an almost complete dcraw emulator (see
246 <ulink url="&dcraw-manpage-url;"> DCRAW manpage</ulink>)
247 </para>
248 <indexterm zone="libraw dcraw_emu">
249 <primary sortas="b-dcraw_emu">dcraw_emu</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="half_mt">
255 <term><command>half_mt</command></term>
256 <listitem>
257 <para>
258 emulates running "dcraw -h [-w] [-a] [-v]" (see
259 <ulink url="&dcraw-manpage-url;">DCRAW manpage</ulink>)
260 </para>
261 <indexterm zone="libraw half_mt">
262 <primary sortas="b-half_mt">half_mt</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="multirender_test">
268 <term><command>multirender_test</command></term>
269 <listitem>
270 <para>
271 creates eight different renderings from one source file.
272 The first and fourth one should be identical
273 </para>
274 <indexterm zone="libraw multirender_test">
275 <primary sortas="b-multirender_test">multirender_test</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="raw-identify">
281 <term><command>raw-identify</command></term>
282 <listitem>
283 <para>
284 emulates running "dcraw -i [-v]" (see
285 <ulink url="&dcraw-manpage-url;"> DCRAW manpage</ulink>)
286 </para>
287 <indexterm zone="libraw raw-identify">
288 <primary sortas="b-raw-identify">half_mt</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="unprocessed_raw">
294 <term><command>unprocessed_raw</command></term>
295 <listitem>
296 <para>
297 generates an unprocessed raw image (with masked pixels and without
298 black subtraction)
299 </para>
300 <indexterm zone="libraw unprocessed_raw">
301 <primary sortas="b-unprocessed_raw">unprocessed_raw</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="libraw-lib">
307 <term><filename class='libraryfile'>libraw.so</filename></term>
308 <listitem>
309 <para>
310 contains functions used for parsing, editing, and saving
311 RAW image data.
312 </para>
313 <indexterm zone="libraw libraw-lib">
314 <primary sortas="c-libraw">libraw.so</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 </variablelist>
320
321 </sect2>
322
323</sect1>
Note: See TracBrowser for help on using the repository browser.