2014-11-27 20:39:05 +08:00
|
|
|
Installation in Linux {#tutorial_linux_install}
|
|
|
|
=====================
|
|
|
|
|
2017-03-02 02:44:34 +08:00
|
|
|
The following steps have been tested for Ubuntu 10.04 but should work with other distros as well.
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
Required Packages
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
- GCC 4.4.x or later
|
|
|
|
- CMake 2.8.7 or higher
|
|
|
|
- Git
|
|
|
|
- GTK+2.x or higher, including headers (libgtk2.0-dev)
|
|
|
|
- pkg-config
|
|
|
|
- Python 2.6 or later and Numpy 1.5 or later with developer packages (python-dev, python-numpy)
|
|
|
|
- ffmpeg or libav development packages: libavcodec-dev, libavformat-dev, libswscale-dev
|
|
|
|
- [optional] libtbb2 libtbb-dev
|
|
|
|
- [optional] libdc1394 2.x
|
|
|
|
- [optional] libjpeg-dev, libpng-dev, libtiff-dev, libjasper-dev, libdc1394-22-dev
|
2016-07-22 06:04:37 +08:00
|
|
|
- [optional] CUDA Toolkit 6.5 or higher
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
The packages can be installed using a terminal and the following commands or by using Synaptic
|
|
|
|
Manager:
|
|
|
|
@code{.bash}
|
|
|
|
[compiler] sudo apt-get install build-essential
|
|
|
|
[required] sudo apt-get install cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
|
|
|
|
[optional] sudo apt-get install python-dev python-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libjasper-dev libdc1394-22-dev
|
|
|
|
@endcode
|
|
|
|
Getting OpenCV Source Code
|
|
|
|
--------------------------
|
|
|
|
|
|
|
|
You can use the latest stable OpenCV version or you can grab the latest snapshot from our [Git
|
2016-06-14 21:01:36 +08:00
|
|
|
repository](https://github.com/opencv/opencv.git).
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
### Getting the Latest Stable OpenCV Version
|
|
|
|
|
2017-05-22 17:37:58 +08:00
|
|
|
- Go to our [downloads page](http://opencv.org/releases.html).
|
2014-11-27 20:39:05 +08:00
|
|
|
- Download the source archive and unpack it.
|
|
|
|
|
|
|
|
### Getting the Cutting-edge OpenCV from the Git Repository
|
|
|
|
|
2016-06-14 21:01:36 +08:00
|
|
|
Launch Git client and clone [OpenCV repository](http://github.com/opencv/opencv). If you need
|
2017-03-02 02:44:34 +08:00
|
|
|
modules from [OpenCV contrib repository](http://github.com/opencv/opencv_contrib) then clone it as well.
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
|
|
|
cd ~/<my_working_directory>
|
2016-06-14 21:01:36 +08:00
|
|
|
git clone https://github.com/opencv/opencv.git
|
|
|
|
git clone https://github.com/opencv/opencv_contrib.git
|
2014-11-27 20:39:05 +08:00
|
|
|
@endcode
|
|
|
|
Building OpenCV from Source Using CMake
|
|
|
|
---------------------------------------
|
|
|
|
|
2014-11-28 21:21:28 +08:00
|
|
|
-# Create a temporary directory, which we denote as \<cmake_build_dir\>, where you want to put
|
2014-11-27 20:39:05 +08:00
|
|
|
the generated Makefiles, project files as well the object files and output binaries and enter
|
|
|
|
there.
|
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
|
|
|
cd ~/opencv
|
|
|
|
mkdir build
|
|
|
|
cd build
|
|
|
|
@endcode
|
2014-11-28 21:21:28 +08:00
|
|
|
-# Configuring. Run cmake [\<some optional parameters\>] \<path to the OpenCV source directory\>
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
|
|
|
cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local ..
|
|
|
|
@endcode
|
|
|
|
or cmake-gui
|
|
|
|
|
|
|
|
- set full path to OpenCV source code, e.g. /home/user/opencv
|
|
|
|
- set full path to \<cmake_build_dir\>, e.g. /home/user/opencv/build
|
|
|
|
- set optional parameters
|
|
|
|
- run: “Configure”
|
|
|
|
- run: “Generate”
|
|
|
|
|
2016-12-07 04:42:52 +08:00
|
|
|
@note
|
|
|
|
Use `cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local ..` , without spaces after -D if the above example doesn't work.
|
|
|
|
|
2014-11-28 21:21:28 +08:00
|
|
|
-# Description of some parameters
|
|
|
|
- build type: `CMAKE_BUILD_TYPE=Release\Debug`
|
2014-11-27 20:39:05 +08:00
|
|
|
- to build with modules from opencv_contrib set OPENCV_EXTRA_MODULES_PATH to \<path to
|
|
|
|
opencv_contrib/modules/\>
|
|
|
|
- set BUILD_DOCS for building documents
|
|
|
|
- set BUILD_EXAMPLES to build all examples
|
|
|
|
|
2014-11-28 21:21:28 +08:00
|
|
|
-# [optional] Building python. Set the following python parameters:
|
2014-11-27 20:39:05 +08:00
|
|
|
- PYTHON2(3)_EXECUTABLE = \<path to python\>
|
|
|
|
- PYTHON_INCLUDE_DIR = /usr/include/python\<version\>
|
|
|
|
- PYTHON_INCLUDE_DIR2 = /usr/include/x86_64-linux-gnu/python\<version\>
|
|
|
|
- PYTHON_LIBRARY = /usr/lib/x86_64-linux-gnu/libpython\<version\>.so
|
|
|
|
- PYTHON2(3)_NUMPY_INCLUDE_DIRS =
|
|
|
|
/usr/lib/python\<version\>/dist-packages/numpy/core/include/
|
|
|
|
|
2014-11-28 21:21:28 +08:00
|
|
|
-# [optional] Building java.
|
2014-11-27 20:39:05 +08:00
|
|
|
- Unset parameter: BUILD_SHARED_LIBS
|
|
|
|
- It is useful also to unset BUILD_EXAMPLES, BUILD_TESTS, BUILD_PERF_TESTS - as they all
|
|
|
|
will be statically linked with OpenCV and can take a lot of memory.
|
|
|
|
|
2017-03-02 02:44:34 +08:00
|
|
|
-# Build. From build directory execute *make*, it is recommended to do this in several threads
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
|
|
|
make -j7 # runs 7 jobs in parallel
|
|
|
|
@endcode
|
2014-11-28 21:21:28 +08:00
|
|
|
-# [optional] Building documents. Enter \<cmake_build_dir/doc/\> and run make with target
|
2014-11-27 20:39:05 +08:00
|
|
|
"html_docs"
|
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
|
|
|
cd ~/opencv/build/doc/
|
|
|
|
make -j7 html_docs
|
|
|
|
@endcode
|
2017-03-02 02:44:34 +08:00
|
|
|
-# To install libraries, execute the following command from build directory
|
2014-11-27 20:39:05 +08:00
|
|
|
@code{.bash}
|
|
|
|
sudo make install
|
|
|
|
@endcode
|
2014-11-28 21:21:28 +08:00
|
|
|
-# [optional] Running tests
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
- Get the required test data from [OpenCV extra
|
2016-06-14 21:01:36 +08:00
|
|
|
repository](https://github.com/opencv/opencv_extra).
|
2014-11-27 20:39:05 +08:00
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
2016-06-14 21:01:36 +08:00
|
|
|
git clone https://github.com/opencv/opencv_extra.git
|
2014-11-27 20:39:05 +08:00
|
|
|
@endcode
|
|
|
|
- set OPENCV_TEST_DATA_PATH environment variable to \<path to opencv_extra/testdata\>.
|
|
|
|
- execute tests from build directory.
|
|
|
|
|
|
|
|
For example
|
|
|
|
@code{.bash}
|
|
|
|
<cmake_build_dir>/bin/opencv_test_core
|
|
|
|
@endcode
|
2014-11-28 00:54:13 +08:00
|
|
|
|
2014-11-27 20:39:05 +08:00
|
|
|
@note
|
|
|
|
If the size of the created library is a critical issue (like in case of an Android build) you
|
2017-03-02 02:44:34 +08:00
|
|
|
can use the install/strip command to get the smallest size possible. The *stripped* version
|
2014-11-27 20:39:05 +08:00
|
|
|
appears to be twice as small. However, we do not recommend using this unless those extra
|
|
|
|
megabytes do really matter.
|