Release v2.21.0.0

.github/workflows/test-install-dependencies.yml

@@ -0,0 +1,64 @@
+ name: OS Support
+
+ on:
+  workflow_dispatch:
+  push:
+    paths:
+      - 'docs/source/_static/install_dependencies.sh'
+      - 'examples/install_requirements.py'
+  pull_request:
+      paths:
+      - 'docs/source/_static/install_dependencies.sh'
+      - 'examples/install_requirements.py'
+
+ jobs:
+   test_linux:
+     runs-on: ubuntu-latest
+     strategy:
+       matrix:
+          container_image: ["fedora:34", "fedora:35", "fedora:36", "ubuntu:18.04", "ubuntu:20.04", "ubuntu:22.04", "ubuntu:22.10"]
+     container:
+       image: ${{ matrix.container_image }}
+     steps:
+       - uses: actions/checkout@v3
+       - name: Install sudo
+         if: startsWith(matrix.container_image, 'fedora') == true
+         run: yum update -y && yum install -y sudo
+       - name: Install sudo
+         if: startsWith(matrix.container_image, 'ubuntu') == true
+         run: apt-get update  -qq && apt-get -qq install sudo
+       - name: Install dependencies
+         run: |
+           ln -snf /usr/share/zoneinfo/UTC /etc/localtime && echo UTC > /etc/timezone # Otherwise tzdata installer prompts for user input
+           sed '/udevadm control --reload-rules && sudo udevadm trigger/d' docs/source/_static/install_dependencies.sh > tmp_script.sh # Doesn't work on docker
+           bash tmp_script.sh
+       - name: Install example requirements
+         run: |
+           python3 examples/install_requirements.py
+   test_macos:
+      strategy:
+        matrix:
+          os: ["macos-11", "macos-12"]
+      runs-on: ${{ matrix.os }}
+      steps:
+       - uses: actions/checkout@v3
+       - name: Install dependencies
+         run: |
+           sed '/udevadm control --reload-rules && sudo udevadm trigger/d' docs/source/_static/install_dependencies.sh > tmp_script.sh
+           bash tmp_script.sh
+       - name: Install example requirements
+         run: |
+           python3 examples/install_requirements.py
+   test_windows:
+      runs-on: windows-latest
+      steps:
+      - uses: actions/checkout@v3
+      - name: Download chocolatey
+        shell: pwsh
+        run: Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
+      - name: Install dependencies
+        shell: pwsh
+        run: choco install cmake git python pycharm-community -y
+      - name: Install example requrirements
+        run: |
+          python examples/install_requirements.py

.gitignore

@@ -38,6 +38,7 @@ wheelhouse/
 .venv
 env/
 venv/
+venv_*/
 ENV/
 env.bak/
 venv.bak/

CMakeLists.txt

@@ -107,6 +107,7 @@ pybind11_add_module(${TARGET_NAME}
     src/pipeline/node/XLinkInBindings.cpp
     src/pipeline/node/XLinkOutBindings.cpp
     src/pipeline/node/ColorCameraBindings.cpp
+    src/pipeline/node/CameraBindings.cpp
     src/pipeline/node/MonoCameraBindings.cpp
     src/pipeline/node/StereoDepthBindings.cpp
     src/pipeline/node/NeuralNetworkBindings.cpp

README.md

@@ -96,8 +96,8 @@ If `TEST_TIMEOUT=0`, the test will run until stopped or it ends.
 
 ## Tested platforms
 
-- Windows 10
-- Ubuntu 16.04, 18.04;
+- Windows 10, Windows 11
+- Ubuntu 18.04, 20.04, 22.04;
 - Raspbian 10;
 - macOS 10.14.6, 10.15.4;
 

docs/source/_static/install_dependencies.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
 
-trap 'RET=$? ; echo -e >&2 "\n\x1b[31mFailed installing dependencies. Could be a bug in the installer or unsupported platform. Open a bug report over at https://github.com/luxonis/depthai - exited with status $RET at line $LINENO \x1b[0m\n" ; exit $RET' ERR
+trap 'RET=$? ; echo -e >&2 "\n\x1b[31mFailed installing dependencies. Could be a bug in the installer or unsupported platform. Open a bug report over at https://github.com/luxonis/depthai - exited with status $RET at line $LINENO \x1b[0m\n" ;
+exit $RET' ERR
 
 readonly linux_pkgs=(
     python3
@@ -50,7 +51,7 @@ readonly ubuntu_pkgs_pre22_04=(
     libdc1394-22-dev
 )
 
-readonly ubuntu_pkgs_22_04=(
+readonly ubuntu_pkgs_post22_04=(
     "${ubuntu_pkgs[@]}"
     libdc1394-dev
 )
@@ -96,26 +97,11 @@ print_and_exec () {
 if [[ $(uname) == "Darwin" ]]; then
     echo "During Homebrew install, certain commands need 'sudo'. Requesting access..."
     sudo true
-    arch_cmd=
-    if [[ $(uname -m) == "arm64" ]]; then
-        arch_cmd="arch -x86_64"
-        echo "Running in native arm64 mode, will prefix commands with: $arch_cmd"
-        # Check if able to run with x86_64 emulation
-        retcode=0
-        $arch_cmd true || retcode=$?
-        if [[ $retcode -ne 0 ]]; then
-            print_action "=== Installing Rosetta 2 - Apple binary translator"
-            # Prompts the user to agree to license: <A> <Enter>
-            # Could be automated by adding: --agree-to-license
-            print_and_exec softwareupdate --install-rosetta
-        fi
-    fi
     homebrew_install_url="https://raw.githubusercontent.com/Homebrew/install/master/install.sh"
     print_action "Installing Homebrew from $homebrew_install_url"
     # CI=1 will skip some interactive prompts
-    CI=1 $arch_cmd /bin/bash -c "$(curl -fsSL $homebrew_install_url)"
-    print_and_exec $arch_cmd brew install python3 git
-    print_and_exec python3 -m pip install -U pip
+    CI=1 /bin/bash -c "$(curl -fsSL $homebrew_install_url)"
+    print_and_exec brew install git
     echo
     echo "=== Installed successfully!  IMPORTANT: For changes to take effect,"
     echo "please close and reopen the terminal window, or run:  exec \$SHELL"
@@ -126,8 +112,8 @@ elif [ -f /etc/os-release ]; then
     if [[ "$ID" == "ubuntu" || "$ID" == "debian" || "$ID_LIKE" == "ubuntu" || "$ID_LIKE" == "debian" || "$ID_LIKE" == "ubuntu debian" ]]; then
         if [[ ! $(uname -m) =~ ^arm* ]]; then
             sudo apt-get update
-            if [[ "$VERSION_ID" == "22.04" ]]; then
-                sudo apt-get install -y "${ubuntu_pkgs_22_04[@]}"
+            if [[ "$VERSION_ID" > "22.04" || "$VERSION_ID" == "22.04" ]]; then
+                sudo apt-get install -y "${ubuntu_pkgs_post22_04[@]}"
             else
                 sudo apt-get install -y "${ubuntu_pkgs_pre22_04[@]}"
             fi
@@ -177,3 +163,5 @@ else
     echo "ERROR: Host not supported"
     exit 99
 fi
+
+echo "Finished installing global libraries."

docs/source/_static/install_depthai.sh

@@ -0,0 +1,234 @@
+#!/bin/bash
+
+APP_NAME="depthai"
+WORKING_DIR_NAME="Luxonis"
+WORKING_DIR="$HOME/$WORKING_DIR_NAME"
+mkdir "$WORKING_DIR"
+install_path=""
+path_correct="false"
+
+trap 'RET=$? ; echo -e >&2 "\n\x1b[31mFailed installing dependencies. Could be a bug in the installer or unsupported platform. Open a bug report over at https://github.com/luxonis/depthai - exited with status $RET at line $LINENO \x1b[0m\n" ; exit $RET' ERR
+
+while [ "$path_correct" = "false" ]
+do
+  echo ""
+  read -p $'ENTER absolute installation path for depthai or leave empty and default path: $HOME will be used.\n' -r install_path
+  echo ""
+
+  if [ "$install_path" = "" ]; then
+    echo "Using default installation path: $WORKING_DIR"
+    mkdir -p "$WORKING_DIR"
+  else
+    echo "Using given installation path: $install_path"
+    WORKING_DIR="$install_path"
+  fi
+
+  if [ -d "$WORKING_DIR" ]; then
+    echo "Directory: $WORKING_DIR is OK"
+    path_correct="true"
+  else
+    echo "Directory: $WORKING_DIR is not valid. Try again!"
+  fi
+done
+
+DEPTHAI_DIR="$WORKING_DIR/$APP_NAME"
+VENV_DIR="$WORKING_DIR/venv"
+ENTRYPOINT_DIR="$DEPTHAI_DIR/entrypoint"
+
+# Get Python version or find out that python 3.10 must be installed
+python_executable=$(which python3)
+python_chosen="false"
+install_python="false"
+python_version=$(python3 --version)
+python_version_number=""
+if [[ "$python_version" != 'Python'* ]]; then
+  python_version=""
+fi
+echo $'\n'
+
+# check default python version, offer it to the user or get another one
+while [ "$python_chosen" = "false" ]
+do
+  if [[ "$python_version" == "" ]]; then
+    echo "No python version found."
+    echo "Input path for python binary, version 3.8 or higher, or leave empty and python 3.10 will be installed for you."
+    read -p $'Press any key to continue\n' -r python_binary_path
+    # python not found and user wants to install python 3.10
+    if [ "$python_binary_path" = "" ]; then
+        install_python="true"
+        python_chosen="true"
+    fi
+  else
+    # E.g Python 3.10 -> nr_1=3, nr_2=10, for Python 3.7.5 -> nr_1=r, nr_2=7
+    nr_1="${python_version:7:1}"
+    nr_2=$(echo "${python_version:9:2}" | tr -d -c 0-9)
+    echo "Python version: $python_version found."
+    if [ "$nr_1" -gt 2 ] && [ "$nr_2" -gt 7 ]; then  # first two digits of python version greater then 3.7 -> python version 3.8 or greater is allowed.
+      echo "If you want to use it for installation, press ANY key, otherwise input path to python binary."
+      read -p $'Press any key to continue\n' -r python_binary_path
+      # user wants to use already installed python whose version is high enough
+      if [ "$python_binary_path" = "" ]; then
+        python_chosen="true"
+    fi
+    else
+      echo "This python version is not supported by depthai. Enter path to python binary version et least 3.8, or leave empty and python 3.10 will be installed automatically."
+      read -p $'Press any key to continue\n' -r python_binary_path
+      # python version is too low and user wants to install python 3.10
+      if [ "$python_binary_path" = "" ]; then
+        install_python="true"
+        python_chosen="true"
+      fi
+    fi
+  fi
+  # User entered some path that should lead to python binary, save python --version output and the rest is dealt in the while loop logic.
+  if [ "$python_binary_path" != "" ]; then
+    python_executable="$python_binary_path"
+    python_version=$($python_binary_path --version)
+    if [[ "$python_version" != 'Python'* ]]; then
+      python_version=""
+    fi
+  fi
+done
+
+
+write_in_file () {
+  # just make sure only strings are appended which are not in there yet
+  # first arg is text to write, second arg is the file path
+  if ! grep -Fxq "$1" "$2"
+  then
+    echo "$1" >> "$2"
+  fi
+}
+
+COMMENT='# Entry point for Depthai demo app, enables to run <depthai_launcher> in terminal'
+BASHRC="$HOME/.bashrc"
+ZSHRC="$HOME/.zshrc"
+ADD_ENTRYPOINT_TO_PATH='export PATH=$PATH'":$ENTRYPOINT_DIR"
+
+# add to .bashrc only if it is not in there already
+write_in_file "$COMMENT" "$BASHRC"
+write_in_file "$ADD_ENTRYPOINT_TO_PATH" "$BASHRC"
+
+if [ -f "$ZSHRC" ]; then
+  write_in_file "$COMMENT" "$ZSHRC"
+  write_in_file "$ADD_ENTRYPOINT_TO_PATH" "$ZSHRC"
+fi
+
+if [[ $(uname -s) == "Darwin" ]]; then
+  echo _____________________________
+  echo "Calling macOS_installer.sh"
+  echo _____________________________
+  echo "Running macOS installer."
+
+  echo "Installing global dependencies."
+  bash -c "$(curl -fL https://docs.luxonis.com/install_dependencies.sh)"
+
+  echo "Upgrading brew."
+  brew update
+
+  # clone depthai form git
+  if [ -d "$DEPTHAI_DIR" ]; then
+     echo "Demo app already downloaded. Checking out main and updating."
+  else
+     echo "Downloading demo app."
+     git clone https://github.com/luxonis/depthai.git "$DEPTHAI_DIR"
+  fi
+  cd "$DEPTHAI_DIR"
+  git fetch
+  git checkout main
+  git pull
+
+  # install python 3.10 and python dependencies
+  brew update
+
+  if [ "$install_python" == "true" ]; then
+    echo "installing python 3.10"
+    brew install python@3.10
+    python_executable=$(which python3.10)
+  fi
+
+  # pip does not have pyqt5 for arm
+  if [[ $(uname -m) == 'arm64' ]]; then
+    echo "Installing pyqt5 with homebrew."
+    brew install pyqt@5
+  fi
+
+  # create python virtual environment
+  echo "Creating python virtual environment in $VENV_DIR"
+  echo "$python_executable"
+  "$python_executable" -m venv "$VENV_DIR"
+  # activate environment
+  source "$VENV_DIR/bin/activate"
+  pip install --upgrade pip
+
+  # install launcher dependencies
+  # only on mac silicon point PYTHONPATH to pyqt5 installation via homebrew, otherwise install pyqt5 with pip
+  if [[ $(uname -m) == 'arm64' ]]; then
+    if [[ ":$PYTHONPATH:" == *":/opt/homebrew/lib/python3.10/site-packages:"* ]]; then
+      echo "/opt/homebrew/lib/python$nr_1.$nr_2/site-packages already in PYTHONPATH"
+    else
+      export "PYTHONPATH=/opt/homebrew/lib/python$nr_1.$nr_2/site-packages:"$PYTHONPATH
+      echo "/opt/homebrew/lib/pythonv$nr_1.$nr_2/site-packages added to PYTHONPATH"
+    fi
+  else
+    pip install pyqt5
+  fi
+
+  pip install packaging
+
+elif [[ $(uname -s) == "Linux" ]]; then
+  echo _____________________________
+  echo "Calling linux_installer.sh"
+  echo _____________________________
+
+  echo "Updating sudo-apt."
+  sudo apt-get update
+
+  echo "Installing global dependencies."
+  sudo wget -qO- https://docs.luxonis.com/install_dependencies.sh | bash
+
+  echo -e '\nRunning Linux installer.'
+
+  # clone depthai form git
+  if [ -d "$DEPTHAI_DIR" ]; then
+     echo "Demo app already downloaded. Checking out main and updating."
+
+  else
+     echo "Downloading demo app."
+     git clone https://github.com/luxonis/depthai.git "$DEPTHAI_DIR"
+  fi
+
+  cd "$DEPTHAI_DIR"
+  git fetch
+  git checkout main
+  git pull
+
+  # install python 3.10
+  if [ "$install_python" == "true" ]; then
+    echo "installing python 3.10"
+
+    sudo yes "" | sudo add-apt-repository ppa:deadsnakes/ppa
+    sudo apt -y install python3.10
+    sudo apt -y install python3.10-venv
+    python_executable=$(which python3.10)
+  fi
+
+  echo "Creating python virtual environment in $VENV_DIR"
+
+  "$python_executable" -m venv "$VENV_DIR"
+
+  source "$VENV_DIR/bin/activate"
+  pip install --upgrade pip
+
+  pip install packaging
+  pip install pyqt5
+else
+  echo "Error: Host $(uname -s) not supported."
+  exit 99
+fi
+
+echo -e '\n\n:::::::::::::::: INSTALATION COMPLETE ::::::::::::::::\n'
+echo -e '\nTo run demo app write <depthai_launcher> in terminal.'
+read -rsp $'Press ANY KEY to finish and run the demo app...\n' -n1 key
+echo "STARTING DEMO APP."
+python "$DEPTHAI_DIR/launcher/launcher.py" -r "$DEPTHAI_DIR"