@u4/opencv-build

@u4/opencv-build

A simple script to auto build recent OpenCV + contrib version via npm. This script is used to auto build opencv4nodejs.

Main changes from the original project

• OpenCV build is explicitly build by ./bin/main.js or it's alias opencv-build-npm and accepting parametes see opencv-build-npm --help
• OpenCV build can now be configured with new OpenCVBuilder({autoBuildOpencvVersion: "3.4.16", autoBuildBuildCuda: true, autoBuildWithoutContrib: false }).install()
• Each OPENCV_VERSION will be build in his own directory.
• Each AUTOBUILD_FLAGS will be build in his own directory. (induce massive time gain during development)
• All build can now be build outside node_modules using OPENCV_BUILD_ROOT environement variable.
• Fix MSBuild.exe localisation for VS 2019
• Script output is now colorized.
• Add some usefull log.
• Big code refactor.
• Enfoce typing.
• Add comments and documentations.

Each OpenCV build will take around 2Gb on your drive, so I recommand you to define the OPENCV_BUILD_ROOT environement variable to avoid duplicate buildsand avoid node_modules auto flushs.

Install

npm install opencv-build

usage

npm-opencv-build usage:
   --version <value>    OpenCV version                           (OPENCV4NODEJS_AUTOBUILD_OPENCV_VERSION env variable)
   --flags <value>      OpenCV cMake Build flags                 (OPENCV4NODEJS_AUTOBUILD_FLAGS env variable)
   --root <value>       OpenCV-build root directory (deprecated) (INIT_CWD env variable)
   --buildRoot <value>  OpenCV build directory                   (OPENCV_BUILD_ROOT env variable)
   --cuda               Enable cuda in OpenCV build              (OPENCV4NODEJS_BUILD_CUDA env variable)
   --nocontrib          Do not compile Contrib modules           (OPENCV4NODEJS_AUTOBUILD_WITHOUT_CONTRIB env variable)
   --nobuild            Do build OpenCV                          (OPENCV4NODEJS_DISABLE_AUTOBUILD env variable)
   --incDir <value>     OpenCV include directory                 (OPENCV_INCLUDE_DIR env variable)
   --libDir <value>     OpenCV library directory                 (OPENCV_LIB_DIR env variable)
   --binDir <value>     OpenCV bin directory                     (OPENCV_BIN_DIR env variable)
   --keepsources        Keepsources OpenCV source after build

Requirements

• cmake

Windows

for nodejs <= 12

npm install --global windows-build-tools

OpenCVBuildEnv options

It's possible to specify build environment variables by passing argument to the builder script

node lib/main.js --version 4.5.4 --buildRoot ~/openCV

with flags, do not forget the quotes "

node lib/main.js --version 4.5.4 --buildRoot ~/openCV --flags "-DOPENCV_GENERATE_PKGCONFIG=ON -DOPENCV_PC_FILE_NAME=opencv.pc"

Using the bin alias

opencv-build-npm --version 4.5.5

Or by inserting them into the package.json where the dependency is declared an object like:

{
  "opencv4nodejs": {
    "autoBuildFlags": "-DOPENCV_GENERATE_PKGCONFIG=ON -DOPENCV_PC_FILE_NAME=opencv.pc",
    "autoBuildOpencvVersion": "4.5.4"
  }
}

By using environement varaibles.

export OPENCV4NODEJS_AUTOBUILD_FLAGS="-DOPENCV_GENERATE_PKGCONFIG=ON -DOPENCV_PC_FILE_NAME=opencv.pc"
export OPENCV4NODEJS_AUTOBUILD_OPENCV_VERSION="4.5.4"
export OPENCV_BUILD_ROOT="~/openCV"

node build/main.js

prebuild

the prebuild is a smart version selector, to avoid futher re-compilation, accepted values are:

• "latestBuild" use the last built version
• "latestVersion" use the highest version number built
• "oldestBuild" use the olderst built version
• "oldestVersion" use the lowest version number built

the prebuild option intend to be use at runtime, so you do not have to keep trak of the version you want to use.

this parameter can only be provide in OpenCVBuildEnv constructor options.

autoBuildOpencvVersion

Choose the openCV version you want to build, default is 3.4.6,

This option value can be provide using:

• The --version in build script
• The autoBuildOpencvVersion options field provided to OpenCVBuildEnv constructor options.
• The autoBuildOpencvVersion field in the current package.json opencv4nodejs object.
• The OPENCV4NODEJS_AUTOBUILD_OPENCV_VERSION environement variable.

buildRoot

The buildRoot is a the directory used to build openCV, Default value is the npm-opencv-build directory. You may want to use this value to persist your files out of your node_modules directory.

This option value can be provide using:

• The --buildRoot in build script
• The buildRoot options field provided to OpenCVBuildEnv constructor options.
• The OPENCV_BUILD_ROOT environement variable.

autoBuildBuildCuda

Set any value to enable, the following cMake flag will be added:

• DWITH_CUDA=ON
• DBUILD_opencv_cudacodec=OFF // video codec (NVCUVID) is deprecated in cuda 10, so don't add it
• DCUDA_FAST_MATH=ON // optional
• DWITH_CUBLAS=ON // optional

This option value can be enable using:

• The --cuda in build script
• The autoBuildBuildCuda options field provided to OpenCVBuildEnv constructor options.
• The autoBuildBuildCuda field in the current package.json opencv4nodejs object.
• The OPENCV4NODEJS_BUILD_CUDA environement variable.

autoBuildFlags

Append option to CMake flags.

This option value can be enable using:

• The --flags in build script
• The autoBuildFlags options field provided to OpenCVBuildEnv constructor options.
• The autoBuildFlags field in the current package.json opencv4nodejs object.
• The OPENCV4NODEJS_AUTOBUILD_FLAGS environement variable.

autoBuildWithoutContrib

Set any value to enable, this option will skip openCV Contribs.

This option value can be enable using:

• The --nocontrib in build script
• The autoBuildWithoutContrib options field provided to OpenCVBuildEnv constructor options.
• The autoBuildWithoutContrib field in the current package.json opencv4nodejs object.
• The OPENCV4NODEJS_AUTOBUILD_WITHOUT_CONTRIB environement variable.

disableAutoBuild

Set any value to disable compilation from sources.

This option value can be enable using:

• The --nobuild in build script
• The disableAutoBuild options field provided to OpenCVBuildEnv constructor options.
• The disableAutoBuild field in the current package.json opencv4nodejs object.
• The OPENCV4NODEJS_DISABLE_AUTOBUILD environement variable.

Can be set using the environment variables OPENCV4NODEJS_DISABLE_AUTOBUILD

opencvIncludeDir

Over write the OPENCV_INCLUDE_DIR environment variables

opencvLibDir

Over write the OPENCV_LIB_DIR environment variables

opencvBinDir

Over write the OPENCV_BIN_DIR environment variables

build test

opencv-build-npm --flags="-DBUILD_LIST=core,imgproc,imgcodecs,videoio,highgui,video,calib3d,features2d,objdetect,dnn,ml,flann,photo,stitching,gapi" --version=3.4.15 --nocontrib

opencv-build-npm --version=4.5.4 --nocontrib