Merge pull request #1070 from jakaskerl/main

Updating SDK docs with examples
luxonis · Jul 4, 2023 · 9db2903 · 9db2903
2 parents bce814c + a469d8d
commit 9db2903
Show file tree

Hide file tree

Showing 135 changed files with 2,197 additions and 2 deletions.
diff --git a/depthai_sdk/docs/requirements.txt b/depthai_sdk/docs/requirements.txt
@@ -1,3 +1,4 @@
-Sphinx==4.1.2
+Sphinx==4.2.0
 sphinx-rtd-theme==0.5.0
 autodocsumm==0.2.10
+sphinx-tabs==3.4.0
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_age_gender.png b/depthai_sdk/docs/source/_static/images/demos/sdk_age_gender.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_api_interop.png b/depthai_sdk/docs/source/_static/images/demos/sdk_api_interop.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_camera_control.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_camera_control.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_camera_control_with_NN.png b/depthai_sdk/docs/source/_static/images/demos/sdk_camera_control_with_NN.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_camera_preview.png b/depthai_sdk/docs/source/_static/images/demos/sdk_camera_preview.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_car_tracking.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_car_tracking.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_collision_avoidance.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_collision_avoidance.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_counter.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_counter.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_emotion_recognition.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_emotion_recognition.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_face_detection_color.png b/depthai_sdk/docs/source/_static/images/demos/sdk_face_detection_color.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_face_detection_left.png b/depthai_sdk/docs/source/_static/images/demos/sdk_face_detection_left.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_human_pose.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_human_pose.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_imu_demo.png b/depthai_sdk/docs/source/_static/images/demos/sdk_imu_demo.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_imu_rerun.png b/depthai_sdk/docs/source/_static/images/demos/sdk_imu_rerun.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_mono_400p.png b/depthai_sdk/docs/source/_static/images/demos/sdk_mono_400p.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_object_tracking.png b/depthai_sdk/docs/source/_static/images/demos/sdk_object_tracking.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_photo_download.png b/depthai_sdk/docs/source/_static/images/demos/sdk_photo_download.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_pointcloud.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_pointcloud.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_preview_all_cameras.png b/depthai_sdk/docs/source/_static/images/demos/sdk_preview_all_cameras.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_rotated.png b/depthai_sdk/docs/source/_static/images/demos/sdk_rotated.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_spatial_detection.png b/depthai_sdk/docs/source/_static/images/demos/sdk_spatial_detection.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_speed_calculation.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_speed_calculation.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_stereo_auto_ir.png b/depthai_sdk/docs/source/_static/images/demos/sdk_stereo_auto_ir.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_stereo_control.gif b/depthai_sdk/docs/source/_static/images/demos/sdk_stereo_control.gif
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_sync_multiple_outputs.png b/depthai_sdk/docs/source/_static/images/demos/sdk_sync_multiple_outputs.png
diff --git a/depthai_sdk/docs/source/_static/images/demos/sdk_visualizer_callback.png b/depthai_sdk/docs/source/_static/images/demos/sdk_visualizer_callback.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/age-gender.png b/depthai_sdk/docs/source/_static/images/pipelines/age-gender.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/api_interop.png b/depthai_sdk/docs/source/_static/images/pipelines/api_interop.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/cam_ffc.png b/depthai_sdk/docs/source/_static/images/pipelines/cam_ffc.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/camera_control.png b/depthai_sdk/docs/source/_static/images/pipelines/camera_control.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/camera_control_with_NN.png b/depthai_sdk/docs/source/_static/images/pipelines/camera_control_with_NN.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/camera_preview.png b/depthai_sdk/docs/source/_static/images/pipelines/camera_preview.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/car_tracking.png b/depthai_sdk/docs/source/_static/images/pipelines/car_tracking.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/collision_avoidance.png b/depthai_sdk/docs/source/_static/images/pipelines/collision_avoidance.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/counter.png b/depthai_sdk/docs/source/_static/images/pipelines/counter.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/custom_action.png b/depthai_sdk/docs/source/_static/images/pipelines/custom_action.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/custom_decode.png b/depthai_sdk/docs/source/_static/images/pipelines/custom_decode.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/custom_trigger.png b/depthai_sdk/docs/source/_static/images/pipelines/custom_trigger.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/deeplabv3_person.png b/depthai_sdk/docs/source/_static/images/pipelines/deeplabv3_person.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/emotion_recognition.png b/depthai_sdk/docs/source/_static/images/pipelines/emotion_recognition.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/encode.png b/depthai_sdk/docs/source/_static/images/pipelines/encode.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/encoder_preview.png b/depthai_sdk/docs/source/_static/images/pipelines/encoder_preview.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/face_detection_color.png b/depthai_sdk/docs/source/_static/images/pipelines/face_detection_color.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/face_detection_left.png b/depthai_sdk/docs/source/_static/images/pipelines/face_detection_left.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/human_pose.png b/depthai_sdk/docs/source/_static/images/pipelines/human_pose.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/imu.png b/depthai_sdk/docs/source/_static/images/pipelines/imu.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/looped_replay.png b/depthai_sdk/docs/source/_static/images/pipelines/looped_replay.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/mobilenet_encoded.png b/depthai_sdk/docs/source/_static/images/pipelines/mobilenet_encoded.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/mono_400p.png b/depthai_sdk/docs/source/_static/images/pipelines/mono_400p.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/nn_component.png b/depthai_sdk/docs/source/_static/images/pipelines/nn_component.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/object_tracking.png b/depthai_sdk/docs/source/_static/images/pipelines/object_tracking.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/people_tracker.png b/depthai_sdk/docs/source/_static/images/pipelines/people_tracker.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/person_record.png b/depthai_sdk/docs/source/_static/images/pipelines/person_record.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/photo_download.png b/depthai_sdk/docs/source/_static/images/pipelines/photo_download.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/pointcloud.png b/depthai_sdk/docs/source/_static/images/pipelines/pointcloud.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/preview_all_cameras.png b/depthai_sdk/docs/source/_static/images/pipelines/preview_all_cameras.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/recording_duration.png b/depthai_sdk/docs/source/_static/images/pipelines/recording_duration.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/rgb_mono_preview.png b/depthai_sdk/docs/source/_static/images/pipelines/rgb_mono_preview.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/roboflow_integration.png b/depthai_sdk/docs/source/_static/images/pipelines/roboflow_integration.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/rosbag_record.png b/depthai_sdk/docs/source/_static/images/pipelines/rosbag_record.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/rotated.png b/depthai_sdk/docs/source/_static/images/pipelines/rotated.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/spatial_detection.png b/depthai_sdk/docs/source/_static/images/pipelines/spatial_detection.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/stereo.png b/depthai_sdk/docs/source/_static/images/pipelines/stereo.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/stereo_auto_ir.png b/depthai_sdk/docs/source/_static/images/pipelines/stereo_auto_ir.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/stereo_control.png b/depthai_sdk/docs/source/_static/images/pipelines/stereo_control.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/stereo_encoded.png b/depthai_sdk/docs/source/_static/images/pipelines/stereo_encoded.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/stereo_record.png b/depthai_sdk/docs/source/_static/images/pipelines/stereo_record.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/switch_between_models.png b/depthai_sdk/docs/source/_static/images/pipelines/switch_between_models.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/sync_multiple_outputs.png b/depthai_sdk/docs/source/_static/images/pipelines/sync_multiple_outputs.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/visualizer.png b/depthai_sdk/docs/source/_static/images/pipelines/visualizer.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/visualizer_callback.png b/depthai_sdk/docs/source/_static/images/pipelines/visualizer_callback.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/yolo.png b/depthai_sdk/docs/source/_static/images/pipelines/yolo.png
diff --git a/depthai_sdk/docs/source/_static/images/pipelines/youtube_download.png b/depthai_sdk/docs/source/_static/images/pipelines/youtube_download.png
diff --git a/depthai_sdk/docs/source/components/camera_component.rst b/depthai_sdk/docs/source/components/camera_component.rst
@@ -5,6 +5,7 @@ CameraComponent
 nodes and supports mocking the camera when recording is passed during OakCamera initialization. When using :ref:`Replaying` feature, this component will
 mock the camera by sending frames from the host to the OAK device (via `XLinkIn <https://docs.luxonis.com/projects/api/en/latest/components/nodes/xlink_in/>`__ node).
 
+
 Usage
 #####
 

diff --git a/depthai_sdk/docs/source/conf.py b/depthai_sdk/docs/source/conf.py
@@ -36,7 +36,8 @@
     "sphinx_rtd_theme",
     'sphinx.ext.autodoc',
     'sphinx.ext.napoleon',
-    'autodocsumm'
+    'autodocsumm',
+    'sphinx_tabs.tabs'
 ]
 
 # Add any paths that contain templates here, relative to this directory.

diff --git a/depthai_sdk/docs/source/includes/blocking_behavior.rst b/depthai_sdk/docs/source/includes/blocking_behavior.rst
@@ -0,0 +1,3 @@
+.. note::
+    Visualization in current example is done with blocking behavor. This means that the program will halt at ``oak.start()`` until the window is closed.
+    This is done to keep the example simple. For more advanced usage, see :ref:`Blocking behavior` section.
diff --git a/depthai_sdk/docs/source/includes/install_from_pypi.rst b/depthai_sdk/docs/source/includes/install_from_pypi.rst
@@ -0,0 +1,12 @@
+Please run the `install script <https://github.com/luxonis/depthai/blob/main/install_requirements.py>`__
+to download all required dependencies. Please note that this script must be ran from git context, so you have to download the `depthai <https://github.com/luxonis/depthai>`__ repository first and then run the script
+
+
+.. code-block:: python
+
+   git clone https://github.com/luxonis/depthai.git
+   cd depthai/
+   python3 install_requirements.py
+
+
+For additional information, please follow our :ref:`installation guide <Installation>`.
diff --git a/depthai_sdk/docs/source/index.rst b/depthai_sdk/docs/source/index.rst
@@ -39,10 +39,20 @@ ease of use when developing apps for OAK devices**.
 
    features/*
 
+
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+   :caption: Examples
+
+   tutorials/code_samples.rst
+
+
 .. toctree::
     :maxdepth: 2
     :hidden:
     :glob:
     :caption: References
 
     api_reference.rst
+
diff --git a/depthai_sdk/docs/source/quickstart.rst b/depthai_sdk/docs/source/quickstart.rst
@@ -18,6 +18,38 @@ This class simplifies the creation of pipelines that capture video from the OAK
 With :class:`OakCamera <depthai_sdk.OakCamera>`, you can easily create color and depth streams using the :meth:`create_camera() <depthai_sdk.OakCamera.create_camera>` and :meth:`create_stereo() <depthai_sdk.OakCamera.create_stereo>` methods respectively, and add pre-trained neural networks using the :meth:`create_nn() <depthai_sdk.OakCamera.create_nn>` method.
 Additionally, you can add custom callbacks to the pipeline using the :meth:`callback() <depthai_sdk.OakCamera.callback>` method and record the outputs using the :meth:`record() <depthai_sdk.OakCamera.record>` method.
 
+Blocking behavior
+^^^^^^^^^^^^^^^^^
+
+When starting the :class:`OakCamera <depthai_sdk.OakCamera>` object, you can specify whether the :meth:`start() <depthai_sdk.OakCamera.start>` method should block the main thread or not. By default, the :meth:`start() <depthai_sdk.OakCamera.start>` method does not block the main thread, which means you will need to manually poll the camera using the :meth:`oak.poll() <depthai_sdk.OakCamera.poll>` method.
+
+.. code-block:: python
+
+    from depthai_sdk import OakCamera
+
+    with OakCamera() as oak:
+        color = oak.create_camera('color', resolution='1080p')
+        oak.visualize([color])
+        oak.start(blocking=False)
+
+        while oak.running():
+            oak.poll()
+            # this code is executed while the pipeline is running
+
+
+Alternatively, setting the ``blocking`` argument to ``True`` will loop and continuously poll the camera, blocking the rest of the code.
+
+
+.. code-block:: python
+
+    from depthai_sdk import OakCamera
+
+    with OakCamera() as oak:
+        color = oak.create_camera('color', resolution='1080p')
+        oak.visualize([color])
+        oak.start(blocking=True)
+        # this code doesn't execute until the pipeline is stopped
+
 Creating color and depth streams
 ---------------------
 

diff --git a/depthai_sdk/docs/source/samples/CameraComponent/sdk_cam_ffc.rst b/depthai_sdk/docs/source/samples/CameraComponent/sdk_cam_ffc.rst
@@ -0,0 +1,37 @@
+FFC Camera Visualization
+========================
+
+This example shows how to use the `Camera` component to display the camera feed from the FFC camera. 
+
+For FFC, the camera board socket must be specified. In our case the cameras are connected to socket A, B and C. After setting the resolution to 1200p
+and downscaling using ISP to 800p, the camera feed is displayed in a window.
+
+.. include::  /includes/blocking_behavior.rst
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Pipeline
+########
+
+.. image:: /_static/images/pipelines/cam_ffc.png
+      :alt: Pipeline graph
+
+
+Source Code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai/depthai_sdk/examples/CameraComponent/cam_ffc.py>`__
+
+        .. literalinclude:: ../../../../examples/CameraComponent/cam_ffc.py
+            :language: python
+            :linenos:
+
+.. include::  /includes/footer-short.rst
diff --git a/depthai_sdk/docs/source/samples/CameraComponent/sdk_camera_control.rst b/depthai_sdk/docs/source/samples/CameraComponent/sdk_camera_control.rst
@@ -0,0 +1,49 @@
+Camera Control
+==============
+
+This example shows how to use DepthAI SDK to control the color camera parameters. 
+
+.. code-block::
+
+    Control:      key[dec/inc]  min..max
+    exposure time:     I   O      1..33000 [us]
+    sensitivity iso:   K   L    100..1600
+
+    To go back to auto controls:
+    'E' - autoexposure
+
+
+Demo
+####
+
+.. image:: /_static/images/demos/sdk_camera_control.gif
+      :alt: Camera Control Demo
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Pipeline
+########
+
+.. image:: /_static/images/pipelines/camera_control.png
+      :alt: Pipeline graph
+
+
+
+Source Code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai/depthai_sdk/examples/CameraComponent/camera_control.py>`__
+
+        .. literalinclude:: ../../../../examples/CameraComponent/camera_control.py
+            :language: python
+            :linenos:
+
+.. include::  /includes/footer-short.rst
diff --git a/depthai_sdk/docs/source/samples/CameraComponent/sdk_camera_control_with_nn.rst b/depthai_sdk/docs/source/samples/CameraComponent/sdk_camera_control_with_nn.rst
@@ -0,0 +1,41 @@
+Camera Control with NN
+=====================
+
+This example shows how to set up control of color camera (focus and exposure) to be controlled by NN. The NN is a face detection model which passes detected face
+bounding box to camera component run auto focus and auto exposure algorithms on. 
+
+.. include::  /includes/blocking_behavior.rst
+
+Demo
+####
+
+.. image:: /_static/images/demos/sdk_camera_control_with_NN.png
+      :alt: Control with NN Demo
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Pipeline
+########
+
+.. image:: /_static/images/pipelines/camera_control_with_NN.png
+      :alt: Pipeline graph
+
+
+Source Code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai/depthai_sdk/examples/CameraComponent/camera_control_with_NN.py>`__
+
+        .. literalinclude:: ../../../../examples/CameraComponent/camera_control_with_NN.py
+            :language: python
+            :linenos:
+
+.. include::  /includes/footer-short.rst
diff --git a/depthai_sdk/docs/source/samples/CameraComponent/sdk_camera_preview.rst b/depthai_sdk/docs/source/samples/CameraComponent/sdk_camera_preview.rst
@@ -0,0 +1,43 @@
+Camera Preview
+==============
+
+This example shows how to set up a pipeline that outputs a a preview for color camera, both mono cameras and their stereo depth. Each frame is displayed using OpenCV in blocking behavour. 
+
+.. include::  /includes/blocking_behavior.rst
+
+
+
+Demo
+####
+
+.. image:: /_static/images/demos/sdk_camera_preview.png
+      :alt: Camera Preview Demo
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Pipeline
+########
+
+.. image:: /_static/images/pipelines/camera_preview.png
+      :alt: Pipeline graph
+
+
+
+Source Code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai/depthai_sdk/examples/CameraComponent/camera_preview.py>`__
+
+        .. literalinclude:: ../../../../examples/CameraComponent/camera_preview.py
+            :language: python
+            :linenos:
+
+.. include::  /includes/footer-short.rst
diff --git a/depthai_sdk/docs/source/samples/CameraComponent/sdk_mono_400p.rst b/depthai_sdk/docs/source/samples/CameraComponent/sdk_mono_400p.rst
@@ -0,0 +1,40 @@
+Mono Camera Preview
+===================
+
+This example shows how to set up a pipeline that outputs a video feed for both mono cameras and sets the resolution to 400p (640x400) and the frame rate to 60 fps.
+
+.. include::  /includes/blocking_behavior.rst
+
+Demo
+####
+
+.. image:: /_static/images/demos/sdk_mono_400p.png
+      :alt: Mono Demo
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Pipeline
+########
+
+.. image:: /_static/images/pipelines/mono_400p.png
+      :alt: Pipeline graph
+
+
+Source Code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai/depthai_sdk/examples/CameraComponent/mono_400p.py>`__
+
+        .. literalinclude:: ../../../../examples/CameraComponent/mono_400p.py
+            :language: python
+            :linenos:
+
+.. include::  /includes/footer-short.rst
diff --git a/depthai_sdk/docs/source/samples/CameraComponent/sdk_preview_all_cameras.rst b/depthai_sdk/docs/source/samples/CameraComponent/sdk_preview_all_cameras.rst
@@ -0,0 +1,41 @@
+Preview All Cameras
+===================
+
+This example shows how to set up a pipeline that outputs a a preview for each camera currently connected (and available) to the device. The preview is displayed in a window on the host machine.
+If run on OAK-D devices, this example does the same thing as the ``sdk_camera_preview`` example.
+
+.. include::  /includes/blocking_behavior.rst
+
+Demo
+####
+
+.. image:: /_static/images/demos/sdk_preview_all_cameras.png
+      :alt: Camera Preview Demo
+
+
+Setup
+#####
+
+.. include::  /includes/install_from_pypi.rst
+
+Pipeline
+########
+
+.. image:: /_static/images/pipelines/preview_all_cameras.png
+      :alt: Pipeline graph
+
+
+Source Code
+###########
+
+.. tabs::
+
+    .. tab:: Python
+
+        Also `available on GitHub <https://github.com/luxonis/depthai/depthai_sdk/examples/CameraComponent/preview_all_cameras.py>`__
+
+        .. literalinclude:: ../../../../examples/CameraComponent/preview_all_cameras.py
+            :language: python
+            :linenos:
+
+.. include::  /includes/footer-short.rst