diff --git a/README.md b/README.md index 8d3ecda041..b6991b9b22 100644 --- a/README.md +++ b/README.md @@ -15,25 +15,26 @@ provides production-quality support for this module. You can build OpenCV, so it will include the modules from this repository. Contrib modules are under constant development and it is recommended to use them alongside the master branch or latest releases of OpenCV. -Here is the CMake command for you: + >***Here is the CMake command line for you:*** -``` -$ cd -$ cmake -DOPENCV_EXTRA_MODULES_PATH=/modules -$ make -j5 +```bash +cd +cmake -D OPENCV_EXTRA_MODULES_PATH=/modules +make -j5 ``` As the result, OpenCV will be built in the `` with all modules from `opencv_contrib` repository. If you don't want all of the modules, -use CMake's `BUILD_opencv_*` options. Like in this example: +use CMake's `BUILD_opencv_*` option where * is the given name of a module as in this example: -``` -$ cmake -DOPENCV_EXTRA_MODULES_PATH=/modules -DBUILD_opencv_legacy=OFF +```bash +cmake -D OPENCV_EXTRA_MODULES_PATH=/modules -D BUILD_opencv_=OFF ``` -If you also want to build the samples from the "samples" folder of each module, also include the "-DBUILD_EXAMPLES=ON" option. +If you also want to build the samples from the "samples" folder of each module, also include the `-D BUILD_EXAMPLES=ON` option. + -If you prefer using the GUI version of CMake (cmake-gui), then, you can add `opencv_contrib` modules within `opencv` core by doing the following: + >***If you prefer using the GUI version of CMake (cmake-gui), then, you can add `opencv_contrib` modules within `opencv` core by doing the following:*** 1. Start cmake-gui. @@ -50,6 +51,8 @@ If you prefer using the GUI version of CMake (cmake-gui), then, you can add `ope 7. Build the `opencv` core with the method you chose (make and make install if you chose Unix makefile at step 6). 8. To run, linker flags to contrib modules will need to be added to use them in your code/IDE. For example to use the aruco module, "-lopencv_aruco" flag will be added. + +------ ### Update the repository documentation diff --git a/modules/README.md b/modules/README.md index 413523f7d0..c6dcebb867 100644 --- a/modules/README.md +++ b/modules/README.md @@ -4,43 +4,43 @@ An overview of the opencv_contrib modules This list gives an overview of all modules available inside the contrib repository. To turn off building one of these module repositories, set the names in bold below to -``` -$ cmake -D OPENCV_EXTRA_MODULES_PATH=/modules -D BUILD_opencv_=OFF +```bash +cmake -D OPENCV_EXTRA_MODULES_PATH=/modules -D BUILD_opencv_=OFF ``` -- **alphamat**: Computer Vision based Alpha Matting -- Given an input image and a trimap, generate an alpha matte. +- **alphamat**: Computer Vision based Alpha Matting — Given an input image and a trimap, generate an alpha matte. -- **aruco**: ArUco and ChArUco Markers -- Augmented reality ArUco marker and "ChARUco" markers where ArUco markers embedded inside the white areas of the checker board. +- **aruco**: ArUco and ChArUco Markers — Augmented reality ArUco marker and "ChARUco" markers where ArUco markers embedded inside the white areas of the checker board. - **bgsegm**: Background segmentation algorithm combining statistical background image estimation and per-pixel Bayesian segmentation. -- **bioinspired**: Biological Vision -- Biologically inspired vision model: minimize noise and luminance variance, transient event segmentation, high dynamic range tone mapping methods. +- **bioinspired**: Biological Vision — Biologically inspired vision model: minimize noise and luminance variance, transient event segmentation, high dynamic range tone mapping methods. -- **ccalib**: Custom Calibration -- Patterns for 3D reconstruction, omnidirectional camera calibration, random pattern calibration and multi-camera calibration. +- **ccalib**: Custom Calibration — Patterns for 3D reconstruction, omnidirectional camera calibration, random pattern calibration and multi-camera calibration. -- **cnn_3dobj**: Deep Object Recognition and Pose -- Uses Caffe Deep Neural Net library to build, train and test a CNN model of visual object recognition and pose. +- **cnn_3dobj**: Deep Object Recognition and Pose — Uses Caffe Deep Neural Net library to build, train and test a CNN model of visual object recognition and pose. -- **cvv**: Computer Vision Debugger -- Simple code that you can add to your program that pops up a GUI allowing you to interactively and visually debug computer vision programs. +- **cvv**: Computer Vision Debugger — Simple code that you can add to your program that pops up a GUI allowing you to interactively and visually debug computer vision programs. -- **datasets**: Datasets Reader -- Code for reading existing computer vision databases and samples of using the readers to train, test and run using that dataset's data. +- **datasets**: Datasets Reader — Code for reading existing computer vision databases and samples of using the readers to train, test and run using that dataset's data. -- **dnn_objdetect**: Object Detection using CNNs -- Implements compact CNN Model for object detection. Trained using Caffe but uses opencv_dnn module. +- **dnn_objdetect**: Object Detection using CNNs — Implements compact CNN Model for object detection. Trained using Caffe but uses opencv_dnn module. -- **dnn_superres**: Superresolution using CNNs -- Contains four trained convolutional neural networks to upscale images. +- **dnn_superres**: Superresolution using CNNs — Contains four trained convolutional neural networks to upscale images. -- **dnns_easily_fooled**: Subvert DNNs -- This code can use the activations in a network to fool the networks into recognizing something else. +- **dnns_easily_fooled**: Subvert DNNs — This code can use the activations in a network to fool the networks into recognizing something else. -- **dpm**: Deformable Part Model -- Felzenszwalb's Cascade with deformable parts object recognition code. +- **dpm**: Deformable Part Model — Felzenszwalb's Cascade with deformable parts object recognition code. -- **face**: Face Recognition -- Face recognition techniques: Eigen, Fisher and Local Binary Pattern Histograms LBPH methods. +- **face**: Face Recognition — Face recognition techniques: Eigen, Fisher and Local Binary Pattern Histograms LBPH methods. - **freetype**: Drawing text using freetype and harfbuzz. -- **fuzzy**: Fuzzy Logic in Vision -- Fuzzy logic image transform and inverse; Fuzzy image processing. +- **fuzzy**: Fuzzy Logic in Vision — Fuzzy logic image transform and inverse; Fuzzy image processing. -- **hdf**: Hierarchical Data Storage -- This module contains I/O routines for Hierarchical Data Format: https://en.m.wikipedia.org/wiki/Hierarchical_Data_Format meant to store large amounts of data. +- **hdf**: Hierarchical Data Storage — This module contains I/O routines for [Hierarchical Data Format](https://en.m.wikipedia.org/wiki/Hierarchical_Data_Format) meant to store large amounts of data. -- **hfs**: Hierarchical Feature Selection for Efficient Image Segmentation -- This module contains an efficient algorithm to segment an image. +- **hfs**: Hierarchical Feature Selection for Efficient Image Segmentation — This module contains an efficient algorithm to segment an image. - **img_hash**: This module contains algorithms to extract hash of an image allowing to efficiently estimate similarity between images. @@ -48,29 +48,29 @@ $ cmake -D OPENCV_EXTRA_MODULES_PATH=/modules -D BUILD_opencv_/modules -D BUILD_opencv_/modules -D BUILD_opencv_