The packages can be installed using a terminal and the following commands or by using Synaptic Manager:
@ -29,57 +29,122 @@ The packages can be installed using a terminal and the following commands or by
Getting OpenCV Source Code
==========================
You can use the latest stable OpenCV version available in *sourceforge*or you can grab the latest snapshot from our `Git repository <https://github.com/Itseez/opencv.git>`_.
You can use the latest stable OpenCV version or you can grab the latest snapshot from our `Git repository <https://github.com/Itseez/opencv.git>`_.
Getting the Latest Stable OpenCV Version
----------------------------------------
* Go to our `page on Sourceforge <http://sourceforge.net/projects/opencvlibrary>`_;
* Download the source tarball and unpack it.
* Go to our `downloads page <http://opencv.org/downloads.html>`_.
* Download the source archive and unpack it.
Getting the Cutting-edge OpenCV from the Git Repository
#. Create a temporary directory, which we denote as <cmake_binary_dir>, where you want to put the generated Makefiles, project files as well the object files and output binaries.
#. Create a temporary directory, which we denote as <cmake_build_dir>, where you want to put the generated Makefiles, project files as well the object files and output binaries and enter there.
#. Enter the <cmake_binary_dir> and type
For example
..code-block:: bash
cd ~/opencv
mkdir build
cd build
#. Configuring. Run
cmake [<some optional parameters>] <path to the OpenCV source directory>
* 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.
#. Build. From build directory execute make, recomend to do it in several threads
For example
..code-block:: bash
make -j7 # runs 7 jobs in parallel
#. Enter the created temporary directory (<cmake_binary_dir>) and proceed with:
#. [optional] Building documents. Enter <cmake_build_dir/doc/> and run make with target "html_docs"
For example
..code-block:: bash
cd ~/opencv/build/doc/
make -j7 html_docs
#. To install libraries, from build directory execute
..code-block:: bash
make -j8 # -j8 runs 8 jobs in parallel.
# Change 8 to number of hardware threads available.
sudo make install
#. [optional] Running tests
* Get the required test data from `OpenCV extra repository <https://github.com/Itseez/opencv_extra>`_.
* set OPENCV_TEST_DATA_PATH environment variable to <path to opencv_extra/testdata>.
* execute tests from build directory.
For example
..code-block:: bash
<cmake_build_dir>/bin/opencv_test_core
..note::
If the size of the created library is a critical issue (like in case of an Android build) you can use the ``install/strip`` command to get the smallest size as possible. The *stripped* version appears to be twice as small. However, we do not recommend using this unless those extra megabytes do really matter.
Vadim Pisarevsky
10 years ago