raspberrypilearning · ninaszymor · Feb 4, 2021 · Feb 4, 2021 · Feb 4, 2021 · Feb 4, 2021
diff --git a/af-ZA/images/Getting_Started_With_Picamera_TILE.png b/af-ZA/images/Getting_Started_With_Picamera_TILE.png
diff --git a/af-ZA/images/banner.png b/af-ZA/images/banner.png
diff --git a/af-ZA/images/blur.jpg b/af-ZA/images/blur.jpg
diff --git a/af-ZA/images/camera-module.png b/af-ZA/images/camera-module.png
diff --git a/af-ZA/images/cartoon.jpg b/af-ZA/images/cartoon.jpg
diff --git a/af-ZA/images/colorbalance.jpg b/af-ZA/images/colorbalance.jpg
diff --git a/af-ZA/images/colorpoint.jpg b/af-ZA/images/colorpoint.jpg
diff --git a/af-ZA/images/colorswap.jpg b/af-ZA/images/colorswap.jpg
diff --git a/af-ZA/images/connect-camera-old.gif b/af-ZA/images/connect-camera-old.gif
diff --git a/af-ZA/images/connect-camera.gif b/af-ZA/images/connect-camera.gif
diff --git a/af-ZA/images/connect-camera.gif.gif b/af-ZA/images/connect-camera.gif.gif
diff --git a/af-ZA/images/connect-camera1.png b/af-ZA/images/connect-camera1.png
diff --git a/af-ZA/images/connect-camera2.png b/af-ZA/images/connect-camera2.png
diff --git a/af-ZA/images/connect-camera3.png b/af-ZA/images/connect-camera3.png
diff --git a/af-ZA/images/connect-camera4.png b/af-ZA/images/connect-camera4.png
diff --git a/af-ZA/images/connect-camera5.png b/af-ZA/images/connect-camera5.png
diff --git a/af-ZA/images/deinterlace1.jpg b/af-ZA/images/deinterlace1.jpg
diff --git a/af-ZA/images/deinterlace2.jpg b/af-ZA/images/deinterlace2.jpg
diff --git a/af-ZA/images/denoise.jpg b/af-ZA/images/denoise.jpg
diff --git a/af-ZA/images/desktop-annotated.png b/af-ZA/images/desktop-annotated.png
diff --git a/af-ZA/images/desktop.png b/af-ZA/images/desktop.png
diff --git a/af-ZA/images/effects.jpg b/af-ZA/images/effects.jpg
diff --git a/af-ZA/images/emboss.jpg b/af-ZA/images/emboss.jpg
diff --git a/af-ZA/images/film.jpg b/af-ZA/images/film.jpg
diff --git a/af-ZA/images/gpen.jpg b/af-ZA/images/gpen.jpg
diff --git a/af-ZA/images/hatch.jpg b/af-ZA/images/hatch.jpg
diff --git a/af-ZA/images/negative.jpg b/af-ZA/images/negative.jpg
diff --git a/af-ZA/images/none.jpg b/af-ZA/images/none.jpg
diff --git a/af-ZA/images/oilpaint.jpg b/af-ZA/images/oilpaint.jpg
diff --git a/af-ZA/images/open-terminal-annotated.png b/af-ZA/images/open-terminal-annotated.png
diff --git a/af-ZA/images/open-terminal.png b/af-ZA/images/open-terminal.png
diff --git a/af-ZA/images/pastel.jpg b/af-ZA/images/pastel.jpg
diff --git a/af-ZA/images/pi-camera-attached.jpg b/af-ZA/images/pi-camera-attached.jpg
diff --git a/af-ZA/images/pi-configuration-interfaces-annotated.png b/af-ZA/images/pi-configuration-interfaces-annotated.png
diff --git a/af-ZA/images/pi-configuration-interfaces.png b/af-ZA/images/pi-configuration-interfaces.png
diff --git a/af-ZA/images/pi-configuration-menu.png b/af-ZA/images/pi-configuration-menu.png
diff --git a/af-ZA/images/pi4-camera-port.png b/af-ZA/images/pi4-camera-port.png
diff --git a/af-ZA/images/posterise.jpg b/af-ZA/images/posterise.jpg
diff --git a/af-ZA/images/preview.jpg b/af-ZA/images/preview.jpg
diff --git a/af-ZA/images/raspberry-pi.png b/af-ZA/images/raspberry-pi.png
diff --git a/af-ZA/images/raspistill-help.png b/af-ZA/images/raspistill-help.png
diff --git a/af-ZA/images/raspistill-image.png b/af-ZA/images/raspistill-image.png
diff --git a/af-ZA/images/saturation.jpg b/af-ZA/images/saturation.jpg
diff --git a/af-ZA/images/sketch.jpg b/af-ZA/images/sketch.jpg
diff --git a/af-ZA/images/solarize.jpg b/af-ZA/images/solarize.jpg
diff --git a/af-ZA/images/thonny-app-menu.png b/af-ZA/images/thonny-app-menu.png
diff --git a/af-ZA/images/washedout.jpg b/af-ZA/images/washedout.jpg
diff --git a/af-ZA/images/watercolor.jpg b/af-ZA/images/watercolor.jpg
diff --git a/af-ZA/meta.yml b/af-ZA/meta.yml
@@ -0,0 +1,31 @@
+---
+title: Getting started with the Camera Module
+hero_image: images/banner.png
+description: Take pictures and video with the Raspberry Pi Camera Module and Python
+listed: true
+copyedit: true
+version: 4
+last_tested: 2018-05-13
+steps:
+  - 
+    title: Introduction
+  - 
+    title: What you will need
+  - 
+    title: Connect the Camera Module
+  - 
+    title: How to control the Camera Module via the command line
+    completion:
+      - engaged
+  - 
+    title: How to control the Camera Module with Python code
+  - 
+    title: Take still pictures with Python code
+  - 
+    title: Record video with Python code
+  - 
+    title: How to change the image settings and add image effects
+    completion:
+      - internal
+  - 
+    title: What next?
diff --git a/af-ZA/step_1.md b/af-ZA/step_1.md
@@ -0,0 +1,9 @@
+## Introduction
+
+[[[camera-bullseye]]]
+
+Learn how to connect the Raspberry Pi Camera Module to your Raspberry Pi and take pictures, record video, and apply image effects.
+
+![Raspberry Pi with Camera Module attached](images/pi-camera-attached.jpg)
+
+![Picture of the letters R and P, taken with the Raspberry Pi Camera Module](images/none.jpg)
diff --git a/af-ZA/step_2.md b/af-ZA/step_2.md
@@ -0,0 +1,20 @@
+## What you will need
+
+### Raspberry Pi computer with a Camera Module port
+
+All current models of Raspberry Pi have a port for connecting the Camera Module.
+
+![Raspberry Pi 3B+ with Camera Module port labelled](images/pi4-camera-port.png)
+
+**Note:** If you want to use a Raspberry Pi Zero, you need a Camera Module ribbon cable that fits the Raspberry Pi Zero's smaller Camera Module port.
+
+### Raspberry Pi Camera Module
+
+![Raspberry Pi Camera Module](images/camera-module.png)
+
+There are two versions of the Camera Module:
+
+* [The standard version](https://www.raspberrypi.org/products/camera-module-v2/), which is designed to take pictures in normal light
+* [The NoIR version](https://www.raspberrypi.org/products/pi-noir-camera-v2/), which doesn't have an infrared filter, so you can use it together with an infrared light source to take pictures in the dark
+
+
diff --git a/af-ZA/step_3.md b/af-ZA/step_3.md
@@ -0,0 +1,48 @@
+## Connect the Camera Module
+
+**Ensure your Raspberry Pi is turned off.**
+
+--- no-print ---
+
+1. Locate the Camera Module port
+2. Gently pull up on the edges of the port's plastic clip
+3. Insert the Camera Module ribbon cable; make sure the connectors at the bottom of the ribbon cable are facing the contacts in the port.
+4. Push the plastic clip back into place
+
+![Animation showing a Raspberry Pi 4 with the camera clip closest to the USB port being opened, the camera ribbon cable being inserted, and the camera clip being closed again](images/connect-camera.gif)
+
+--- /no-print ---
+
+--- print-only ---
+
+1. Locate the Camera Module port.
+
+![Raspberry Pi 4 and camera module](images/connect-camera1.png)
+
+2. Gently pull up on the edges of the port's plastic clip.
+
+![camera module port lifted up](images/connect-camera2.png)
+
+3. Insert the Camera Module ribbon cable; make sure the connectors at the bottom of the ribbon cable are facing the contacts in the port.
+
+![camera module ribbon cable inserted into port](images/connect-camera3.png)
+
+4. Push the plastic clip back into place.
+
+![camera module port pushed down](images/connect-camera4.png)
+
+![camera module port pushed down](images/connect-camera4.png)
+
+--- /print-only ---
+
+- Start up your Raspberry Pi.
+
+- Go to the main menu and open the **Raspberry Pi Configuration** tool.
+
+    ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png)
+
+- Select the **Interfaces** tab and ensure that the camera is **enabled**:
+
+    ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png)
+
+- Reboot your Raspberry Pi.
diff --git a/af-ZA/step_4.md b/af-ZA/step_4.md
@@ -0,0 +1,41 @@
+## How to control the Camera Module via the command line
+
+Now your Camera Module is connected and the software is enabled, try out the command line tools `raspistill` and `raspivid`.
+
+- Open a terminal window by clicking the black monitor icon in the taskbar:
+
+![Open terminal](images/open-terminal-annotated.png)
+
+- Type in the following command to take a still picture and save it to the Desktop:
+
+```bash
+raspistill -o Desktop/image.jpg
+```
+
+![raspistill command entered into the terminal](images/raspistill-image.png)
+
+- Press <kbd>Enter</kbd> to run the command.
+
+When the command runs, you can see the camera preview open for five seconds before a still picture is taken.
+
+- Look for the picture file icon on the Desktop, and double-click the file icon to open the picture.
+
+    ![Image on Desktop](images/desktop-annotated.png)
+
+By adding different options, you can set the size and look of the image the `raspistill` command takes.
+
+- For example, add `-h` and `-w` to change the height and width of the image:
+
+```bash
+raspistill -o Desktop/image-small.jpg -w 640 -h 480
+```
+
+- Now record a video with the Camera Module by using the following `raspivid` command:
+
+```bash
+raspivid -o Desktop/video.h264
+```
+
+- In order to play the video file, double-click the `video.h264` file icon on the Desktop to open it in VLC Media Player.
+
+For more information and other options you can use with these commands, read the [documentation for raspistill](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) and the [documentation for raspivid](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md).
diff --git a/af-ZA/step_5.md b/af-ZA/step_5.md
@@ -0,0 +1,49 @@
+## How to control the Camera Module with Python code
+
+The Python `picamera` library allows you to control your Camera Module and create amazing projects.
+
+- Open a Python 3 editor, such as **Thonny Python IDE**:
+
+    ![Open Thonny](images/thonny-app-menu.png)
+
+- Open a new file and save it as `camera.py`.
+
+    **Note:** it's important that you **never save the file as `picamera.py`**.
+
+- Enter the following code:
+
+    ```python
+    from picamera import PiCamera
+    from time import sleep
+
+    camera = PiCamera()
+
+    camera.start_preview()
+    sleep(5)
+    camera.stop_preview()
+    ```
+
+- Save and run your program. The camera preview should be shown for five seconds and then close again.
+
+    ![Image preview](images/preview.jpg)
+
+    **Note:** the camera preview only works when a monitor is connected to your Raspberry Pi. If you are using remote access (such as SSH or VNC), you won't' see the camera preview.
+
+- If your preview is upside-down, you can rotate it by 180 degrees with the following code:
+
+    ```python
+    camera = PiCamera()
+    camera.rotation = 180
+    ```
+
+    You can rotate the image by `90`, `180`, or `270` degrees. To reset the image, set `rotation` to `0` degrees.
+
+It's best to make the preview slightly see-through so you can see whether errors occur in your program while the preview is on.
+
+- Make the camera preview see-through by setting an `alpha` level:
+
+    ```python
+    camera.start_preview(alpha=200)
+    ```
+
+    The `alpha` value can be any number between `0` and `255`.
diff --git a/af-ZA/step_6.md b/af-ZA/step_6.md
@@ -0,0 +1,38 @@
+## Take still pictures with Python code
+
+Now use the Camera Module and Python to take some still pictures.
+
+- Amend your code to add a `camera.capture()` line:
+
+    ```python
+    camera.start_preview()
+    sleep(5)
+    camera.capture('/home/pi/Desktop/image.jpg')
+    camera.stop_preview()
+    ```
+
+    **Note:** it's important to `sleep` for at least two seconds before capturing an image, because this gives the camera's sensor time to sense the light levels.
+
+- Run the code.
+
+You should see the camera preview open for five seconds, and then a still picture should be captured. As the picture is being taken, you can see the preview briefly adjust to a different resolution.
+
+Your new image should be saved to the Desktop.
+
+- Now add a loop to take five pictures in a row:
+
+    ```python
+    camera.start_preview()
+    for i in range(5):
+        sleep(5)
+        camera.capture('/home/pi/Desktop/image%s.jpg' % i)
+    camera.stop_preview()
+    ```
+
+    The variable `i` counts how many times the loop has run, from `0` to `4`. Therefore, the images get saved as `image0.jpg`, `image1.jpg`, and so on.
+
+- Run the code again and hold the Camera Module in position.
+
+The camera should take one picture every five seconds. Once the fifth picture is taken, the preview closes.
+
+- Look at your Desktop to find the five new pictures.
diff --git a/af-ZA/step_7.md b/af-ZA/step_7.md
@@ -0,0 +1,20 @@
+## Recording video with Python code
+
+Now record a video!
+
+- Amend your code to remove `capture()` and instead add `start_recording()` and `stop_recording()`
+
+    Your code should look like this now:
+
+    ```python
+    camera.start_preview()
+    camera.start_recording('/home/pi/Desktop/video.h264')
+    sleep(5)
+    camera.stop_recording()
+    camera.stop_preview()
+    ```
+
+- Run the code.
+
+Your Raspberry Pi should open a preview, record 5 seconds of video, and then close the preview.
+