Add rst files to stereo_depth_video

Author: csaba-luxonis

depthai-core

@@ -5,11 +5,16 @@ This example shows how to set the SGBM (semi-global-matching) disparity-depth no
 over XLink to transfer the results to the host real-time, and displays the depth map in OpenCV.
 Note that disparity is used in this case, as it colorizes in a more intuitive way.
 Below is also a preview of using different median filters side-by-side on a depth image.
+There are 3 depth modes which you can select inside the code:
+#. lr_check: computes disparity with sub-pixel interpolation (5 fractional bits), suitable for long range
+#. extended_disparity: mirror rectified frames: true to have disparity/depth normal (non-mirrored)
+#. subpixel: suitable for short range objects
 
 .. rubric:: Similiar samples:
 
 - :ref:`RGB Preview`
 - :ref:`Mono Preview`
+- :ref:`Stereo Depth Video`
 
 Demo
 ####

docs/source/samples/depth_preview.rst

@@ -1,10 +1,16 @@
 Stereo Depth from host
 ======================
 
-This example shows depth map from host using stereo images. There are 3 depth modes which you can select
-inside the code: left-right check, extended (for closer distance), subpixel (for longer distance).
+This example shows depth map from host using stereo images. There are 3 depth modes which you can select inside the code:
+#. lr_check: computes disparity with sub-pixel interpolation (5 fractional bits), suitable for long range
+#. extended_disparity: mirror rectified frames: true to have disparity/depth normal (non-mirrored)
+#. subpixel: suitable for short range objects
 Otherwise a median with kernel_7x7 is activated.
 
+.. rubric:: Similiar samples:
+
+- :ref:`Stereo Depth Video`
+
 Setup
 #####
 

docs/source/samples/stereo_depth_from_host.rst

@@ -0,0 +1,44 @@
+Stereo Depth Video
+==================
+
+This example is an upgraded :ref:`Depth Preview`. It has higher resolution (720p), each frame can be shown
+(mono left-right, rectified left-right, disparity and depth). There are 6 modes which you can select
+inside the code:
+#. withDepth: if you turn it off it will became :ref:`Mono Preview`, so it will show only the 2 mono cameras
+#. outputDepth: if you turn it on it will show the depth
+#. lrcheck: computes disparity with sub-pixel interpolation (5 fractional bits), suitable for long range
+#. extended: mirror rectified frames: true to have disparity/depth normal (non-mirrored)
+#. subpixel: suitable for short range objects
+
+.. rubric:: Similiar samples:
+
+- :ref:`Depth Preview`
+- :ref:`Stereo Depth from host`
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Source code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai-python/blob/main/examples/stereo_depth_video.py>`__
+
+        .. literalinclude:: ../../../examples/stereo_depth_video.py
+           :language: python
+           :linenos:
+
+    .. tab:: C++
+
+        Also `available on GitHub <https://github.com/luxonis/depthai-core/blob/main/examples/src/stereo_depth_video.cpp>`__
+
+        .. literalinclude:: ../../../depthai-core/examples/src/stereo_depth_video.cpp
+           :language: cpp
+           :linenos:
+
+.. include::  /includes/footer-short.rst

docs/source/samples/stereo_depth_video.rst

@@ -35,6 +35,7 @@ Code samples are used for automated testing. They are also a great starting poin
 - :ref:`Mono Camera Control` - Demonstrates how to control the mono camera (crop, exposure, sensitivity) from the host
 - :ref:`Depth Crop Control` - Demonstrates how to control cropping of depth frames from the host
 - :ref:`Stereo Depth from host` - Generates stereo depth frame from a set of mono images from the host
+- :ref:`Stereo Depth Video` - An extended version of **Depth Preview**
 - :ref:`RGB Rotate Warp` - Demonstrates how to rotate, mirror, flip or perform perspective transform on a frame
 - :ref:`RGB Depth` - Displays RGB depth frames
 - :ref:`Auto Exposure on ROI` - Demonstrates how to use auto exposure based on the selected ROI

docs/source/tutorials/code_samples.rst

@@ -10,6 +10,7 @@ Complex
    ../samples/mono_camera_control.rst
    ../samples/depth_crop_control.rst
    ../samples/stereo_depth_from_host.rst
+   ../samples/stereo_depth_video.rst
    ../samples/rgb_rotate_warp.rst
    ../samples/rgb_depth_aligned.rst
    ../samples/autoexposure_roi.rst
@@ -34,6 +35,7 @@ If you want to see more interesting examples you should check out our `Experimen
 - :ref:`Mono Camera Control` - Demonstrates how to control the mono camera (crop, exposure, sensitivity) from the host
 - :ref:`Depth Crop Control` - Demonstrates how to control cropping of depth frames from the host
 - :ref:`Stereo Depth from host` - Generates stereo depth frame from a set of mono images from the host
+- :ref:`Stereo Depth Video` - An extended version of **Depth Preview**
 - :ref:`RGB Rotate Warp` - Demonstrates how to rotate, mirror, flip or perform perspective transform on a frame
 - :ref:`RGB Depth` - Displays RGB depth frames
 - :ref:`Auto Exposure on ROI` - Demonstrates how to use auto exposure based on the selected ROI

docs/source/tutorials/complex_samples.rst

@@ -118,3 +118,4 @@ add_python_example(object_tracker object_tracker.py)
 add_python_example(spatial_object_tracker spatial_object_tracker.py)
 add_python_example(object_tracker_video object_tracker_video.py)
 add_python_example(stereo_depth_from_host stereo_depth_from_host.py)
+add_python_example(stereo_depth_video stereo_depth_video.py)