Merge pull request #309 from srobo/dgt/kit-version-2022-1-0

Release kit software v2022.1.0

Author: raccube

_data/kit_versions.yml

@@ -1,3 +1,6 @@
+# The latest version should be the first in this file.
+- version: 2022.1.0
+  released: 2022-02-04
 - version: 2022.0.2
   released: 2021-11-23
 - version: 2022.0.1

programming/python/libraries.md

@@ -11,7 +11,7 @@ Robot Kit
 
 The following python libraries are installed and available for use in your robot's software:
 
-* [astoria 0.7.0](https://pypi.org/project/astoria)
+* [astoria 0.8.0](https://pypi.org/project/astoria)
 * [cached-property 1.5.2](https://pypi.org/project/cached-property)
 * [click 8.0.1](https://pypi.org/project/click)
 * [cycler 0.10.0](https://pypi.org/project/cycler)
@@ -23,12 +23,13 @@ The following python libraries are installed and available for use in your robot
 * [gpg 1.16.0](https://pypi.org/project/gpg)
 * [iniparse 0.5](https://pypi.org/project/iniparse)
 * [j5 0.13.1](https://pypi.org/project/j5)
-* [j5-zoloto 0.1.0](https://pypi.org/project/j5-zoloto)
+* [j5-zoloto 0.2.0](https://pypi.org/project/j5-zoloto)
 * [kiwisolver 1.3.2](https://pypi.org/project/kiwisolver)
 * [matplotlib 3.4.1](https://pypi.org/project/matplotlib)
 * [numpy 1.21.2](https://pypi.org/project/numpy)
 * opencv 4.5.2
 * [pandas 1.3.3](https://pypi.org/project/pandas)
+* [pillow 8.3.2](https://pypi.org/project/Pillow/)
 * pkg-resources 57.4.0
 * [pydantic 1.8.2](https://pypi.org/project/pydantic)
 * [pygobject 3.40.1](https://pypi.org/project/PyGObject/)
@@ -47,6 +48,6 @@ The following python libraries are installed and available for use in your robot
 * [typing-extensions 3.10.0.0](https://pypi.org/project/typing-extensions)
 * [udiskie 2.3.3](https://pypi.org/project/udiskie)
 * udiskie-locale-en-us 2.3.3
-* [zoloto 0.7.1](https://pypi.org/project/zoloto)
+* [zoloto 0.8.0](https://pypi.org/project/zoloto)
 
 If you wish to use a library that isn't listed above, get in contact with us on Discord and have a chat with us about it.

programming/sr/vision/index.md

@@ -71,6 +71,24 @@ R = Robot()
 marker_ids = R.camera.save(R.usbkey / "initial-view.png")
 ~~~~~
 
+capture
+:   Take a photo through the webcam, and return the image data as an OpenCV array.
+
+<div class="info">
+This feature is only available on version 2022.1.0 or later of the kit.
+</div>
+
+~~~~~ python
+import cv2
+from sr.robot3 import *
+R = Robot()
+
+frame = R.camera.capture()
+
+# Flip the image with OpenCV
+flipped = cv2.flip(frame, 0)
+~~~~~
+
 [Field of View](#fov) {#fov}
 -------------------