Merge pull request #215 from luxonis/develop

Release 2.2.0.0

Author: SzabolcsGergely

.gitignore

@@ -25,9 +25,10 @@ _builds/
 
 #git
 *.orig
+*_REMOTE_*
+*_LOCAL_*
+*_BACKUP_*
+*_BASE_*
 
 #ci
 wheelhouse/
-
-# Example blobs/files
-examples/models/

README.md

@@ -33,6 +33,7 @@ See: [depthai-core dependencies](https://github.com/luxonis/depthai-core#depende
 
 To build a shared library from source perform the following:
 ```
+git submodule update --init --recursive
 mkdir build && cd build
 cmake .. [-D PYTHON_EXECUTABLE=/full/path/to/python]
 cmake --build . --parallel
@@ -54,6 +55,7 @@ python3 -m pip install .
 
 To run the tests build the library with the following options
 ```
+git submodule update --init --recursive
 mkdir build_tests && cd build_tests
 cmake .. -D DEPTHAI_PYTHON_ENABLE_TESTS=ON -D DEPTHAI_PYTHON_ENABLE_EXAMPLES=ON -D DEPTHAI_PYTHON_TEST_EXAMPLES=ON
 cmake --build . --parallel
@@ -68,7 +70,6 @@ ctest
 - Raspbian 10;
 - macOS 10.14.6, 10.15.4;
 
-
 ### Building documentation
 
 - **Using [Docker](https://docs.docker.com/) (with [Docker Compose](https://docs.docker.com/compose/install/))**
@@ -78,36 +79,35 @@ ctest
      sudo docker-compose build
      sudo docker-compose up
      ```
-     
-     > ℹ️ You can leave out the `sudo` if you have added your user to the `docker` group (or are using rootless docker).
 
+     > ℹ️ You can leave out the `sudo` if you have added your user to the `docker` group (or are using rootless docker).
      Then open [http://localhost:8000](http://localhost:8000).
-     
+
      This docker container will watch changes in the `docs/source` directory and rebuild the docs automatically
 
 - **Linux**
-     
+
      First, please install the required [dependencies](#Dependencies)
-  
+
      Then run the following commands to build the docs website
-  
+
      ```
      python3 -m pip install -U pip
      python3 -m pip install -r docs/requirements.txt
      cmake -S . -B build -D DEPTHAI_BUILD_DOCS=ON -D DEPTHAI_PYTHON_BUILD_DOCS=ON
      cmake --build build --parallel --target sphinx
      python3 -m http.server --bind 0.0.0.0 8000 --directory build/docs/sphinx
      ```
-  
+
      Then open [http://localhost:8000](http://localhost:8000).
 
      This will build documentation based on current sources, so if some new changes will be made, run this command
      in a new terminal window to update the website source
-  
+
      ```
      cmake --build build --parallel --target sphinx
      ```
-  
+
      Then refresh your page - it should load the updated website that was just built
 
 ## Troubleshooting
@@ -121,7 +121,7 @@ Build failure on Ubuntu 18.04 ("relocation ..." link error) with gcc 7.4.0 (defa
          sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 70
          sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-8 70
 ### Hunter
-Hunter is a CMake-only dependency manager for C/C++ projects. 
+Hunter is a CMake-only dependency manager for C/C++ projects.
 
 If you are stuck with error message which mentions external libraries (subdirectory of `.hunter`) like the following:
 ```
@@ -145,7 +145,7 @@ del C:/[user]/.hunter
 
 ### LTO - link time optimization
 
-If following message appears: 
+If following message appears:
 ```
 lto1: internal compiler error: in add_symbol_to_partition_1, at lto/lto-partition.c:152
 Please submit a full bug report,

depthai-core

@@ -85,7 +85,9 @@ Now, pick a tutorial or code sample and start utilizing Gen2 capabilities
    samples/11_rgb_encoding_mono_mobilenet.rst
    samples/12_rgb_encoding_mono_mobilenet_depth.rst
    samples/13_encoding_max_limit.rst
-   samples/14_color_camera_control.rst
+   samples/14_1_color_camera_control.rst
+   samples/14_2_mono_camera_control.rst
+   samples/14_3_depth_crop_control.rst
    samples/15_rgb_mobilenet_4k.rst
    samples/16_device_queue_event.rst
    samples/17_video_mobilenet.rst
@@ -102,6 +104,10 @@ Now, pick a tutorial or code sample and start utilizing Gen2 capabilities
    samples/26_3_spatial_tiny_yolo.rst
    samples/27_spatial_location_calculator.rst
    samples/28_camera_video_example.rst
+   samples/29_1_object_tracker.rst
+   samples/29_2_spatial_object_tracker.rst
+   samples/29_3_object_tracker_video.rst
+   samples/30_stereo_depth_from_host.rst
 
 .. toctree::
    :maxdepth: 1

docs/source/index.rst

@@ -10,7 +10,7 @@ Demo
 .. raw:: html
 
     <div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; height: auto;">
-        <iframe src="https://www.youtube.com/embed/liTGGyJwZ_8" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
+        <iframe src="https://www.youtube.com/embed/8Jih63NWFdI" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
     </div>
 
 Setup

docs/source/samples/09_mono_mobilenet.rst

@@ -1,5 +1,5 @@
-10 - Mono & MobilenetSSD & Encoding
-===================================
+10 - Mono & MobilenetSSD & Depth
+================================
 
 This example shows how to run MobileNetv2SSD on the left grayscale camera in parallel with running
 the disparity depth results, displaying both the depth map and the right grayscale stream, with the
@@ -11,7 +11,7 @@ Demo
 .. raw:: html
 
     <div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; height: auto;">
-        <iframe src="https://www.youtube.com/embed/D_hefNl134M" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
+        <iframe src="https://www.youtube.com/embed/aCT0CRXx1qI" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
     </div>
 
 Setup

docs/source/samples/10_mono_depth_mobilenetssd.rst

@@ -18,7 +18,7 @@ Demo
 .. raw:: html
 
     <div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; height: auto;">
-        <iframe src="https://www.youtube.com/embed/qzwt9XXNsow" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
+        <iframe src="https://www.youtube.com/embed/3n549_6dANo" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
     </div>
 
 Setup

docs/source/samples/11_rgb_encoding_mono_mobilenet.rst

@@ -20,7 +20,7 @@ Demo
 .. raw:: html
 
     <div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; height: auto;">
-        <iframe src="https://www.youtube.com/embed/Yeuzo1H24KQ" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
+        <iframe src="https://www.youtube.com/embed/3sijxVDVFY8" frameborder="0" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe>
     </div>
 
 Setup

docs/source/samples/12_rgb_encoding_mono_mobilenet_depth.rst

@@ -1,5 +1,5 @@
-14 - Color Camera Control
-=========================
+14.1 - Color Camera Control
+===========================
 
 This example shows how to controll the device-side crop and camera triggers.
 An output is a displayed RGB cropped frame, that can be manipulated using the following keys:
@@ -9,6 +9,12 @@ An output is a displayed RGB cropped frame, that can be manipulated using the fo
 #. `w` will move the crop up
 #. `s` will move the crop down
 #. `c` will trigger a `still` event, causing the current frame to be captured and sent over `still` output from camera node
+#. `t` will trigger autofocus
+#. `f` will trigger autofocus continuously
+#. `e` will trigger autoexposure
+#. `i` and `o` will decrease/increase the exposure time
+#. `k` and `l` will decrease/increase the sensitivity iso
+#. `,` and `.` will decrease/increase the focus range
 
 Demo
 ####
@@ -27,9 +33,9 @@ Setup
 Source code
 ###########
 
-Also `available on GitHub <https://github.com/luxonis/depthai-python/blob/main/examples/14_color_camera_control.py>`__
+Also `available on GitHub <https://github.com/luxonis/depthai-python/blob/main/examples/14_1_color_camera_control.py>`__
 
-.. literalinclude:: ../../../examples/14_color_camera_control.py
+.. literalinclude:: ../../../examples/14_1_color_camera_control.py
    :language: python
    :linenos:
 

docs/source/samples/14_color_camera_control.rst renamed to docs/source/samples/14_1_color_camera_control.rst

@@ -0,0 +1,34 @@
+14.2 - Mono Camera Control
+==========================
+
+This example shows how to controll the device-side crop and camera triggers.
+TWo output is a displayed mono cropped frame, that can be manipulated using the following keys:
+
+#. `a` will move the crop left
+#. `d` will move the crop right
+#. `w` will move the crop up
+#. `s` will move the crop down
+#. `e` will trigger autoexposure
+#. `i` and `o` will decrease/increase the exposure time
+#. `k` and `l` will decrease/increase the sensitivity iso
+
+
+Demo
+####
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Source code
+###########
+
+Also `available on GitHub <https://github.com/luxonis/depthai-python/blob/main/examples/14_2_mono_camera_control.py>`__
+
+.. literalinclude:: ../../../examples/14_2_mono_camera_control.py
+   :language: python
+   :linenos:
+
+.. include::  /includes/footer-short.rst