source: general/graphlib/opencv.xml@ 02c77612

trunk
Last change on this file since 02c77612 was 2fec8e3, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Tag the rest of Chapter 10 *Graphics Libraries)
  • Property mode set to 100644
File size: 7.8 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 opencv-download-http "https://github.com/opencv/opencv/archive/&opencv-version;/opencv-&opencv-version;.tar.gz">
8 <!ENTITY opencv-download-ftp " ">
9 <!ENTITY opencv-md5sum "153b4b8dd103b1bfe447f7dd1f22eac0">
10 <!ENTITY opencv-size "88 MB">
11 <!ENTITY opencv-buildsize "820 MB">
12 <!ENTITY opencv-time "7.4 SBU (using parallelism=4)">
13
14 <!ENTITY opencv-contrib-download "https://github.com/opencv/opencv_contrib/archive/&opencv-version;/opencv_contrib-&opencv-contrib-version;.tar.gz">
15]>
16
17<sect1 id="opencv" xreflabel="opencv-&opencv-version;">
18 <?dbhtml filename="opencv.html"?>
19
20
21 <title>opencv-&opencv-version;</title>
22
23 <indexterm zone="opencv">
24 <primary sortas="a-opencv">opencv</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to opencv</title>
29
30 <para>
31 The <application>opencv</application> package contains graphics libraries
32 mainly aimed at real-time computer vision.
33 </para>
34
35 &lfs121_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>
41 Download (HTTP): <ulink url="&opencv-download-http;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download (FTP): <ulink url="&opencv-download-ftp;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download MD5 sum: &opencv-md5sum;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download size: &opencv-size;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &opencv-buildsize;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated build time: &opencv-time;
67 </para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>
75 Optional additional modules: <ulink
76 url="&opencv-contrib-download;"/>
77 </para>
78 </listitem>
79 </itemizedlist>
80
81 <note>
82 <para>
83 One additional file that starts with "ippicv" (integrated
84 performance primitives) will be automatically downloaded during the
85 cmake portion of the build procedure. This download is specific to the
86 system architecture.
87 </para>
88 </note>
89
90 <bridgehead renderas="sect3">opencv Dependencies</bridgehead>
91
92 <bridgehead renderas="sect4">Required</bridgehead>
93 <para role="required">
94 <xref linkend="cmake"/> and
95 <xref linkend="unzip"/>
96 </para>
97
98 <bridgehead renderas="sect4">Recommended</bridgehead>
99 <para role="recommended">
100 <xref linkend="ffmpeg"/>,
101 <xref linkend="gst10-plugins-base"/>,
102 <xref linkend="gtk3"/>,
103 <xref linkend="jasper"/>,
104 <xref linkend="libexif"/>,
105 <xref linkend="libjpeg"/>,
106 <xref linkend="libpng"/>,
107 <xref linkend="libtiff"/>,
108 <xref linkend="libwebp"/>,
109 <xref linkend="openjpeg2"/>,
110 <xref linkend="v4l-utils"/>, and
111 <xref linkend="xine-lib"/>
112 </para>
113
114 <bridgehead renderas="sect4">Optional</bridgehead>
115 <para role="optional">
116 <xref linkend="apache-ant"/>,
117 <xref linkend="doxygen"/>,
118 <xref linkend="java"/>,
119 <xref linkend="numpy"/>,
120 <ulink url="https://math-atlas.sourceforge.net/">ATLAS</ulink>,
121 <ulink url="https://www.netlib.org/blas/">blas</ulink>,
122 <ulink url="https://developer.nvidia.com/cuda-zone">Cuda</ulink>,
123 <ulink url="https://eigen.tuxfamily.org/">Eigen</ulink>,
124 <ulink url="https://www.openexr.com/">OpenEXR</ulink>,
125 <ulink url="https://www.gdal.org/">GDAL</ulink>,
126 <ulink url="https://www.netlib.org/lapack/">lapack</ulink>,
127 <ulink url="https://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
128<!-- <ulink url="https://www.numpy.org/">NumPy</ulink>, -->
129 <ulink url="https://github.com/oneapi-src/oneTBB">Threading Building Blocks (TBB)</ulink>, and
130 <ulink url="https://vtk.org/">VTK - The Visualization Toolkit</ulink>,
131 </para>
132
133 </sect2>
134
135 <sect2 role="installation">
136 <title>Installation of opencv</title>
137
138 <para>
139 If you downloaded the optional modules, unpack them now:
140 </para>
141
142<screen><userinput>tar -xf ../opencv_contrib-&opencv-contrib-version;.tar.gz</userinput></screen>
143
144 <para>
145 Install <application>opencv</application> by running the following
146 commands:
147 </para>
148
149<screen><userinput>mkdir build &amp;&amp;
150cd build &amp;&amp;
151
152cmake -DCMAKE_INSTALL_PREFIX=/usr \
153 -DCMAKE_BUILD_TYPE=Release \
154 -DENABLE_CXX11=ON \
155 -DBUILD_PERF_TESTS=OFF \
156 -DWITH_XINE=ON \
157 -DBUILD_TESTS=OFF \
158 -DENABLE_PRECOMPILED_HEADERS=OFF \
159 -DCMAKE_SKIP_RPATH=ON \
160 -DBUILD_WITH_DEBUG_INFO=OFF \
161 -Wno-dev .. &amp;&amp;
162make</userinput></screen>
163
164 <para>
165 The package does not come with a test suite.
166 </para>
167
168 <para>
169 Now, as the <systemitem class="username">root</systemitem> user:
170 </para>
171
172<screen role="root"><userinput>make install</userinput></screen>
173
174 </sect2>
175
176 <sect2 role="commands">
177 <title>Command Explanations</title>
178
179 <para>
180 <parameter>-DWITH_XINE=ON</parameter>: This option instructs the make
181 procedure to use <xref linkend="xine-lib"/>.
182 </para>
183
184 <para>
185 <parameter>-DENABLE_PRECOMPILED_HEADERS=OFF</parameter>: This option
186 is needed for compatibility with gcc-6.1 and later.
187 </para>
188
189 <para>
190 <option>-DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib-&opencv-version;/modules</option>:
191 instructs the build system to build additional modules.
192 </para>
193
194 </sect2>
195
196 <sect2 role="content">
197 <title>Contents</title>
198
199 <segmentedlist>
200 <segtitle>Installed Programs</segtitle>
201 <segtitle>Installed Libraries</segtitle>
202 <segtitle>Installed Directories</segtitle>
203
204 <seglistitem>
205 <seg>
206 opencv_annotation,
207 opencv_interactive-calibration,
208 opencv_model_diagnostics,
209 opencv_version,
210 opencv_visualisation, and
211 setup_vars_opencv4.sh
212 </seg>
213 <seg>
214 libopencv_calib3d.so,
215 libopencv_core.so,
216 libopencv_dnn.so,
217 libopencv_features2d.so,
218 libopencv_flann.so,
219 libopencv_gapi.so,
220 libopencv_highgui.so,
221 libopencv_imgcodecs.so,
222 libopencv_imgproc.so,
223 libopencv_ml.so,
224 libopencv_objdetect.so,
225 libopencv_photo.so,
226 libopencv_stitching.so,
227 libopencv_video.so, and
228 libopencv_videoio.so
229 </seg>
230 <seg>
231 /usr/include/opencv4,
232 /usr/lib/cmake/opencv4,
233 /usr/lib/python&python3-majorver;/site-packages/cv2,
234 /usr/share/licenses/opencv4,
235 /usr/share/opencv4, and
236 /usr/share/java/opencv4
237 </seg>
238 </seglistitem>
239 </segmentedlist>
240<!--
241 <variablelist>
242 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
243 <?dbfo list-presentation="list"?>
244 <?dbhtml list-presentation="table"?>
245
246 <varlistentry id="opencv_annotation">
247 <term><command>opencv_annotation</command></term>
248 <listitem>
249 <para>
250 ???
251 </para>
252 <indexterm zone="opencv opencv_annotation">
253 <primary sortas="b-opencv">opencv_annotation</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 </variablelist>
259-->
260 </sect2>
261
262</sect1>
Note: See TracBrowser for help on using the repository browser.