Webcams for vision portal (#217)

* Add List of VisionPortal Supported Webcams * Added webcam information for FTC
FIRST-Tech-Challenge · Sep 5, 2023 · 65fd742 · 65fd742
1 parent 8ef42d3
commit 65fd742
Showing 1 changed file with 91 additions and 23 deletions.
diff --git a/docs/source/apriltag/vision_portal/visionportal_webcams/visionportal-webcams.rst b/docs/source/apriltag/vision_portal/visionportal_webcams/visionportal-webcams.rst
@@ -27,6 +27,16 @@ The `Logitech C270 <https://www.logitech.com/en-us/products/webcams/c270-hd-webc
 is available at the FIRST Storefront for new FTC teams, and at many
 online retailers.
 
+**FTC Hot Take:**
+
+* The Logitech C270 is Logitech's budget line of webcams. It is incredibly
+  inexpensive, and fairly reliable. The C270 is the workhorse webcam for 
+  *FIRST* Tech Challenge.
+* The Logitech C270 has a 60-degree field of view, and a maximum frame rate of
+  30fps at 720p which makes it a reasonable choice for vision processing.
+* The audio quality of the C270 is lackluster, but audio is not generally a
+  factor in *FIRST* Tech Challenge.
+
 **Supported Resolutions:** 160x120, 176x144, 320x176, 320x240, 352x288,
 432x240, 544x288, 640x360, 640x480, 752x416, 800x448, 800x600, 864x480,
 960x544, 960x720, 1024x576, 1184x656, 1280x720
@@ -35,6 +45,37 @@ The FTC SDK provides **built-in calibration values** for the FTC
 VisionPortal default resolution of 640x480, and no others. Learn more at
 :ref:`AprilTag Camera Calibration <apriltag/vision_portal/apriltag_camera_calibration/apriltag-camera-calibration:apriltag camera calibration>`.
 
+Logitech C310
+-------------
+
+.. figure:: images/030-C310.png
+   :align: center
+   :width: 55%
+   :alt: C310 Camera
+
+   Logitech C310 Camera
+
+The `Logitech C310 <https://www.logitech.com/en-us/products/webcams/c310-hd-webcam.960-000585.html>`__
+is available at some online retailers.
+
+**FTC Hot Take:**
+
+* The Logitech C310 is also in Logitech's budget line of webcams. It is
+  slightly more expensive than the C270, and is a marginal step up. 
+* Like the C270, the Logitech C310 has a 60-degree field of view, and a maximum
+  frame rate of 30fps at 720p which makes it a reasonable choice for vision
+  processing.
+* The C310 has slightly better color correction and dynamic color range than 
+  the C270, but these likely won't be realized without using the webcam control
+  interface provided by the FTC SDK.
+* The audio quality of the C310 is slightly better than the C270, but again
+  audio is not generally a factor in *FIRST* Tech Challenge.
+
+**Supported Resolutions:** not published; probably similar to Logitech C270.
+
+The FTC SDK provides **built-in calibration values** for the FTC
+VisionPortal default resolution of 640x480, and for 640x360. Learn more at
+:ref:`AprilTag Camera Calibration <apriltag/vision_portal/apriltag_camera_calibration/apriltag-camera-calibration:apriltag camera calibration>`.
 
 Logitech C920
 -------------
@@ -49,6 +90,20 @@ Logitech C920
 The `Logitech C920 <https://www.logitech.com/en-us/products/webcams/c920s-pro-hd-webcam.960-001257.html>`__
 is available at many online retailers.
 
+**FTC Hot Take:**
+
+* The Logitech C920 is in Logitech's mid-range line of webcams. It is
+  slightly more expensive than the C310, but is a dramatic step-up in quality.
+  If you find a C310 for almost the same price as a C920, just buy the C920.
+* The Logitech C920 has a 78-degree field of view, and a maximum
+  frame rate of 60fps at 1080p which makes it a fabulous choice for vision
+  processing. The C920 also includes an auto-focus option, whereas the 
+  C270 and C310 are fixed-focus, though the auto-focus tends to be slow.
+* The C920 has additional options for mounting the camera, with a 1/4 inch
+  threaded mount. The C920 also has a much better mounting clip.
+* The audio quality of the the C920 is phenomenally better than the C270, or 
+  C310, but again audio is not generally a factor in *FIRST* Tech Challenge.
+
 **Supported Resolutions:** 160x90, 160x120, 176x144, 320x180, 320x240,
 352x288, 432x240, 640x360, 640x480, 800x448, 800x600, 864x480, 960x720,
 1024x576, 1280x720, 1600x896, 1920x1080, 2304x1296, 2304x1536.
@@ -58,25 +113,6 @@ VisionPortal default resolution of 640x480, and five others: 640x360,
 800x448, 800x600, 864x480, and 1920x1080. Learn more at
 :ref:`AprilTag Camera Calibration <apriltag/vision_portal/apriltag_camera_calibration/apriltag-camera-calibration:apriltag camera calibration>`.
 
-Logitech C310
--------------
-
-.. figure:: images/030-C310.png
-   :align: center
-   :width: 55%
-   :alt: C310 Camera
-
-   Logitech C310 Camera
-
-The `Logitech C310 <https://www.logitech.com/en-us/products/webcams/c310-hd-webcam.960-000585.html>`__
-is available at some online retailers.
-
-**Supported Resolutions:** not published; probably similar to Logitech C270.
-
-The FTC SDK provides **built-in calibration values** for the FTC
-VisionPortal default resolution of 640x480, and for 640x360. Learn more at
-:ref:`AprilTag Camera Calibration <apriltag/vision_portal/apriltag_camera_calibration/apriltag-camera-calibration:apriltag camera calibration>`.
-
 Microsoft LifeCam HD-3000 v1/v2
 -------------------------------
 
@@ -90,6 +126,18 @@ Microsoft LifeCam HD-3000 v1/v2
 The `Microsoft LifeCam HD-3000 <https://www.microsoft.com/en/accessories/products/webcams/lifecam-hd-3000>`__
 is available at some online retailers.
 
+**FTC Hot Take:**
+
+* The Microsoft LifeCam HD-3000 has been a mainstay in *FIRST* Robotics
+  Competition for a number of years, so it's likely a local team might have
+  one they will just give you. The HD-3000 has been around for over 10 years,
+  with a "don't fix what isn't broken" mentality. It defines the "budget" 
+  part of Microsoft's "budget" line of webcams.
+* The HD-3000 sports a 68.5 degree field of view, slightly wider than the
+  Logitech C270 and C310 webcams, at 30fps at 720p (same as the others).
+* The HD-3000 is as "no-frills" as it gets otherwise, but at its price
+  point that shouldn't be much of a surprise.
+
 **Supported Resolutions:** not published; up to 1280x720.
 
 For v1 and v2 of this webcam, the FTC SDK provides **built-in
@@ -146,6 +194,18 @@ FPS <https://www.arducam.com/product/arducam-120fps-global-shutter-usb-camera-bo
 is available at some online retailers, including
 `Amazon <https://www.amazon.com/Arducam-Distortion-Microphones-Computer-Raspberry/dp/B096M5DKY6>`__.
 
+**FTC Hot Take:**
+
+* The Arducam OV9281 Global Shutter camera can pump out 100+fps in MJPG mode at
+  full resolution, with phenomenal resistance to motion blur effects (due to
+  the Global Shutter design). 
+* The Arducam OV9281 is a monochrome (black&white) camera, so applications
+  needing color should look elsewhere.
+* The Arducam OV9281 is fantastic in low-light scenarios, and has a very 
+  low-distortion lens making it perfect for object tracking and motion detection.
+* The Arducam required a patch to EasyOpenCV to work properly, so it is not
+  guaranteed to work properly with the FTC SDK prior to SDK 9.0.
+
 **Supported Resolutions** in YUY2 format: 1280x720, 1280x800. Note frame
 rate limitations.
 
@@ -175,31 +235,39 @@ the *FIRST* Tech Challenge SDK, including resolutions with built-in
 calibrations and those without calibrations.
 
 .. list-table:: Cameras and Supported Resolutions
-   :widths: 33 33 33
+   :widths: 25 25 25 25
    :header-rows: 1
 
    * - Camera
+     - Features
      - Resolutions with Built-In Calibrations
      - Resolutions without Calibrations
    * - `Logitech C270`_
+     - 60 DegFOV, 30fps\@720p
      - 640x480
      - 160x120, 176x144, 320x176, 320x240, 352x288, 432x240, 544x288, 640x360, 752x416, 800x448, 800x600, 864x480, 960x544, 960x720, 1024x576, 1184x656, 1280x720
-   * - `Logitech C920`_
-     - 640x480, 640x360, 800x448, 800x600, 864x480, 1920x1080
-     - 160x90, 160x120, 176x144, 320x180, 320x240, 352x288, 432x240, 960x720, 1024x576, 1280x720, 1600x896, 2304x1296, 2304x1536
    * - `Logitech C310`_
+     - 60 DegFOV, 30fps\@720p
      - 640x480, 640x360
      - All other resolutions
+   * - `Logitech C920`_
+     - 78 DegFOV, 60fps\@1080p
+     - 640x480, 640x360, 800x448, 800x600, 864x480, 1920x1080
+     - 160x90, 160x120, 176x144, 320x180, 320x240, 352x288, 432x240, 960x720, 1024x576, 1280x720, 1600x896, 2304x1296, 2304x1536
    * - `Microsoft LifeCam HD-3000 v1/v2`_
+     - 68.5 DegFOV, 30fps\@720p
      - 640x480
      - All other resolutions
    * - `Arducam Global Shutter 120 FPS`_
+     - 70 DegFOV, 120fps\@1280x800 MJPG, Monochrome
      - No Built-In Calibrations
      - MJPEG: 320x240, 640x480, 800x600, 1280x720, 1280x800; YUY2: 1280x720, 1280x800
    * - Kayeton Global Shutter (`Other Global Shutter Cameras`_)
+     - 70 DegFOV, 120fps\@720p MJPG, Monochrome
      - No Built-In Calibrations
      - All resolutions
    * - ELP Global Shutter (`Other Global Shutter Cameras`_)
+     - 70 DegFOV, 90fps\@1920x1200 MJPG, Monochrome
      - No Built-In Calibrations
      - All resolutions