README.md

Setup OpenCV

This action downloads, compiles and installs OpenCV. You can choose the version to be installed, as well as how the build/install should occour. If you just want OpenCV installed and ready for use in your Github Actions, this is for you.

Check out the .github/workflows/basic.yml file to see this action working.

NOTICE: this action was created to support CI testings of cvui, a GUI library for OpenCV.

Inputs

Name	Description	Default value
opencv-verion	OpenCV version to be installed.	-
opencv-extra-modules	If opencv-contrib (extra modules) should be included in the instalation.	true
install-deps	If dependencies should be installed as well, e.g. libs, cmake, etc.	true
CMAKE_BUILD_TYPE		RELEASE
CMAKE_CXX_STANDARD		11
CMAKE_CXX_COMPILER		g++
CMAKE_INSTALL_PREFIX		Linux, MacOS : /usr/local Windows : C:/opencv
WITH_TBB		ON
WITH_IPP		ON
BUILD_NEW_PYTHON_SUPPORT		OFF
WITH_V4L		OFF
ENABLE_PRECOMPILED_HEADERS		ON
INSTALL_C_EXAMPLES		OFF
INSTALL_PYTHON_EXAMPLES		OFF
BUILD_EXAMPLES		OFF
WITH_QT		OFF
WITH_OPENGL		OFF
GENERATE_PKGCONFIG		OFF

Usage

See action.yml

Basic:

steps:
- uses: actions/checkout@v2
- uses: Dovyski/[email protected]
  with:
    opencv-version: '4.0.0'

Custom build and install:

steps:
- uses: actions/checkout@v2
- uses: Dovyski/[email protected]
  with:
    opencv-version: 4.0.0
    ENABLE_PRECOMPILED_HEADERS: OFF
    INSTALL_C_EXAMPLES: ON
    BUILD_EXAMPLES: ON

Install development version (master branch, not released yet):

steps:
- uses: actions/checkout@v2
- uses: Dovyski/[email protected]
  with:
    opencv-version: master

Matrix testing:

jobs:
  build:
    runs-on: ubuntu-18.04
    strategy:
      matrix:
        opencv: [ '3.4.0', '4.0.0', '4.1.0' ]
    name: OpenCV ${{ matrix.opencv }}
    steps:
      - uses: actions/checkout@v2
      - name: Setup opencv
        uses: Dovyski/[email protected]
        with:
          opencv-version: ${{ matrix.opencv }}