diff --git a/af-ZA/images/Getting_Started_With_Picamera_TILE.png b/af-ZA/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/af-ZA/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/af-ZA/images/banner.png b/af-ZA/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/af-ZA/images/banner.png differ diff --git a/af-ZA/images/blur.jpg b/af-ZA/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/af-ZA/images/blur.jpg differ diff --git a/af-ZA/images/camera-module.png b/af-ZA/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/af-ZA/images/camera-module.png differ diff --git a/af-ZA/images/cartoon.jpg b/af-ZA/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/af-ZA/images/cartoon.jpg differ diff --git a/af-ZA/images/colorbalance.jpg b/af-ZA/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/af-ZA/images/colorbalance.jpg differ diff --git a/af-ZA/images/colorpoint.jpg b/af-ZA/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/af-ZA/images/colorpoint.jpg differ diff --git a/af-ZA/images/colorswap.jpg b/af-ZA/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/af-ZA/images/colorswap.jpg differ diff --git a/af-ZA/images/connect-camera-old.gif b/af-ZA/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/af-ZA/images/connect-camera-old.gif differ diff --git a/af-ZA/images/connect-camera.gif b/af-ZA/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/af-ZA/images/connect-camera.gif differ diff --git a/af-ZA/images/connect-camera.gif.gif b/af-ZA/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/af-ZA/images/connect-camera.gif.gif differ diff --git a/af-ZA/images/connect-camera1.png b/af-ZA/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/af-ZA/images/connect-camera1.png differ diff --git a/af-ZA/images/connect-camera2.png b/af-ZA/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/af-ZA/images/connect-camera2.png differ diff --git a/af-ZA/images/connect-camera3.png b/af-ZA/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/af-ZA/images/connect-camera3.png differ diff --git a/af-ZA/images/connect-camera4.png b/af-ZA/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/af-ZA/images/connect-camera4.png differ diff --git a/af-ZA/images/connect-camera5.png b/af-ZA/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/af-ZA/images/connect-camera5.png differ diff --git a/af-ZA/images/deinterlace1.jpg b/af-ZA/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/af-ZA/images/deinterlace1.jpg differ diff --git a/af-ZA/images/deinterlace2.jpg b/af-ZA/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/af-ZA/images/deinterlace2.jpg differ diff --git a/af-ZA/images/denoise.jpg b/af-ZA/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/af-ZA/images/denoise.jpg differ diff --git a/af-ZA/images/desktop-annotated.png b/af-ZA/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/af-ZA/images/desktop-annotated.png differ diff --git a/af-ZA/images/desktop.png b/af-ZA/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/af-ZA/images/desktop.png differ diff --git a/af-ZA/images/effects.jpg b/af-ZA/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/af-ZA/images/effects.jpg differ diff --git a/af-ZA/images/emboss.jpg b/af-ZA/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/af-ZA/images/emboss.jpg differ diff --git a/af-ZA/images/film.jpg b/af-ZA/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/af-ZA/images/film.jpg differ diff --git a/af-ZA/images/gpen.jpg b/af-ZA/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/af-ZA/images/gpen.jpg differ diff --git a/af-ZA/images/hatch.jpg b/af-ZA/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/af-ZA/images/hatch.jpg differ diff --git a/af-ZA/images/negative.jpg b/af-ZA/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/af-ZA/images/negative.jpg differ diff --git a/af-ZA/images/none.jpg b/af-ZA/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/af-ZA/images/none.jpg differ diff --git a/af-ZA/images/oilpaint.jpg b/af-ZA/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/af-ZA/images/oilpaint.jpg differ diff --git a/af-ZA/images/open-terminal-annotated.png b/af-ZA/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/af-ZA/images/open-terminal-annotated.png differ diff --git a/af-ZA/images/open-terminal.png b/af-ZA/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/af-ZA/images/open-terminal.png differ diff --git a/af-ZA/images/pastel.jpg b/af-ZA/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/af-ZA/images/pastel.jpg differ diff --git a/af-ZA/images/pi-camera-attached.jpg b/af-ZA/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/af-ZA/images/pi-camera-attached.jpg differ diff --git a/af-ZA/images/pi-configuration-interfaces-annotated.png b/af-ZA/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/af-ZA/images/pi-configuration-interfaces-annotated.png differ diff --git a/af-ZA/images/pi-configuration-interfaces.png b/af-ZA/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/af-ZA/images/pi-configuration-interfaces.png differ diff --git a/af-ZA/images/pi-configuration-menu.png b/af-ZA/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/af-ZA/images/pi-configuration-menu.png differ diff --git a/af-ZA/images/pi4-camera-port.png b/af-ZA/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/af-ZA/images/pi4-camera-port.png differ diff --git a/af-ZA/images/posterise.jpg b/af-ZA/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/af-ZA/images/posterise.jpg differ diff --git a/af-ZA/images/preview.jpg b/af-ZA/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/af-ZA/images/preview.jpg differ diff --git a/af-ZA/images/raspberry-pi.png b/af-ZA/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/af-ZA/images/raspberry-pi.png differ diff --git a/af-ZA/images/raspistill-help.png b/af-ZA/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/af-ZA/images/raspistill-help.png differ diff --git a/af-ZA/images/raspistill-image.png b/af-ZA/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/af-ZA/images/raspistill-image.png differ diff --git a/af-ZA/images/saturation.jpg b/af-ZA/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/af-ZA/images/saturation.jpg differ diff --git a/af-ZA/images/sketch.jpg b/af-ZA/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/af-ZA/images/sketch.jpg differ diff --git a/af-ZA/images/solarize.jpg b/af-ZA/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/af-ZA/images/solarize.jpg differ diff --git a/af-ZA/images/thonny-app-menu.png b/af-ZA/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/af-ZA/images/thonny-app-menu.png differ diff --git a/af-ZA/images/washedout.jpg b/af-ZA/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/af-ZA/images/washedout.jpg differ diff --git a/af-ZA/images/watercolor.jpg b/af-ZA/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/af-ZA/images/watercolor.jpg differ diff --git a/af-ZA/meta.yml b/af-ZA/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ 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 new file mode 100644 index 00000000..30c1849e --- /dev/null +++ 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 new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ 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 new file mode 100644 index 00000000..03212a50 --- /dev/null +++ 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 new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ 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 Enter 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 new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ 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`. \ No newline at end of file diff --git a/af-ZA/step_6.md b/af-ZA/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ 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. \ No newline at end of file diff --git a/af-ZA/step_7.md b/af-ZA/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ 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. + diff --git a/af-ZA/step_8.md b/af-ZA/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/af-ZA/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/af-ZA/step_9.md b/af-ZA/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/af-ZA/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/ar-SA/images/Getting_Started_With_Picamera_TILE.png b/ar-SA/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/ar-SA/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/ar-SA/images/banner.png b/ar-SA/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/ar-SA/images/banner.png differ diff --git a/ar-SA/images/blur.jpg b/ar-SA/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/ar-SA/images/blur.jpg differ diff --git a/ar-SA/images/camera-module.png b/ar-SA/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/ar-SA/images/camera-module.png differ diff --git a/ar-SA/images/cartoon.jpg b/ar-SA/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/ar-SA/images/cartoon.jpg differ diff --git a/ar-SA/images/colorbalance.jpg b/ar-SA/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/ar-SA/images/colorbalance.jpg differ diff --git a/ar-SA/images/colorpoint.jpg b/ar-SA/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/ar-SA/images/colorpoint.jpg differ diff --git a/ar-SA/images/colorswap.jpg b/ar-SA/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/ar-SA/images/colorswap.jpg differ diff --git a/ar-SA/images/connect-camera-old.gif b/ar-SA/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ar-SA/images/connect-camera-old.gif differ diff --git a/ar-SA/images/connect-camera.gif b/ar-SA/images/connect-camera.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ar-SA/images/connect-camera.gif differ diff --git a/ar-SA/images/connect-camera.gif.gif b/ar-SA/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ar-SA/images/connect-camera.gif.gif differ diff --git a/ar-SA/images/connect-camera1.png b/ar-SA/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/ar-SA/images/connect-camera1.png differ diff --git a/ar-SA/images/connect-camera2.png b/ar-SA/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/ar-SA/images/connect-camera2.png differ diff --git a/ar-SA/images/connect-camera3.png b/ar-SA/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/ar-SA/images/connect-camera3.png differ diff --git a/ar-SA/images/connect-camera4.png b/ar-SA/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/ar-SA/images/connect-camera4.png differ diff --git a/ar-SA/images/connect-camera5.png b/ar-SA/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/ar-SA/images/connect-camera5.png differ diff --git a/ar-SA/images/deinterlace1.jpg b/ar-SA/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/ar-SA/images/deinterlace1.jpg differ diff --git a/ar-SA/images/deinterlace2.jpg b/ar-SA/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/ar-SA/images/deinterlace2.jpg differ diff --git a/ar-SA/images/denoise.jpg b/ar-SA/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/ar-SA/images/denoise.jpg differ diff --git a/ar-SA/images/desktop-annotated.png b/ar-SA/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/ar-SA/images/desktop-annotated.png differ diff --git a/ar-SA/images/desktop.png b/ar-SA/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/ar-SA/images/desktop.png differ diff --git a/ar-SA/images/effects.jpg b/ar-SA/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/ar-SA/images/effects.jpg differ diff --git a/ar-SA/images/emboss.jpg b/ar-SA/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/ar-SA/images/emboss.jpg differ diff --git a/ar-SA/images/film.jpg b/ar-SA/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/ar-SA/images/film.jpg differ diff --git a/ar-SA/images/gpen.jpg b/ar-SA/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/ar-SA/images/gpen.jpg differ diff --git a/ar-SA/images/hatch.jpg b/ar-SA/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/ar-SA/images/hatch.jpg differ diff --git a/ar-SA/images/negative.jpg b/ar-SA/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/ar-SA/images/negative.jpg differ diff --git a/ar-SA/images/none.jpg b/ar-SA/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/ar-SA/images/none.jpg differ diff --git a/ar-SA/images/oilpaint.jpg b/ar-SA/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/ar-SA/images/oilpaint.jpg differ diff --git a/ar-SA/images/open-terminal-annotated.png b/ar-SA/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/ar-SA/images/open-terminal-annotated.png differ diff --git a/ar-SA/images/open-terminal.png b/ar-SA/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/ar-SA/images/open-terminal.png differ diff --git a/ar-SA/images/pastel.jpg b/ar-SA/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/ar-SA/images/pastel.jpg differ diff --git a/ar-SA/images/pi-camera-attached.jpg b/ar-SA/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/ar-SA/images/pi-camera-attached.jpg differ diff --git a/ar-SA/images/pi-configuration-interfaces-annotated.png b/ar-SA/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/ar-SA/images/pi-configuration-interfaces-annotated.png differ diff --git a/ar-SA/images/pi-configuration-interfaces.png b/ar-SA/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/ar-SA/images/pi-configuration-interfaces.png differ diff --git a/ar-SA/images/pi-configuration-menu.png b/ar-SA/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/ar-SA/images/pi-configuration-menu.png differ diff --git a/ar-SA/images/pi4-camera-port.png b/ar-SA/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/ar-SA/images/pi4-camera-port.png differ diff --git a/ar-SA/images/posterise.jpg b/ar-SA/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/ar-SA/images/posterise.jpg differ diff --git a/ar-SA/images/preview.jpg b/ar-SA/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/ar-SA/images/preview.jpg differ diff --git a/ar-SA/images/raspberry-pi.png b/ar-SA/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/ar-SA/images/raspberry-pi.png differ diff --git a/ar-SA/images/raspistill-help.png b/ar-SA/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/ar-SA/images/raspistill-help.png differ diff --git a/ar-SA/images/raspistill-image.png b/ar-SA/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/ar-SA/images/raspistill-image.png differ diff --git a/ar-SA/images/saturation.jpg b/ar-SA/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/ar-SA/images/saturation.jpg differ diff --git a/ar-SA/images/sketch.jpg b/ar-SA/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/ar-SA/images/sketch.jpg differ diff --git a/ar-SA/images/solarize.jpg b/ar-SA/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/ar-SA/images/solarize.jpg differ diff --git a/ar-SA/images/thonny-app-menu.png b/ar-SA/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/ar-SA/images/thonny-app-menu.png differ diff --git a/ar-SA/images/washedout.jpg b/ar-SA/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/ar-SA/images/washedout.jpg differ diff --git a/ar-SA/images/watercolor.jpg b/ar-SA/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/ar-SA/images/watercolor.jpg differ diff --git a/ar-SA/meta.yml b/ar-SA/meta.yml new file mode 100644 index 00000000..0c34713f --- /dev/null +++ b/ar-SA/meta.yml @@ -0,0 +1,31 @@ +--- +title: البدء مع وحدة الكاميرا +hero_image: images/banner.png +description: التقاط صور ومقاطع فيديو باستخدام وحدة كاميرا Raspberry Pi و Python +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: المقدمة + - + title: ماذا ستحتاج + - + title: قم بتوصيل وحدة الكاميرا + - + title: كيفية التحكم في وحدة الكاميرا بواسطة سطر الأوامر + completion: + - engaged + - + title: كيفية التحكم في وحدة الكاميرا باستخدام التعليمات البرمجية بلغة Python + - + title: التقط صورًا ثابتة باستخدام التعليمات البرمجية بلغة Python + - + title: تسجيل فيديو باستخدام التعليمات البرمجية بلغة Python + - + title: كيفية تغيير إعدادات الصورة وإضافة تأثيرات الى الصورة + completion: + - internal + - + title: ما التالي؟ diff --git a/ar-SA/step_1.md b/ar-SA/step_1.md new file mode 100644 index 00000000..86155ae9 --- /dev/null +++ b/ar-SA/step_1.md @@ -0,0 +1,9 @@ +## مقدمة + +[[[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/ar-SA/step_2.md b/ar-SA/step_2.md new file mode 100644 index 00000000..73cb4cd1 --- /dev/null +++ b/ar-SA/step_2.md @@ -0,0 +1,20 @@ +## ماذا ستحتاج + +### جهاز كمبيوتر Raspberry Pi مع منفذ وحدة الكاميرا + +جميع النماذج الحالية لـ Raspberry Pi لديها منفذ لربط وحدة الكاميرا. + +![جهاز +Raspberry Pi 3B مع منفذ وحده كاميرا مسمى](images/pi4-camera-port.png) + +**ملاحظة:** إذا كنت ترغب في استخدام Raspberry Pi Zero، تحتاج إلى كابل ذو شريط خاص بوحده الكاميرا يكون حجمه مناسب لمنفذ كاميرا Raspberry Pi Zero صغير الحجم. + +### وحدة كاميرا Raspberry Pi + +![وحدة كاميرا Raspberry Pi](images/camera-module.png) + +هناك نسختان من وحدة الكاميرا: + +* [الإصدار القياسي](https://www.raspberrypi.org/products/camera-module-v2/)، الذي صمم لالتقاط الصور في ضوء عادي +* [إصدار NoIR](https://www.raspberrypi.org/products/pi-noir-camera-v2/)، الذي ليس لديه فلتر بالأشعة تحت الحمراء، لتتمكن من استخدامه مع مصدر ضوء الأشعة تحت الحمراء لالتقاط الصور في الظلام + + diff --git a/ar-SA/step_3.md b/ar-SA/step_3.md new file mode 100644 index 00000000..ddc6d902 --- /dev/null +++ b/ar-SA/step_3.md @@ -0,0 +1,48 @@ +## قم بتوصيل وحدة الكاميرا + +**تأكد من إيقاف تشغيل Raspberry Pi.** + +--- no-print --- + +1. حدد موقع منفذ وحدة الكاميرا +2. اسحب حواف مشابك المنفذ البلاستيكيه برفق الى الاعلى +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. اضغط المشبك البلاستيكي و ارجعه لمكانه القديم + +![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. حدد موقع منفذ وحدة الكاميرا. + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. اسحب حواف مشابك المنفذ البلاستيكيه برفق الى الاعلى. + +![منفذ وحدة الكاميرا مرفوع للاعلى](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. + +![كابل ذو شريط خاص بوحدة الكاميرا تم ادخاله في المنفذ](images/connect-camera3.png) + +4. اضغط المشبك البلاستيكي و ارجعه لمكانه القديم. + +![camera module port pushed down](images/connect-camera4.png) + +![camera module port pushed down](images/connect-camera4.png) + +--- /print-only --- + +- شغل جهاز Raspberry Pi الخاص بك. + +- اذهب إلى القائمة الرئيسية وافتح أداة **Raspberry Pi Conconfigation**. + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- حدد علامة التبويب **واجهات** وتأكد من أن الكاميرا **مفعلة**: + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- أعد تشغيل Raspberry Pi الخاص بك. diff --git a/ar-SA/step_4.md b/ar-SA/step_4.md new file mode 100644 index 00000000..5d006306 --- /dev/null +++ b/ar-SA/step_4.md @@ -0,0 +1,41 @@ +## كيفية التحكم في وحدة الكاميرا بواسطة سطر الأوامر + +الآن وحدة الكاميرا الخاصة بك متصلة والبرمجيات مفعلة، جرب أدوات سطر الأوامر `raspistill` و `raspivid`. + +- افتح نافذة طرفية بالنقر على أيقونة الشاشة السوداء في شريط المهام: + +![افتح الوحدة الطرفية](images/open-terminal-annotated.png) + +- اكتب الأمر التالي لالتقاط صورة ثابتة وحفظها على سطح المكتب: + +```bash +raspistill -o Desktop/image.jpg +``` + +![تم إدخال أمر raspistill الى المحطة الطرفية](images/raspistill-image.png) + +- اضغط على Enter لتشغيل الأمر. + +عند تشغيل الأمر ، يمكنك مشاهدة معاينة الكاميرا مفتوحة لمدة خمس ثوان قبل التقاط صورة ثابتة. + +- ابحث عن أيقونة ملف الصورة على سطح المكتب، وانقر مرتين على أيقونة الملف لفتح الصورة. + + ![الصورة على سطح المكتب](images/desktop-annotated.png) + +بإضافة خيارات مختلفة ، يمكنك ضبط حجم ومظهر الصورة التي يأخذها الأمر `raspistill`. + +- على سبيل المثال، أضف `-h` و `-w` لتغيير ارتفاع وعرض الصورة: + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- الآن قم بتسجيل فيديو باستخدام وحدة الكاميرا باستخدام الأمر التالي `raspivid`: + +```bash +raspivid -o Desktop/video.h264 +``` + +- لتشغيل ملف الفيديو ، انقر نقرًا مزدوجًا فوق أيقونة الملف `video.h264` على سطح المكتب لفتحه في VLC Media Player. + +لمزيد من المعلومات والخيارات الأخرى التي يمكنك استخدامها مع هذه الأوامر ، اقرأ الوثائق التعليمية [لـ raspistill](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) و [الوثائق التعليمية raspivid](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md). diff --git a/ar-SA/step_5.md b/ar-SA/step_5.md new file mode 100644 index 00000000..e789b3e0 --- /dev/null +++ b/ar-SA/step_5.md @@ -0,0 +1,49 @@ +## كيفية التحكم في وحدة الكاميرا باستخدام التعليمات البرمجية بلغة Python + +تتيح لك مكتبة Python `picamera` التحكم في وحدة الكاميرا الخاصة بك وإنشاء مشاريع مذهلة. + +- افتح محرر Python 3 ، مثل **Thonny Python IDE**: + + ![افتح Thonny](images/thonny-app-menu.png) + +- أفتح ملف جديد واحفظه باسم `camera.py`. + + **ملاحظة:** من المهم أن **لا تحفظ الملف بأسم `picamera.py`**. + +- أدخل الأمر التالي: + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- احفظ برنامجك وقم بتشغيله. من المفترض أن تظهر معاينة الكاميرا لمدة خمس ثوان ثم تغلق مرة أخرى. + + ![معاينة الصورة](images/preview.jpg) + + **ملاحظة:** تعمل معاينة الكاميرا فقط عندما تكون الشاشة متصلة بـ Raspberry Pi. إذا كنت تستخدم الوصول عن بعد (مثل SSH أو VNC) ، فلن ترى معاينة الكاميرا. + +- إذا كانت المعاينة مقلوبة ، فيمكنك تدويرها بمقدار 180 درجة باستخدام التعليمة البرمجية التالية: + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + يمكنك تدوير الصورة بمقدار `90`، `180`، أو `270` درجة. لإعادة ضبط الصورة ، اضبط `استدارة` إلى `0` درجة. + +من الأفضل جعل المعاينة شفافة قليلاً لتتمكن من رؤية فيما إذا كانت هنالك أخطاء تحدث في برنامجك أثناء تشغيل المعاينة. + +- اجعل معاينة الكاميرا شفافة من خلال ضبط مستوى `alpha`: + + ```python + camera.start_preview(alpha=200) + ``` + + قيمة `alpha` يمكن أن تكون أي رقم بين `0` و `255`. \ No newline at end of file diff --git a/ar-SA/step_6.md b/ar-SA/step_6.md new file mode 100644 index 00000000..b11fc406 --- /dev/null +++ b/ar-SA/step_6.md @@ -0,0 +1,38 @@ +## التقط صورًا ثابتة باستخدام التعليمات البرمجية بلغة Python + +الآن استخدم وحدة الكاميرا و Python لألتقاط بعض الصور الثابتة. + +- قم بتعديل التعليمة البرمجية الخاصة بك بإضافة سطر `()camera.capture`: + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **ملاحظة:** من المهم `السكون` لمدة ثانيتين على الأقل قبل التقاط صورة، لأن هذا يمنح مستشعر الكاميرا وقتا لاستشعار مستويات الضوء. + +- قم بتشغيل التعليمة البرمجية. + +يجب أن تشاهد معاينة الكاميرا مفتوحة لمدة خمس ثوانٍ، ثم يجب أن تُلتَقَط صورة ثابتة. أثناء التقاط الصورة ، يمكنك رؤية المعاينة وهي تتكيف لفترة وجيزة مع دقة مختلفة. + +صورتك الجديدة يجب أن تكون قد حُفظت على سطح المكتب. + +- الآن أضف حلقة تكرارية لألتقاط خمس صور متتالية: + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + المتغير `i` يحسب عدد مرات تشغيل الحلقة ، من `0` إلى `4`. لذلك ، يتم حفظ الصور كالتالي `image0.jpg`، `image1.jpg`، وهكذا. + +- قم بتشغيل التعليمة البرمجية مرة أخرى واحتفظ بوحدة الكاميرا في موضعها. + +يجب أن تلتقط الكاميرا صورة واحدة كل خمس ثوان. بمجرد التقاط الصورة الخامسة ، تغلق المعاينة. + +- انظر إلى سطح مكتبك للعثور على الصور الخمس الجديدة. \ No newline at end of file diff --git a/ar-SA/step_7.md b/ar-SA/step_7.md new file mode 100644 index 00000000..6eb76d4d --- /dev/null +++ b/ar-SA/step_7.md @@ -0,0 +1,20 @@ +## تسجيل فيديو باستخدام التعليمات البرمجية بلغة Python + +الآن سجل فيديو! + +- قم بتعديل التعليمة البرمجية الخاصة بك لإزالة `capture()` وبدلا من ذلك أضف `start_recording ()` و `stop_recording ()` + + يجب الآن أن تبدو التعليمة البرمجية الخاصة بك مثل هذه: + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- قم بتشغيل التعليمة البرمجية. + +يجب أن يفتح Raspberry Pi معاينة ، ويسجل 5 ثوانٍ من الفيديو ، ثم يغلق المعاينة. + diff --git a/ar-SA/step_8.md b/ar-SA/step_8.md new file mode 100644 index 00000000..2b20ae5d --- /dev/null +++ b/ar-SA/step_8.md @@ -0,0 +1,228 @@ +## كيفية تغيير إعدادات الصورة وإضافة تأثيرات الى الصورة + +يوفر برنامج Python `picamera` عددًا من التأثيرات والإعدادات لتغيير شكل صورك. + +**ملاحظة:** بعض الإعدادات تؤثر فقط على المعاينة وليس على الصورة الملتقطة ، بعضها يؤثر فقط على الصورة الملتقطة ، والعديد من الإعدادات الأخرى تؤثر على كليهما. + +### أضبط دقة الصورة + +يمكنك تغيير دقة `` الصورة التي تلتقطها وحدة الكاميرا. + +بشكل افتراضي ، يتم ضبط دقة الصورة بناءً على دقة شاشتك. الحد الأقصى للدقة هو 2592×1944 للصور الثابتة، و 1920×1080 لتسجيل الفيديو. + +- استخدم الكود التالي لتعيين الدقة `` إلى الحد الأقصى والتقاط صورة. + + **ملاحظة:** تحتاج أيضًا إلى ضبط معدل الإطارات على `15` لتمكين الحد الأقصى من الدقة. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +الحد الأدنى للدقة هو 64 × 64. + +- حاول التقاط صورة بأقل دقة ممكنة. + +### أضف نصًا إلى صورتك + +يمكنك إضافة نص إلى صورتك باستخدام الأمر `annotate_text`. + +- قم بتشغيل هذه التعليمة البرمجية لتجربتها: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### غَيِر مظهر النص المضاف + +- اضبط حجم النص من خلال التعليمة البرمجية التالية: + + ```python + camera.annotate_text_size = 50 + ``` + + يمكنك ضبط حجم النص إلى أي حجم بين `6` و `160`. الحجم الافتراضي هو `32`. + +من الممكن أيضًا تغيير لون النص. + +- أولا وقبل كل شيء، أضف `Color` إلى سطر ال `import` في الجزء العلوي من البرنامج: + + ```python + from picamera import PiCamera, Color + ``` + +- ثم أسفل سطر `import` ، قم بتعديل بقية التعليمة البرمجية الخاصة بك بحيث تبدو كالتالي: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### غَيِر سطوع المعاينة + +يمكنك تغيير مدى السطوع الذي تظهر به المعاينة. السطوع الافتراضي هو `50`، ويمكنك ضبطه على أي قيمة بين `0` و `100`. + +* قم بتشغيل التعليمة البرمجية التالية لتجربة ذلك: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- الحلقة التكرارية التالية تضبط السطوع وتضيف أيضًا نصًا لعرض مستوى السطوع الحالي: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### غَيِر تباين المعاينة + +على غرار سطوع المعاينة، يمكنك تغيير تباين المعاينة. + +- قم بتشغيل الكود التالي لتجربة ذلك: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### أضف تأثيرات صور رائعة + +يمكنك استخدام `camera.image_effect` لتطبيق تأثير صورة معين. + +خيارات تأثير الصورة هي: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +التأثير الافتراضي هو `none`. + +* اختر تأثير الصورة وجربه: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* قم بتشغيل هذه التعليمة البرمجية كحلقة تكرارية على **جميع** تأثيرات الصورة بأستخدام `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![تأثيرات](images/effects.jpg) + +### اضبط وضع تعرض الصورة + +يمكنك استخدام `camera.exposure_mode` لضبط التعرض إلى وضع معين. + +خيارات وضع التعرض هي: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +الوضع الافتراضي هو `auto`. + +* اختر وضع التعرض و جربه: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* يمكنك عمل حلقة تكرارية على جميع أوضاع التعرض باستخدام `camera.EXPOSURE_MODES`, كما فعلت لتأثيرات الصورة. + +### قم بتغيير توازن بياض الصورة + +يمكنك استخدام `camera.awb_mode` لضبط توازن اللون الأبيض التلقائي على الوضع المحدد مسبقًا. + +أوضاع توازن البياض التلقائي المتاحة هي: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +الافتراضي هو `auto`. + +* اختر وضع توازن اللون الأبيض التلقائي وجربه: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* يمكنك عمل حلقة تكرارية على جميع أوضاع توازن اللون الأبيض التلقائي باستخدام `camera.AWB_MODES` كما فعلت مع تأثيرات الصورة. \ No newline at end of file diff --git a/ar-SA/step_9.md b/ar-SA/step_9.md new file mode 100644 index 00000000..13710538 --- /dev/null +++ b/ar-SA/step_9.md @@ -0,0 +1,17 @@ +## ما التالي؟ + +الآن أنت تعرف كيفية استخدام وحدة الكاميرا الخاصة بك، يمكنك على سبيل المثال: +* إضافة أزرار للتحكم في الكاميرا بمساعدة [GPIO Zero](https://gpiozero.readthedocs.org/) التعليمة البرمجية في Python +* دمج الكاميرا مع Minecraft Pi +* نشر صور الكاميرا على تويتر تلقائياً + +جرب مشاريع وحدة الكاميرا هذه لمعرفة المزيد: + +- إنشاء فلم [أضغط على زر توقف الحركة](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) +- صنع [كشك تصوير Minecraft](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- احصل على [دب Babbage للتغريد بالصور](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- بناء [كاشف الوالدين](https://projects.raspberrypi.org/en/projects/parent-detector/) +- استخدم وحدة الكاميرا NoIR لإنشاء [صندوق طائر يعمل بالأشعة تحت الحمراء](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +لمزيد من المعلومات حول كتابة التعليمات البرمجية بلغة Python للتحكم في وحدة الكاميرا، راجع وثائق [picamera الموسعة](https://picamera.readthedocs.org/). + diff --git a/ca-ES/images/Getting_Started_With_Picamera_TILE.png b/ca-ES/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/ca-ES/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/ca-ES/images/banner.png b/ca-ES/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/ca-ES/images/banner.png differ diff --git a/ca-ES/images/blur.jpg b/ca-ES/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/ca-ES/images/blur.jpg differ diff --git a/ca-ES/images/camera-module.png b/ca-ES/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/ca-ES/images/camera-module.png differ diff --git a/ca-ES/images/cartoon.jpg b/ca-ES/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/ca-ES/images/cartoon.jpg differ diff --git a/ca-ES/images/colorbalance.jpg b/ca-ES/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/ca-ES/images/colorbalance.jpg differ diff --git a/ca-ES/images/colorpoint.jpg b/ca-ES/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/ca-ES/images/colorpoint.jpg differ diff --git a/ca-ES/images/colorswap.jpg b/ca-ES/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/ca-ES/images/colorswap.jpg differ diff --git a/ca-ES/images/connect-camera-old.gif b/ca-ES/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ca-ES/images/connect-camera-old.gif differ diff --git a/ca-ES/images/connect-camera.gif b/ca-ES/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ca-ES/images/connect-camera.gif differ diff --git a/ca-ES/images/connect-camera.gif.gif b/ca-ES/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ca-ES/images/connect-camera.gif.gif differ diff --git a/ca-ES/images/connect-camera1.png b/ca-ES/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/ca-ES/images/connect-camera1.png differ diff --git a/ca-ES/images/connect-camera2.png b/ca-ES/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/ca-ES/images/connect-camera2.png differ diff --git a/ca-ES/images/connect-camera3.png b/ca-ES/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/ca-ES/images/connect-camera3.png differ diff --git a/ca-ES/images/connect-camera4.png b/ca-ES/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/ca-ES/images/connect-camera4.png differ diff --git a/ca-ES/images/connect-camera5.png b/ca-ES/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/ca-ES/images/connect-camera5.png differ diff --git a/ca-ES/images/deinterlace1.jpg b/ca-ES/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/ca-ES/images/deinterlace1.jpg differ diff --git a/ca-ES/images/deinterlace2.jpg b/ca-ES/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/ca-ES/images/deinterlace2.jpg differ diff --git a/ca-ES/images/denoise.jpg b/ca-ES/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/ca-ES/images/denoise.jpg differ diff --git a/ca-ES/images/desktop-annotated.png b/ca-ES/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/ca-ES/images/desktop-annotated.png differ diff --git a/ca-ES/images/desktop.png b/ca-ES/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/ca-ES/images/desktop.png differ diff --git a/ca-ES/images/effects.jpg b/ca-ES/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/ca-ES/images/effects.jpg differ diff --git a/ca-ES/images/emboss.jpg b/ca-ES/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/ca-ES/images/emboss.jpg differ diff --git a/ca-ES/images/film.jpg b/ca-ES/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/ca-ES/images/film.jpg differ diff --git a/ca-ES/images/gpen.jpg b/ca-ES/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/ca-ES/images/gpen.jpg differ diff --git a/ca-ES/images/hatch.jpg b/ca-ES/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/ca-ES/images/hatch.jpg differ diff --git a/ca-ES/images/negative.jpg b/ca-ES/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/ca-ES/images/negative.jpg differ diff --git a/ca-ES/images/none.jpg b/ca-ES/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/ca-ES/images/none.jpg differ diff --git a/ca-ES/images/oilpaint.jpg b/ca-ES/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/ca-ES/images/oilpaint.jpg differ diff --git a/ca-ES/images/open-terminal-annotated.png b/ca-ES/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/ca-ES/images/open-terminal-annotated.png differ diff --git a/ca-ES/images/open-terminal.png b/ca-ES/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/ca-ES/images/open-terminal.png differ diff --git a/ca-ES/images/pastel.jpg b/ca-ES/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/ca-ES/images/pastel.jpg differ diff --git a/ca-ES/images/pi-camera-attached.jpg b/ca-ES/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/ca-ES/images/pi-camera-attached.jpg differ diff --git a/ca-ES/images/pi-configuration-interfaces-annotated.png b/ca-ES/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/ca-ES/images/pi-configuration-interfaces-annotated.png differ diff --git a/ca-ES/images/pi-configuration-interfaces.png b/ca-ES/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/ca-ES/images/pi-configuration-interfaces.png differ diff --git a/ca-ES/images/pi-configuration-menu.png b/ca-ES/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/ca-ES/images/pi-configuration-menu.png differ diff --git a/ca-ES/images/pi4-camera-port.png b/ca-ES/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/ca-ES/images/pi4-camera-port.png differ diff --git a/ca-ES/images/posterise.jpg b/ca-ES/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/ca-ES/images/posterise.jpg differ diff --git a/ca-ES/images/preview.jpg b/ca-ES/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/ca-ES/images/preview.jpg differ diff --git a/ca-ES/images/raspberry-pi.png b/ca-ES/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/ca-ES/images/raspberry-pi.png differ diff --git a/ca-ES/images/raspistill-help.png b/ca-ES/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/ca-ES/images/raspistill-help.png differ diff --git a/ca-ES/images/raspistill-image.png b/ca-ES/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/ca-ES/images/raspistill-image.png differ diff --git a/ca-ES/images/saturation.jpg b/ca-ES/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/ca-ES/images/saturation.jpg differ diff --git a/ca-ES/images/sketch.jpg b/ca-ES/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/ca-ES/images/sketch.jpg differ diff --git a/ca-ES/images/solarize.jpg b/ca-ES/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/ca-ES/images/solarize.jpg differ diff --git a/ca-ES/images/thonny-app-menu.png b/ca-ES/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/ca-ES/images/thonny-app-menu.png differ diff --git a/ca-ES/images/washedout.jpg b/ca-ES/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/ca-ES/images/washedout.jpg differ diff --git a/ca-ES/images/watercolor.jpg b/ca-ES/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/ca-ES/images/watercolor.jpg differ diff --git a/ca-ES/meta.yml b/ca-ES/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/ca-ES/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/ca-ES/step_1.md b/ca-ES/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/ca-ES/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/ca-ES/step_2.md b/ca-ES/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/ca-ES/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/ca-ES/step_3.md b/ca-ES/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/ca-ES/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/ca-ES/step_4.md b/ca-ES/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/ca-ES/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 Enter 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/ca-ES/step_5.md b/ca-ES/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/ca-ES/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`. \ No newline at end of file diff --git a/ca-ES/step_6.md b/ca-ES/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/ca-ES/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. \ No newline at end of file diff --git a/ca-ES/step_7.md b/ca-ES/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/ca-ES/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. + diff --git a/ca-ES/step_8.md b/ca-ES/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/ca-ES/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/ca-ES/step_9.md b/ca-ES/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/ca-ES/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/cs-CZ/images/Getting_Started_With_Picamera_TILE.png b/cs-CZ/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/cs-CZ/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/cs-CZ/images/banner.png b/cs-CZ/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/cs-CZ/images/banner.png differ diff --git a/cs-CZ/images/blur.jpg b/cs-CZ/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/cs-CZ/images/blur.jpg differ diff --git a/cs-CZ/images/camera-module.png b/cs-CZ/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/cs-CZ/images/camera-module.png differ diff --git a/cs-CZ/images/cartoon.jpg b/cs-CZ/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/cs-CZ/images/cartoon.jpg differ diff --git a/cs-CZ/images/colorbalance.jpg b/cs-CZ/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/cs-CZ/images/colorbalance.jpg differ diff --git a/cs-CZ/images/colorpoint.jpg b/cs-CZ/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/cs-CZ/images/colorpoint.jpg differ diff --git a/cs-CZ/images/colorswap.jpg b/cs-CZ/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/cs-CZ/images/colorswap.jpg differ diff --git a/cs-CZ/images/connect-camera-old.gif b/cs-CZ/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/cs-CZ/images/connect-camera-old.gif differ diff --git a/cs-CZ/images/connect-camera.gif b/cs-CZ/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/cs-CZ/images/connect-camera.gif differ diff --git a/cs-CZ/images/connect-camera.gif.gif b/cs-CZ/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/cs-CZ/images/connect-camera.gif.gif differ diff --git a/cs-CZ/images/connect-camera1.png b/cs-CZ/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/cs-CZ/images/connect-camera1.png differ diff --git a/cs-CZ/images/connect-camera2.png b/cs-CZ/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/cs-CZ/images/connect-camera2.png differ diff --git a/cs-CZ/images/connect-camera3.png b/cs-CZ/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/cs-CZ/images/connect-camera3.png differ diff --git a/cs-CZ/images/connect-camera4.png b/cs-CZ/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/cs-CZ/images/connect-camera4.png differ diff --git a/cs-CZ/images/connect-camera5.png b/cs-CZ/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/cs-CZ/images/connect-camera5.png differ diff --git a/cs-CZ/images/deinterlace1.jpg b/cs-CZ/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/cs-CZ/images/deinterlace1.jpg differ diff --git a/cs-CZ/images/deinterlace2.jpg b/cs-CZ/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/cs-CZ/images/deinterlace2.jpg differ diff --git a/cs-CZ/images/denoise.jpg b/cs-CZ/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/cs-CZ/images/denoise.jpg differ diff --git a/cs-CZ/images/desktop-annotated.png b/cs-CZ/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/cs-CZ/images/desktop-annotated.png differ diff --git a/cs-CZ/images/desktop.png b/cs-CZ/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/cs-CZ/images/desktop.png differ diff --git a/cs-CZ/images/effects.jpg b/cs-CZ/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/cs-CZ/images/effects.jpg differ diff --git a/cs-CZ/images/emboss.jpg b/cs-CZ/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/cs-CZ/images/emboss.jpg differ diff --git a/cs-CZ/images/film.jpg b/cs-CZ/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/cs-CZ/images/film.jpg differ diff --git a/cs-CZ/images/gpen.jpg b/cs-CZ/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/cs-CZ/images/gpen.jpg differ diff --git a/cs-CZ/images/hatch.jpg b/cs-CZ/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/cs-CZ/images/hatch.jpg differ diff --git a/cs-CZ/images/negative.jpg b/cs-CZ/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/cs-CZ/images/negative.jpg differ diff --git a/cs-CZ/images/none.jpg b/cs-CZ/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/cs-CZ/images/none.jpg differ diff --git a/cs-CZ/images/oilpaint.jpg b/cs-CZ/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/cs-CZ/images/oilpaint.jpg differ diff --git a/cs-CZ/images/open-terminal-annotated.png b/cs-CZ/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/cs-CZ/images/open-terminal-annotated.png differ diff --git a/cs-CZ/images/open-terminal.png b/cs-CZ/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/cs-CZ/images/open-terminal.png differ diff --git a/cs-CZ/images/pastel.jpg b/cs-CZ/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/cs-CZ/images/pastel.jpg differ diff --git a/cs-CZ/images/pi-camera-attached.jpg b/cs-CZ/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/cs-CZ/images/pi-camera-attached.jpg differ diff --git a/cs-CZ/images/pi-configuration-interfaces-annotated.png b/cs-CZ/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/cs-CZ/images/pi-configuration-interfaces-annotated.png differ diff --git a/cs-CZ/images/pi-configuration-interfaces.png b/cs-CZ/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/cs-CZ/images/pi-configuration-interfaces.png differ diff --git a/cs-CZ/images/pi-configuration-menu.png b/cs-CZ/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/cs-CZ/images/pi-configuration-menu.png differ diff --git a/cs-CZ/images/pi4-camera-port.png b/cs-CZ/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/cs-CZ/images/pi4-camera-port.png differ diff --git a/cs-CZ/images/posterise.jpg b/cs-CZ/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/cs-CZ/images/posterise.jpg differ diff --git a/cs-CZ/images/preview.jpg b/cs-CZ/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/cs-CZ/images/preview.jpg differ diff --git a/cs-CZ/images/raspberry-pi.png b/cs-CZ/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/cs-CZ/images/raspberry-pi.png differ diff --git a/cs-CZ/images/raspistill-help.png b/cs-CZ/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/cs-CZ/images/raspistill-help.png differ diff --git a/cs-CZ/images/raspistill-image.png b/cs-CZ/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/cs-CZ/images/raspistill-image.png differ diff --git a/cs-CZ/images/saturation.jpg b/cs-CZ/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/cs-CZ/images/saturation.jpg differ diff --git a/cs-CZ/images/sketch.jpg b/cs-CZ/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/cs-CZ/images/sketch.jpg differ diff --git a/cs-CZ/images/solarize.jpg b/cs-CZ/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/cs-CZ/images/solarize.jpg differ diff --git a/cs-CZ/images/thonny-app-menu.png b/cs-CZ/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/cs-CZ/images/thonny-app-menu.png differ diff --git a/cs-CZ/images/washedout.jpg b/cs-CZ/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/cs-CZ/images/washedout.jpg differ diff --git a/cs-CZ/images/watercolor.jpg b/cs-CZ/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/cs-CZ/images/watercolor.jpg differ diff --git a/cs-CZ/meta.yml b/cs-CZ/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/cs-CZ/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/cs-CZ/step_1.md b/cs-CZ/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/cs-CZ/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/cs-CZ/step_2.md b/cs-CZ/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/cs-CZ/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/cs-CZ/step_3.md b/cs-CZ/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/cs-CZ/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/cs-CZ/step_4.md b/cs-CZ/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/cs-CZ/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 Enter 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/cs-CZ/step_5.md b/cs-CZ/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/cs-CZ/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`. \ No newline at end of file diff --git a/cs-CZ/step_6.md b/cs-CZ/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/cs-CZ/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. \ No newline at end of file diff --git a/cs-CZ/step_7.md b/cs-CZ/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/cs-CZ/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. + diff --git a/cs-CZ/step_8.md b/cs-CZ/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/cs-CZ/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/cs-CZ/step_9.md b/cs-CZ/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/cs-CZ/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/cy-GB/images/Getting_Started_With_Picamera_TILE.png b/cy-GB/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/cy-GB/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/cy-GB/images/banner.png b/cy-GB/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/cy-GB/images/banner.png differ diff --git a/cy-GB/images/blur.jpg b/cy-GB/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/cy-GB/images/blur.jpg differ diff --git a/cy-GB/images/camera-module.png b/cy-GB/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/cy-GB/images/camera-module.png differ diff --git a/cy-GB/images/cartoon.jpg b/cy-GB/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/cy-GB/images/cartoon.jpg differ diff --git a/cy-GB/images/colorbalance.jpg b/cy-GB/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/cy-GB/images/colorbalance.jpg differ diff --git a/cy-GB/images/colorpoint.jpg b/cy-GB/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/cy-GB/images/colorpoint.jpg differ diff --git a/cy-GB/images/colorswap.jpg b/cy-GB/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/cy-GB/images/colorswap.jpg differ diff --git a/cy-GB/images/connect-camera-old.gif b/cy-GB/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/cy-GB/images/connect-camera-old.gif differ diff --git a/cy-GB/images/connect-camera.gif b/cy-GB/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/cy-GB/images/connect-camera.gif differ diff --git a/cy-GB/images/connect-camera.gif.gif b/cy-GB/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/cy-GB/images/connect-camera.gif.gif differ diff --git a/cy-GB/images/connect-camera1.png b/cy-GB/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/cy-GB/images/connect-camera1.png differ diff --git a/cy-GB/images/connect-camera2.png b/cy-GB/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/cy-GB/images/connect-camera2.png differ diff --git a/cy-GB/images/connect-camera3.png b/cy-GB/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/cy-GB/images/connect-camera3.png differ diff --git a/cy-GB/images/connect-camera4.png b/cy-GB/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/cy-GB/images/connect-camera4.png differ diff --git a/cy-GB/images/connect-camera5.png b/cy-GB/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/cy-GB/images/connect-camera5.png differ diff --git a/cy-GB/images/deinterlace1.jpg b/cy-GB/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/cy-GB/images/deinterlace1.jpg differ diff --git a/cy-GB/images/deinterlace2.jpg b/cy-GB/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/cy-GB/images/deinterlace2.jpg differ diff --git a/cy-GB/images/denoise.jpg b/cy-GB/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/cy-GB/images/denoise.jpg differ diff --git a/cy-GB/images/desktop-annotated.png b/cy-GB/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/cy-GB/images/desktop-annotated.png differ diff --git a/cy-GB/images/desktop.png b/cy-GB/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/cy-GB/images/desktop.png differ diff --git a/cy-GB/images/effects.jpg b/cy-GB/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/cy-GB/images/effects.jpg differ diff --git a/cy-GB/images/emboss.jpg b/cy-GB/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/cy-GB/images/emboss.jpg differ diff --git a/cy-GB/images/film.jpg b/cy-GB/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/cy-GB/images/film.jpg differ diff --git a/cy-GB/images/gpen.jpg b/cy-GB/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/cy-GB/images/gpen.jpg differ diff --git a/cy-GB/images/hatch.jpg b/cy-GB/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/cy-GB/images/hatch.jpg differ diff --git a/cy-GB/images/negative.jpg b/cy-GB/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/cy-GB/images/negative.jpg differ diff --git a/cy-GB/images/none.jpg b/cy-GB/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/cy-GB/images/none.jpg differ diff --git a/cy-GB/images/oilpaint.jpg b/cy-GB/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/cy-GB/images/oilpaint.jpg differ diff --git a/cy-GB/images/open-terminal-annotated.png b/cy-GB/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/cy-GB/images/open-terminal-annotated.png differ diff --git a/cy-GB/images/open-terminal.png b/cy-GB/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/cy-GB/images/open-terminal.png differ diff --git a/cy-GB/images/pastel.jpg b/cy-GB/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/cy-GB/images/pastel.jpg differ diff --git a/cy-GB/images/pi-camera-attached.jpg b/cy-GB/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/cy-GB/images/pi-camera-attached.jpg differ diff --git a/cy-GB/images/pi-configuration-interfaces-annotated.png b/cy-GB/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/cy-GB/images/pi-configuration-interfaces-annotated.png differ diff --git a/cy-GB/images/pi-configuration-interfaces.png b/cy-GB/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/cy-GB/images/pi-configuration-interfaces.png differ diff --git a/cy-GB/images/pi-configuration-menu.png b/cy-GB/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/cy-GB/images/pi-configuration-menu.png differ diff --git a/cy-GB/images/pi4-camera-port.png b/cy-GB/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/cy-GB/images/pi4-camera-port.png differ diff --git a/cy-GB/images/posterise.jpg b/cy-GB/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/cy-GB/images/posterise.jpg differ diff --git a/cy-GB/images/preview.jpg b/cy-GB/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/cy-GB/images/preview.jpg differ diff --git a/cy-GB/images/raspberry-pi.png b/cy-GB/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/cy-GB/images/raspberry-pi.png differ diff --git a/cy-GB/images/raspistill-help.png b/cy-GB/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/cy-GB/images/raspistill-help.png differ diff --git a/cy-GB/images/raspistill-image.png b/cy-GB/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/cy-GB/images/raspistill-image.png differ diff --git a/cy-GB/images/saturation.jpg b/cy-GB/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/cy-GB/images/saturation.jpg differ diff --git a/cy-GB/images/sketch.jpg b/cy-GB/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/cy-GB/images/sketch.jpg differ diff --git a/cy-GB/images/solarize.jpg b/cy-GB/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/cy-GB/images/solarize.jpg differ diff --git a/cy-GB/images/thonny-app-menu.png b/cy-GB/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/cy-GB/images/thonny-app-menu.png differ diff --git a/cy-GB/images/washedout.jpg b/cy-GB/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/cy-GB/images/washedout.jpg differ diff --git a/cy-GB/images/watercolor.jpg b/cy-GB/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/cy-GB/images/watercolor.jpg differ diff --git a/cy-GB/meta.yml b/cy-GB/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/cy-GB/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/cy-GB/step_1.md b/cy-GB/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/cy-GB/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/cy-GB/step_2.md b/cy-GB/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/cy-GB/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/cy-GB/step_3.md b/cy-GB/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/cy-GB/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/cy-GB/step_4.md b/cy-GB/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/cy-GB/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 Enter 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/cy-GB/step_5.md b/cy-GB/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/cy-GB/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`. \ No newline at end of file diff --git a/cy-GB/step_6.md b/cy-GB/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/cy-GB/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. \ No newline at end of file diff --git a/cy-GB/step_7.md b/cy-GB/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/cy-GB/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. + diff --git a/cy-GB/step_8.md b/cy-GB/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/cy-GB/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/cy-GB/step_9.md b/cy-GB/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/cy-GB/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/da-DK/images/Getting_Started_With_Picamera_TILE.png b/da-DK/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/da-DK/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/da-DK/images/banner.png b/da-DK/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/da-DK/images/banner.png differ diff --git a/da-DK/images/blur.jpg b/da-DK/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/da-DK/images/blur.jpg differ diff --git a/da-DK/images/camera-module.png b/da-DK/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/da-DK/images/camera-module.png differ diff --git a/da-DK/images/cartoon.jpg b/da-DK/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/da-DK/images/cartoon.jpg differ diff --git a/da-DK/images/colorbalance.jpg b/da-DK/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/da-DK/images/colorbalance.jpg differ diff --git a/da-DK/images/colorpoint.jpg b/da-DK/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/da-DK/images/colorpoint.jpg differ diff --git a/da-DK/images/colorswap.jpg b/da-DK/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/da-DK/images/colorswap.jpg differ diff --git a/da-DK/images/connect-camera-old.gif b/da-DK/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/da-DK/images/connect-camera-old.gif differ diff --git a/da-DK/images/connect-camera.gif b/da-DK/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/da-DK/images/connect-camera.gif differ diff --git a/da-DK/images/connect-camera.gif.gif b/da-DK/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/da-DK/images/connect-camera.gif.gif differ diff --git a/da-DK/images/connect-camera1.png b/da-DK/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/da-DK/images/connect-camera1.png differ diff --git a/da-DK/images/connect-camera2.png b/da-DK/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/da-DK/images/connect-camera2.png differ diff --git a/da-DK/images/connect-camera3.png b/da-DK/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/da-DK/images/connect-camera3.png differ diff --git a/da-DK/images/connect-camera4.png b/da-DK/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/da-DK/images/connect-camera4.png differ diff --git a/da-DK/images/connect-camera5.png b/da-DK/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/da-DK/images/connect-camera5.png differ diff --git a/da-DK/images/deinterlace1.jpg b/da-DK/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/da-DK/images/deinterlace1.jpg differ diff --git a/da-DK/images/deinterlace2.jpg b/da-DK/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/da-DK/images/deinterlace2.jpg differ diff --git a/da-DK/images/denoise.jpg b/da-DK/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/da-DK/images/denoise.jpg differ diff --git a/da-DK/images/desktop-annotated.png b/da-DK/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/da-DK/images/desktop-annotated.png differ diff --git a/da-DK/images/desktop.png b/da-DK/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/da-DK/images/desktop.png differ diff --git a/da-DK/images/effects.jpg b/da-DK/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/da-DK/images/effects.jpg differ diff --git a/da-DK/images/emboss.jpg b/da-DK/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/da-DK/images/emboss.jpg differ diff --git a/da-DK/images/film.jpg b/da-DK/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/da-DK/images/film.jpg differ diff --git a/da-DK/images/gpen.jpg b/da-DK/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/da-DK/images/gpen.jpg differ diff --git a/da-DK/images/hatch.jpg b/da-DK/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/da-DK/images/hatch.jpg differ diff --git a/da-DK/images/negative.jpg b/da-DK/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/da-DK/images/negative.jpg differ diff --git a/da-DK/images/none.jpg b/da-DK/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/da-DK/images/none.jpg differ diff --git a/da-DK/images/oilpaint.jpg b/da-DK/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/da-DK/images/oilpaint.jpg differ diff --git a/da-DK/images/open-terminal-annotated.png b/da-DK/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/da-DK/images/open-terminal-annotated.png differ diff --git a/da-DK/images/open-terminal.png b/da-DK/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/da-DK/images/open-terminal.png differ diff --git a/da-DK/images/pastel.jpg b/da-DK/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/da-DK/images/pastel.jpg differ diff --git a/da-DK/images/pi-camera-attached.jpg b/da-DK/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/da-DK/images/pi-camera-attached.jpg differ diff --git a/da-DK/images/pi-configuration-interfaces-annotated.png b/da-DK/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/da-DK/images/pi-configuration-interfaces-annotated.png differ diff --git a/da-DK/images/pi-configuration-interfaces.png b/da-DK/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/da-DK/images/pi-configuration-interfaces.png differ diff --git a/da-DK/images/pi-configuration-menu.png b/da-DK/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/da-DK/images/pi-configuration-menu.png differ diff --git a/da-DK/images/pi4-camera-port.png b/da-DK/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/da-DK/images/pi4-camera-port.png differ diff --git a/da-DK/images/posterise.jpg b/da-DK/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/da-DK/images/posterise.jpg differ diff --git a/da-DK/images/preview.jpg b/da-DK/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/da-DK/images/preview.jpg differ diff --git a/da-DK/images/raspberry-pi.png b/da-DK/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/da-DK/images/raspberry-pi.png differ diff --git a/da-DK/images/raspistill-help.png b/da-DK/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/da-DK/images/raspistill-help.png differ diff --git a/da-DK/images/raspistill-image.png b/da-DK/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/da-DK/images/raspistill-image.png differ diff --git a/da-DK/images/saturation.jpg b/da-DK/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/da-DK/images/saturation.jpg differ diff --git a/da-DK/images/sketch.jpg b/da-DK/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/da-DK/images/sketch.jpg differ diff --git a/da-DK/images/solarize.jpg b/da-DK/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/da-DK/images/solarize.jpg differ diff --git a/da-DK/images/thonny-app-menu.png b/da-DK/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/da-DK/images/thonny-app-menu.png differ diff --git a/da-DK/images/washedout.jpg b/da-DK/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/da-DK/images/washedout.jpg differ diff --git a/da-DK/images/watercolor.jpg b/da-DK/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/da-DK/images/watercolor.jpg differ diff --git a/da-DK/meta.yml b/da-DK/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/da-DK/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/da-DK/step_1.md b/da-DK/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/da-DK/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/da-DK/step_2.md b/da-DK/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/da-DK/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/da-DK/step_3.md b/da-DK/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/da-DK/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/da-DK/step_4.md b/da-DK/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/da-DK/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 Enter 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/da-DK/step_5.md b/da-DK/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/da-DK/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`. \ No newline at end of file diff --git a/da-DK/step_6.md b/da-DK/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/da-DK/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. \ No newline at end of file diff --git a/da-DK/step_7.md b/da-DK/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/da-DK/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. + diff --git a/da-DK/step_8.md b/da-DK/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/da-DK/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/da-DK/step_9.md b/da-DK/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/da-DK/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/de-DE/images/Getting_Started_With_Picamera_TILE.png b/de-DE/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/de-DE/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/de-DE/images/banner.png b/de-DE/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/de-DE/images/banner.png differ diff --git a/de-DE/images/blur.jpg b/de-DE/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/de-DE/images/blur.jpg differ diff --git a/de-DE/images/camera-module.png b/de-DE/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/de-DE/images/camera-module.png differ diff --git a/de-DE/images/cartoon.jpg b/de-DE/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/de-DE/images/cartoon.jpg differ diff --git a/de-DE/images/colorbalance.jpg b/de-DE/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/de-DE/images/colorbalance.jpg differ diff --git a/de-DE/images/colorpoint.jpg b/de-DE/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/de-DE/images/colorpoint.jpg differ diff --git a/de-DE/images/colorswap.jpg b/de-DE/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/de-DE/images/colorswap.jpg differ diff --git a/de-DE/images/connect-camera-old.gif b/de-DE/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/de-DE/images/connect-camera-old.gif differ diff --git a/de-DE/images/connect-camera.gif b/de-DE/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/de-DE/images/connect-camera.gif differ diff --git a/de-DE/images/connect-camera.gif.gif b/de-DE/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/de-DE/images/connect-camera.gif.gif differ diff --git a/de-DE/images/connect-camera1.png b/de-DE/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/de-DE/images/connect-camera1.png differ diff --git a/de-DE/images/connect-camera2.png b/de-DE/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/de-DE/images/connect-camera2.png differ diff --git a/de-DE/images/connect-camera3.png b/de-DE/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/de-DE/images/connect-camera3.png differ diff --git a/de-DE/images/connect-camera4.png b/de-DE/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/de-DE/images/connect-camera4.png differ diff --git a/de-DE/images/connect-camera5.png b/de-DE/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/de-DE/images/connect-camera5.png differ diff --git a/de-DE/images/deinterlace1.jpg b/de-DE/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/de-DE/images/deinterlace1.jpg differ diff --git a/de-DE/images/deinterlace2.jpg b/de-DE/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/de-DE/images/deinterlace2.jpg differ diff --git a/de-DE/images/denoise.jpg b/de-DE/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/de-DE/images/denoise.jpg differ diff --git a/de-DE/images/desktop-annotated.png b/de-DE/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/de-DE/images/desktop-annotated.png differ diff --git a/de-DE/images/desktop.png b/de-DE/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/de-DE/images/desktop.png differ diff --git a/de-DE/images/effects.jpg b/de-DE/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/de-DE/images/effects.jpg differ diff --git a/de-DE/images/emboss.jpg b/de-DE/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/de-DE/images/emboss.jpg differ diff --git a/de-DE/images/film.jpg b/de-DE/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/de-DE/images/film.jpg differ diff --git a/de-DE/images/gpen.jpg b/de-DE/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/de-DE/images/gpen.jpg differ diff --git a/de-DE/images/hatch.jpg b/de-DE/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/de-DE/images/hatch.jpg differ diff --git a/de-DE/images/negative.jpg b/de-DE/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/de-DE/images/negative.jpg differ diff --git a/de-DE/images/none.jpg b/de-DE/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/de-DE/images/none.jpg differ diff --git a/de-DE/images/oilpaint.jpg b/de-DE/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/de-DE/images/oilpaint.jpg differ diff --git a/de-DE/images/open-terminal-annotated.png b/de-DE/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/de-DE/images/open-terminal-annotated.png differ diff --git a/de-DE/images/open-terminal.png b/de-DE/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/de-DE/images/open-terminal.png differ diff --git a/de-DE/images/pastel.jpg b/de-DE/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/de-DE/images/pastel.jpg differ diff --git a/de-DE/images/pi-camera-attached.jpg b/de-DE/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/de-DE/images/pi-camera-attached.jpg differ diff --git a/de-DE/images/pi-configuration-interfaces-annotated.png b/de-DE/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/de-DE/images/pi-configuration-interfaces-annotated.png differ diff --git a/de-DE/images/pi-configuration-interfaces.png b/de-DE/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/de-DE/images/pi-configuration-interfaces.png differ diff --git a/de-DE/images/pi-configuration-menu.png b/de-DE/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/de-DE/images/pi-configuration-menu.png differ diff --git a/de-DE/images/pi4-camera-port.png b/de-DE/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/de-DE/images/pi4-camera-port.png differ diff --git a/de-DE/images/posterise.jpg b/de-DE/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/de-DE/images/posterise.jpg differ diff --git a/de-DE/images/preview.jpg b/de-DE/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/de-DE/images/preview.jpg differ diff --git a/de-DE/images/raspberry-pi.png b/de-DE/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/de-DE/images/raspberry-pi.png differ diff --git a/de-DE/images/raspistill-help.png b/de-DE/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/de-DE/images/raspistill-help.png differ diff --git a/de-DE/images/raspistill-image.png b/de-DE/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/de-DE/images/raspistill-image.png differ diff --git a/de-DE/images/saturation.jpg b/de-DE/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/de-DE/images/saturation.jpg differ diff --git a/de-DE/images/sketch.jpg b/de-DE/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/de-DE/images/sketch.jpg differ diff --git a/de-DE/images/solarize.jpg b/de-DE/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/de-DE/images/solarize.jpg differ diff --git a/de-DE/images/thonny-app-menu.png b/de-DE/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/de-DE/images/thonny-app-menu.png differ diff --git a/de-DE/images/washedout.jpg b/de-DE/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/de-DE/images/washedout.jpg differ diff --git a/de-DE/images/watercolor.jpg b/de-DE/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/de-DE/images/watercolor.jpg differ diff --git a/de-DE/meta.yml b/de-DE/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/de-DE/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/de-DE/step_1.md b/de-DE/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/de-DE/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/de-DE/step_2.md b/de-DE/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/de-DE/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/de-DE/step_3.md b/de-DE/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/de-DE/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/de-DE/step_4.md b/de-DE/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/de-DE/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 Enter 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/de-DE/step_5.md b/de-DE/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/de-DE/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`. \ No newline at end of file diff --git a/de-DE/step_6.md b/de-DE/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/de-DE/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. \ No newline at end of file diff --git a/de-DE/step_7.md b/de-DE/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/de-DE/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. + diff --git a/de-DE/step_8.md b/de-DE/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/de-DE/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/de-DE/step_9.md b/de-DE/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/de-DE/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/el-GR/images/Getting_Started_With_Picamera_TILE.png b/el-GR/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/el-GR/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/el-GR/images/banner.png b/el-GR/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/el-GR/images/banner.png differ diff --git a/el-GR/images/blur.jpg b/el-GR/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/el-GR/images/blur.jpg differ diff --git a/el-GR/images/camera-module.png b/el-GR/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/el-GR/images/camera-module.png differ diff --git a/el-GR/images/cartoon.jpg b/el-GR/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/el-GR/images/cartoon.jpg differ diff --git a/el-GR/images/colorbalance.jpg b/el-GR/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/el-GR/images/colorbalance.jpg differ diff --git a/el-GR/images/colorpoint.jpg b/el-GR/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/el-GR/images/colorpoint.jpg differ diff --git a/el-GR/images/colorswap.jpg b/el-GR/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/el-GR/images/colorswap.jpg differ diff --git a/el-GR/images/connect-camera-old.gif b/el-GR/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/el-GR/images/connect-camera-old.gif differ diff --git a/el-GR/images/connect-camera.gif b/el-GR/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/el-GR/images/connect-camera.gif differ diff --git a/el-GR/images/connect-camera.gif.gif b/el-GR/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/el-GR/images/connect-camera.gif.gif differ diff --git a/el-GR/images/connect-camera1.png b/el-GR/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/el-GR/images/connect-camera1.png differ diff --git a/el-GR/images/connect-camera2.png b/el-GR/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/el-GR/images/connect-camera2.png differ diff --git a/el-GR/images/connect-camera3.png b/el-GR/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/el-GR/images/connect-camera3.png differ diff --git a/el-GR/images/connect-camera4.png b/el-GR/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/el-GR/images/connect-camera4.png differ diff --git a/el-GR/images/connect-camera5.png b/el-GR/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/el-GR/images/connect-camera5.png differ diff --git a/el-GR/images/deinterlace1.jpg b/el-GR/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/el-GR/images/deinterlace1.jpg differ diff --git a/el-GR/images/deinterlace2.jpg b/el-GR/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/el-GR/images/deinterlace2.jpg differ diff --git a/el-GR/images/denoise.jpg b/el-GR/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/el-GR/images/denoise.jpg differ diff --git a/el-GR/images/desktop-annotated.png b/el-GR/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/el-GR/images/desktop-annotated.png differ diff --git a/el-GR/images/desktop.png b/el-GR/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/el-GR/images/desktop.png differ diff --git a/el-GR/images/effects.jpg b/el-GR/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/el-GR/images/effects.jpg differ diff --git a/el-GR/images/emboss.jpg b/el-GR/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/el-GR/images/emboss.jpg differ diff --git a/el-GR/images/film.jpg b/el-GR/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/el-GR/images/film.jpg differ diff --git a/el-GR/images/gpen.jpg b/el-GR/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/el-GR/images/gpen.jpg differ diff --git a/el-GR/images/hatch.jpg b/el-GR/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/el-GR/images/hatch.jpg differ diff --git a/el-GR/images/negative.jpg b/el-GR/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/el-GR/images/negative.jpg differ diff --git a/el-GR/images/none.jpg b/el-GR/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/el-GR/images/none.jpg differ diff --git a/el-GR/images/oilpaint.jpg b/el-GR/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/el-GR/images/oilpaint.jpg differ diff --git a/el-GR/images/open-terminal-annotated.png b/el-GR/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/el-GR/images/open-terminal-annotated.png differ diff --git a/el-GR/images/open-terminal.png b/el-GR/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/el-GR/images/open-terminal.png differ diff --git a/el-GR/images/pastel.jpg b/el-GR/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/el-GR/images/pastel.jpg differ diff --git a/el-GR/images/pi-camera-attached.jpg b/el-GR/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/el-GR/images/pi-camera-attached.jpg differ diff --git a/el-GR/images/pi-configuration-interfaces-annotated.png b/el-GR/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/el-GR/images/pi-configuration-interfaces-annotated.png differ diff --git a/el-GR/images/pi-configuration-interfaces.png b/el-GR/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/el-GR/images/pi-configuration-interfaces.png differ diff --git a/el-GR/images/pi-configuration-menu.png b/el-GR/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/el-GR/images/pi-configuration-menu.png differ diff --git a/el-GR/images/pi4-camera-port.png b/el-GR/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/el-GR/images/pi4-camera-port.png differ diff --git a/el-GR/images/posterise.jpg b/el-GR/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/el-GR/images/posterise.jpg differ diff --git a/el-GR/images/preview.jpg b/el-GR/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/el-GR/images/preview.jpg differ diff --git a/el-GR/images/raspberry-pi.png b/el-GR/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/el-GR/images/raspberry-pi.png differ diff --git a/el-GR/images/raspistill-help.png b/el-GR/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/el-GR/images/raspistill-help.png differ diff --git a/el-GR/images/raspistill-image.png b/el-GR/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/el-GR/images/raspistill-image.png differ diff --git a/el-GR/images/saturation.jpg b/el-GR/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/el-GR/images/saturation.jpg differ diff --git a/el-GR/images/sketch.jpg b/el-GR/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/el-GR/images/sketch.jpg differ diff --git a/el-GR/images/solarize.jpg b/el-GR/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/el-GR/images/solarize.jpg differ diff --git a/el-GR/images/thonny-app-menu.png b/el-GR/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/el-GR/images/thonny-app-menu.png differ diff --git a/el-GR/images/washedout.jpg b/el-GR/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/el-GR/images/washedout.jpg differ diff --git a/el-GR/images/watercolor.jpg b/el-GR/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/el-GR/images/watercolor.jpg differ diff --git a/el-GR/meta.yml b/el-GR/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/el-GR/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/el-GR/step_1.md b/el-GR/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/el-GR/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/el-GR/step_2.md b/el-GR/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/el-GR/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/el-GR/step_3.md b/el-GR/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/el-GR/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/el-GR/step_4.md b/el-GR/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/el-GR/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 Enter 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/el-GR/step_5.md b/el-GR/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/el-GR/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`. \ No newline at end of file diff --git a/el-GR/step_6.md b/el-GR/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/el-GR/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. \ No newline at end of file diff --git a/el-GR/step_7.md b/el-GR/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/el-GR/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. + diff --git a/el-GR/step_8.md b/el-GR/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/el-GR/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/el-GR/step_9.md b/el-GR/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/el-GR/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/en-US/images/Getting_Started_With_Picamera_TILE.png b/en-US/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/en-US/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/en-US/images/banner.png b/en-US/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/en-US/images/banner.png differ diff --git a/en-US/images/blur.jpg b/en-US/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/en-US/images/blur.jpg differ diff --git a/en-US/images/camera-module.png b/en-US/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/en-US/images/camera-module.png differ diff --git a/en-US/images/cartoon.jpg b/en-US/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/en-US/images/cartoon.jpg differ diff --git a/en-US/images/colorbalance.jpg b/en-US/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/en-US/images/colorbalance.jpg differ diff --git a/en-US/images/colorpoint.jpg b/en-US/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/en-US/images/colorpoint.jpg differ diff --git a/en-US/images/colorswap.jpg b/en-US/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/en-US/images/colorswap.jpg differ diff --git a/en-US/images/connect-camera-old.gif b/en-US/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/en-US/images/connect-camera-old.gif differ diff --git a/en-US/images/connect-camera.gif b/en-US/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/en-US/images/connect-camera.gif differ diff --git a/en-US/images/connect-camera.gif.gif b/en-US/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/en-US/images/connect-camera.gif.gif differ diff --git a/en-US/images/connect-camera1.png b/en-US/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/en-US/images/connect-camera1.png differ diff --git a/en-US/images/connect-camera2.png b/en-US/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/en-US/images/connect-camera2.png differ diff --git a/en-US/images/connect-camera3.png b/en-US/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/en-US/images/connect-camera3.png differ diff --git a/en-US/images/connect-camera4.png b/en-US/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/en-US/images/connect-camera4.png differ diff --git a/en-US/images/connect-camera5.png b/en-US/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/en-US/images/connect-camera5.png differ diff --git a/en-US/images/deinterlace1.jpg b/en-US/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/en-US/images/deinterlace1.jpg differ diff --git a/en-US/images/deinterlace2.jpg b/en-US/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/en-US/images/deinterlace2.jpg differ diff --git a/en-US/images/denoise.jpg b/en-US/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/en-US/images/denoise.jpg differ diff --git a/en-US/images/desktop-annotated.png b/en-US/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/en-US/images/desktop-annotated.png differ diff --git a/en-US/images/desktop.png b/en-US/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/en-US/images/desktop.png differ diff --git a/en-US/images/effects.jpg b/en-US/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/en-US/images/effects.jpg differ diff --git a/en-US/images/emboss.jpg b/en-US/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/en-US/images/emboss.jpg differ diff --git a/en-US/images/film.jpg b/en-US/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/en-US/images/film.jpg differ diff --git a/en-US/images/gpen.jpg b/en-US/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/en-US/images/gpen.jpg differ diff --git a/en-US/images/hatch.jpg b/en-US/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/en-US/images/hatch.jpg differ diff --git a/en-US/images/negative.jpg b/en-US/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/en-US/images/negative.jpg differ diff --git a/en-US/images/none.jpg b/en-US/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/en-US/images/none.jpg differ diff --git a/en-US/images/oilpaint.jpg b/en-US/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/en-US/images/oilpaint.jpg differ diff --git a/en-US/images/open-terminal-annotated.png b/en-US/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/en-US/images/open-terminal-annotated.png differ diff --git a/en-US/images/open-terminal.png b/en-US/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/en-US/images/open-terminal.png differ diff --git a/en-US/images/pastel.jpg b/en-US/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/en-US/images/pastel.jpg differ diff --git a/en-US/images/pi-camera-attached.jpg b/en-US/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/en-US/images/pi-camera-attached.jpg differ diff --git a/en-US/images/pi-configuration-interfaces-annotated.png b/en-US/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/en-US/images/pi-configuration-interfaces-annotated.png differ diff --git a/en-US/images/pi-configuration-interfaces.png b/en-US/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/en-US/images/pi-configuration-interfaces.png differ diff --git a/en-US/images/pi-configuration-menu.png b/en-US/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/en-US/images/pi-configuration-menu.png differ diff --git a/en-US/images/pi4-camera-port.png b/en-US/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/en-US/images/pi4-camera-port.png differ diff --git a/en-US/images/posterise.jpg b/en-US/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/en-US/images/posterise.jpg differ diff --git a/en-US/images/preview.jpg b/en-US/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/en-US/images/preview.jpg differ diff --git a/en-US/images/raspberry-pi.png b/en-US/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/en-US/images/raspberry-pi.png differ diff --git a/en-US/images/raspistill-help.png b/en-US/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/en-US/images/raspistill-help.png differ diff --git a/en-US/images/raspistill-image.png b/en-US/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/en-US/images/raspistill-image.png differ diff --git a/en-US/images/saturation.jpg b/en-US/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/en-US/images/saturation.jpg differ diff --git a/en-US/images/sketch.jpg b/en-US/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/en-US/images/sketch.jpg differ diff --git a/en-US/images/solarize.jpg b/en-US/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/en-US/images/solarize.jpg differ diff --git a/en-US/images/thonny-app-menu.png b/en-US/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/en-US/images/thonny-app-menu.png differ diff --git a/en-US/images/washedout.jpg b/en-US/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/en-US/images/washedout.jpg differ diff --git a/en-US/images/watercolor.jpg b/en-US/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/en-US/images/watercolor.jpg differ diff --git a/en-US/meta.yml b/en-US/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/en-US/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/en-US/step_1.md b/en-US/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/en-US/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/en-US/step_2.md b/en-US/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/en-US/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/en-US/step_3.md b/en-US/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/en-US/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/en-US/step_4.md b/en-US/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/en-US/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 Enter 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/en-US/step_5.md b/en-US/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/en-US/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`. \ No newline at end of file diff --git a/en-US/step_6.md b/en-US/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/en-US/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. \ No newline at end of file diff --git a/en-US/step_7.md b/en-US/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/en-US/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. + diff --git a/en-US/step_8.md b/en-US/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/en-US/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/en-US/step_9.md b/en-US/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/en-US/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/es-ES/images/Getting_Started_With_Picamera_TILE.png b/es-ES/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/es-ES/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/es-ES/images/banner.png b/es-ES/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/es-ES/images/banner.png differ diff --git a/es-ES/images/blur.jpg b/es-ES/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/es-ES/images/blur.jpg differ diff --git a/es-ES/images/camera-module.png b/es-ES/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/es-ES/images/camera-module.png differ diff --git a/es-ES/images/cartoon.jpg b/es-ES/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/es-ES/images/cartoon.jpg differ diff --git a/es-ES/images/colorbalance.jpg b/es-ES/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/es-ES/images/colorbalance.jpg differ diff --git a/es-ES/images/colorpoint.jpg b/es-ES/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/es-ES/images/colorpoint.jpg differ diff --git a/es-ES/images/colorswap.jpg b/es-ES/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/es-ES/images/colorswap.jpg differ diff --git a/es-ES/images/connect-camera-old.gif b/es-ES/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/es-ES/images/connect-camera-old.gif differ diff --git a/es-ES/images/connect-camera.gif b/es-ES/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/es-ES/images/connect-camera.gif differ diff --git a/es-ES/images/connect-camera.gif.gif b/es-ES/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/es-ES/images/connect-camera.gif.gif differ diff --git a/es-ES/images/connect-camera1.png b/es-ES/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/es-ES/images/connect-camera1.png differ diff --git a/es-ES/images/connect-camera2.png b/es-ES/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/es-ES/images/connect-camera2.png differ diff --git a/es-ES/images/connect-camera3.png b/es-ES/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/es-ES/images/connect-camera3.png differ diff --git a/es-ES/images/connect-camera4.png b/es-ES/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/es-ES/images/connect-camera4.png differ diff --git a/es-ES/images/connect-camera5.png b/es-ES/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/es-ES/images/connect-camera5.png differ diff --git a/es-ES/images/deinterlace1.jpg b/es-ES/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/es-ES/images/deinterlace1.jpg differ diff --git a/es-ES/images/deinterlace2.jpg b/es-ES/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/es-ES/images/deinterlace2.jpg differ diff --git a/es-ES/images/denoise.jpg b/es-ES/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/es-ES/images/denoise.jpg differ diff --git a/es-ES/images/desktop-annotated.png b/es-ES/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/es-ES/images/desktop-annotated.png differ diff --git a/es-ES/images/desktop.png b/es-ES/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/es-ES/images/desktop.png differ diff --git a/es-ES/images/effects.jpg b/es-ES/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/es-ES/images/effects.jpg differ diff --git a/es-ES/images/emboss.jpg b/es-ES/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/es-ES/images/emboss.jpg differ diff --git a/es-ES/images/film.jpg b/es-ES/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/es-ES/images/film.jpg differ diff --git a/es-ES/images/gpen.jpg b/es-ES/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/es-ES/images/gpen.jpg differ diff --git a/es-ES/images/hatch.jpg b/es-ES/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/es-ES/images/hatch.jpg differ diff --git a/es-ES/images/negative.jpg b/es-ES/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/es-ES/images/negative.jpg differ diff --git a/es-ES/images/none.jpg b/es-ES/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/es-ES/images/none.jpg differ diff --git a/es-ES/images/oilpaint.jpg b/es-ES/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/es-ES/images/oilpaint.jpg differ diff --git a/es-ES/images/open-terminal-annotated.png b/es-ES/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/es-ES/images/open-terminal-annotated.png differ diff --git a/es-ES/images/open-terminal.png b/es-ES/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/es-ES/images/open-terminal.png differ diff --git a/es-ES/images/pastel.jpg b/es-ES/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/es-ES/images/pastel.jpg differ diff --git a/es-ES/images/pi-camera-attached.jpg b/es-ES/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/es-ES/images/pi-camera-attached.jpg differ diff --git a/es-ES/images/pi-configuration-interfaces-annotated.png b/es-ES/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/es-ES/images/pi-configuration-interfaces-annotated.png differ diff --git a/es-ES/images/pi-configuration-interfaces.png b/es-ES/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/es-ES/images/pi-configuration-interfaces.png differ diff --git a/es-ES/images/pi-configuration-menu.png b/es-ES/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/es-ES/images/pi-configuration-menu.png differ diff --git a/es-ES/images/pi4-camera-port.png b/es-ES/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/es-ES/images/pi4-camera-port.png differ diff --git a/es-ES/images/posterise.jpg b/es-ES/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/es-ES/images/posterise.jpg differ diff --git a/es-ES/images/preview.jpg b/es-ES/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/es-ES/images/preview.jpg differ diff --git a/es-ES/images/raspberry-pi.png b/es-ES/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/es-ES/images/raspberry-pi.png differ diff --git a/es-ES/images/raspistill-help.png b/es-ES/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/es-ES/images/raspistill-help.png differ diff --git a/es-ES/images/raspistill-image.png b/es-ES/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/es-ES/images/raspistill-image.png differ diff --git a/es-ES/images/saturation.jpg b/es-ES/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/es-ES/images/saturation.jpg differ diff --git a/es-ES/images/sketch.jpg b/es-ES/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/es-ES/images/sketch.jpg differ diff --git a/es-ES/images/solarize.jpg b/es-ES/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/es-ES/images/solarize.jpg differ diff --git a/es-ES/images/thonny-app-menu.png b/es-ES/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/es-ES/images/thonny-app-menu.png differ diff --git a/es-ES/images/washedout.jpg b/es-ES/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/es-ES/images/washedout.jpg differ diff --git a/es-ES/images/watercolor.jpg b/es-ES/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/es-ES/images/watercolor.jpg differ diff --git a/es-ES/meta.yml b/es-ES/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/es-ES/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/es-ES/step_1.md b/es-ES/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/es-ES/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/es-ES/step_2.md b/es-ES/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/es-ES/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/es-ES/step_3.md b/es-ES/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/es-ES/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/es-ES/step_4.md b/es-ES/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/es-ES/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 Enter 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/es-ES/step_5.md b/es-ES/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/es-ES/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`. \ No newline at end of file diff --git a/es-ES/step_6.md b/es-ES/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/es-ES/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. \ No newline at end of file diff --git a/es-ES/step_7.md b/es-ES/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/es-ES/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. + diff --git a/es-ES/step_8.md b/es-ES/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/es-ES/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/es-ES/step_9.md b/es-ES/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/es-ES/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/es-LA/images/Getting_Started_With_Picamera_TILE.png b/es-LA/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/es-LA/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/es-LA/images/banner.png b/es-LA/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/es-LA/images/banner.png differ diff --git a/es-LA/images/blur.jpg b/es-LA/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/es-LA/images/blur.jpg differ diff --git a/es-LA/images/camera-module.png b/es-LA/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/es-LA/images/camera-module.png differ diff --git a/es-LA/images/cartoon.jpg b/es-LA/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/es-LA/images/cartoon.jpg differ diff --git a/es-LA/images/colorbalance.jpg b/es-LA/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/es-LA/images/colorbalance.jpg differ diff --git a/es-LA/images/colorpoint.jpg b/es-LA/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/es-LA/images/colorpoint.jpg differ diff --git a/es-LA/images/colorswap.jpg b/es-LA/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/es-LA/images/colorswap.jpg differ diff --git a/es-LA/images/connect-camera-old.gif b/es-LA/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/es-LA/images/connect-camera-old.gif differ diff --git a/es-LA/images/connect-camera.gif b/es-LA/images/connect-camera.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/es-LA/images/connect-camera.gif differ diff --git a/es-LA/images/connect-camera.gif.gif b/es-LA/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/es-LA/images/connect-camera.gif.gif differ diff --git a/es-LA/images/connect-camera1.png b/es-LA/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/es-LA/images/connect-camera1.png differ diff --git a/es-LA/images/connect-camera2.png b/es-LA/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/es-LA/images/connect-camera2.png differ diff --git a/es-LA/images/connect-camera3.png b/es-LA/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/es-LA/images/connect-camera3.png differ diff --git a/es-LA/images/connect-camera4.png b/es-LA/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/es-LA/images/connect-camera4.png differ diff --git a/es-LA/images/connect-camera5.png b/es-LA/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/es-LA/images/connect-camera5.png differ diff --git a/es-LA/images/deinterlace1.jpg b/es-LA/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/es-LA/images/deinterlace1.jpg differ diff --git a/es-LA/images/deinterlace2.jpg b/es-LA/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/es-LA/images/deinterlace2.jpg differ diff --git a/es-LA/images/denoise.jpg b/es-LA/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/es-LA/images/denoise.jpg differ diff --git a/es-LA/images/desktop-annotated.png b/es-LA/images/desktop-annotated.png new file mode 100644 index 00000000..29e96977 Binary files /dev/null and b/es-LA/images/desktop-annotated.png differ diff --git a/es-LA/images/desktop.png b/es-LA/images/desktop.png new file mode 100644 index 00000000..3b8e0169 Binary files /dev/null and b/es-LA/images/desktop.png differ diff --git a/es-LA/images/effects.jpg b/es-LA/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/es-LA/images/effects.jpg differ diff --git a/es-LA/images/emboss.jpg b/es-LA/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/es-LA/images/emboss.jpg differ diff --git a/es-LA/images/film.jpg b/es-LA/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/es-LA/images/film.jpg differ diff --git a/es-LA/images/gpen.jpg b/es-LA/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/es-LA/images/gpen.jpg differ diff --git a/es-LA/images/hatch.jpg b/es-LA/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/es-LA/images/hatch.jpg differ diff --git a/es-LA/images/negative.jpg b/es-LA/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/es-LA/images/negative.jpg differ diff --git a/es-LA/images/none.jpg b/es-LA/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/es-LA/images/none.jpg differ diff --git a/es-LA/images/oilpaint.jpg b/es-LA/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/es-LA/images/oilpaint.jpg differ diff --git a/es-LA/images/open-terminal-annotated.png b/es-LA/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/es-LA/images/open-terminal-annotated.png differ diff --git a/es-LA/images/open-terminal.png b/es-LA/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/es-LA/images/open-terminal.png differ diff --git a/es-LA/images/pastel.jpg b/es-LA/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/es-LA/images/pastel.jpg differ diff --git a/es-LA/images/pi-camera-attached.jpg b/es-LA/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/es-LA/images/pi-camera-attached.jpg differ diff --git a/es-LA/images/pi-configuration-interfaces-annotated.png b/es-LA/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..e33bd853 Binary files /dev/null and b/es-LA/images/pi-configuration-interfaces-annotated.png differ diff --git a/es-LA/images/pi-configuration-interfaces.png b/es-LA/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..2d38a9fe Binary files /dev/null and b/es-LA/images/pi-configuration-interfaces.png differ diff --git a/es-LA/images/pi-configuration-menu.png b/es-LA/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/es-LA/images/pi-configuration-menu.png differ diff --git a/es-LA/images/pi4-camera-port.png b/es-LA/images/pi4-camera-port.png new file mode 100644 index 00000000..afa3476c Binary files /dev/null and b/es-LA/images/pi4-camera-port.png differ diff --git a/es-LA/images/posterise.jpg b/es-LA/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/es-LA/images/posterise.jpg differ diff --git a/es-LA/images/preview.jpg b/es-LA/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/es-LA/images/preview.jpg differ diff --git a/es-LA/images/raspberry-pi.png b/es-LA/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/es-LA/images/raspberry-pi.png differ diff --git a/es-LA/images/raspistill-help.png b/es-LA/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/es-LA/images/raspistill-help.png differ diff --git a/es-LA/images/raspistill-image.png b/es-LA/images/raspistill-image.png new file mode 100644 index 00000000..b370d789 Binary files /dev/null and b/es-LA/images/raspistill-image.png differ diff --git a/es-LA/images/saturation.jpg b/es-LA/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/es-LA/images/saturation.jpg differ diff --git a/es-LA/images/sketch.jpg b/es-LA/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/es-LA/images/sketch.jpg differ diff --git a/es-LA/images/solarize.jpg b/es-LA/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/es-LA/images/solarize.jpg differ diff --git a/es-LA/images/thonny-app-menu.png b/es-LA/images/thonny-app-menu.png new file mode 100644 index 00000000..bb0296e6 Binary files /dev/null and b/es-LA/images/thonny-app-menu.png differ diff --git a/es-LA/images/washedout.jpg b/es-LA/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/es-LA/images/washedout.jpg differ diff --git a/es-LA/images/watercolor.jpg b/es-LA/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/es-LA/images/watercolor.jpg differ diff --git a/es-LA/meta.yml b/es-LA/meta.yml new file mode 100644 index 00000000..6be7786d --- /dev/null +++ b/es-LA/meta.yml @@ -0,0 +1,31 @@ +--- +title: Introducción al Módulo de Cámara +hero_image: images/banner.png +description: Toma fotos y graba videos con Python y el Módulo de Cámara de Raspberry Pi +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: Introducción + - + title: Lo que necesitarás + - + title: Conecta el Módulo de la Cámara + - + title: Cómo controlar el Módulo de Cámara a través de la línea de comandos + completion: + - engaged + - + title: Cómo controlar el Módulo de Cámara con código Python + - + title: Captura imágenes fijas con código Python + - + title: Graba videos con código Python + - + title: Cómo cambiar las configuraciones en la imagen y agregarle efectos + completion: + - internal + - + title: '¿Qué sigue?' diff --git a/es-LA/step_1.md b/es-LA/step_1.md new file mode 100644 index 00000000..598c65ae --- /dev/null +++ b/es-LA/step_1.md @@ -0,0 +1,9 @@ +## Introducción + +[[[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/es-LA/step_2.md b/es-LA/step_2.md new file mode 100644 index 00000000..ae07d6b6 --- /dev/null +++ b/es-LA/step_2.md @@ -0,0 +1,20 @@ +## Lo que necesitarás + +### Computadora Raspberry Pi con un puerto para el Módulo de Cámara + +Todos los modelos actuales de Raspberry Pi tienen un puerto para conectar el Módulo de Cámara. + +![Raspberry Pi 3B+ con el puerto del Módulo de Cámara etiquetado](images/pi4-camera-port.png) + +**Nota:** Si quieres utilizar un Raspberry Pi Zero, necesitas un cable plano para Módulo de Cámara que encaje en el puerto más pequeño del Módulo de Cámara de Raspberry Pi Zero. + +### Módulo de Cámara de Raspberry Pi + +![Raspberry Pi Camera Module](images/camera-module.png) + +Hay dos versiones del Módulo de Cámara: + +* [La versión estándar](https://www.raspberrypi.org/products/camera-module-v2/), que está diseñada para tomar fotos con luz normal +* [La versión NoIR](https://www.raspberrypi.org/products/pi-noir-camera-v2/), que no tiene un filtro infrarrojo, por lo que puedes utilizarlo junto con una fuente de luz infrarroja para tomar fotos en la oscuridad + + diff --git a/es-LA/step_3.md b/es-LA/step_3.md new file mode 100644 index 00000000..fae960f1 --- /dev/null +++ b/es-LA/step_3.md @@ -0,0 +1,48 @@ +## Conecta el Módulo de la Cámara + +**Asegúrate de que tu Raspberry Pi esté apagada.** + +--- no-print --- + +1. Localiza el puerto del Módulo de Cámara +2. Tira suavemente hacia arriba los bordes del clip de plástico del puerto +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. Vuelve a colocar el clip de plástico en su lugar + +![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. Localiza el puerto del Módulo de Cámara. + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. Tira suavemente hacia arriba los bordes del clip de plástico del puerto. + +![puerto del módulo de la cámara levantado](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. + +![cable plano del módulo de la cámara insertado en el puerto](images/connect-camera3.png) + +4. Vuelve a colocar el clip de plástico en su lugar. + +![puerto del módulo de la cámara bajado](images/connect-camera4.png) + +![puerto del módulo de la cámara bajado](images/connect-camera4.png) + +--- /print-only --- + +- Inicia tu Raspberry Pi. + +- Ve al menú principal y abre la herramienta de **Configuración de Raspberry Pi **. + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- Selecciona la pestaña **Interfaces** y asegúrate de que la cámara esté **habilitada**: + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- Reinicia tu Raspberry Pi. diff --git a/es-LA/step_4.md b/es-LA/step_4.md new file mode 100644 index 00000000..2ee26659 --- /dev/null +++ b/es-LA/step_4.md @@ -0,0 +1,41 @@ +## Cómo controlar la Cámara de Módulo a través de la línea de comandos + +Ahora que el Módulo de Cámara está conectado y el software está habilitado, prueba las herramientas de líneas de comando `raspistill` y `raspivid`. + +- Abre una ventana de terminal haciendo clic en el ícono del monitor negro en la barra de tareas: + +![Abrir terminal](images/open-terminal-annotated.png) + +- Escribe el siguiente comando para tomar una imagen fija y guardarla en el Escritorio: + +```bash +raspistill -o Desktop/image.jpg +``` + +![comando raspistill introducido en el terminal](images/raspistill-image.png) + +- Presiona Enter para ejecutar el comando. + +Cuando se ejecute el comando, puedes ver la vista previa de la cámara abierta durante cinco segundos antes de que se tome una imagen fija. + +- Busca el ícono del archivo de imagen en el Escritorio y haz doble clic en el ícono de archivo para abrir la foto. + + ![Imagen en el escritorio](images/desktop-annotated.png) + +Al agregar diferentes opciones, puedes establecer el tamaño y la apariencia de la imagen que genera el comando `raspistill`. + +- Por ejemplo, agrega `-h` y `-w` para cambiar la altura y el ancho de la imagen: + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- Ahora graba un video con el Módulo de Cámara usando el siguiente comando `raspivid`: + +```bash +raspivid -o Desktop/video.h264 +``` + +- Para reproducir el archivo de video, haz doble clic en el ícono del archivo `video.h264` en el Escritorio para abrirlo en el VLC Media Player. + +Para más información y otras opciones de cómo usar estos comandos, lee la [documentación para raspistill](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) y la [documentación para raspivid](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md). diff --git a/es-LA/step_5.md b/es-LA/step_5.md new file mode 100644 index 00000000..10dcf76c --- /dev/null +++ b/es-LA/step_5.md @@ -0,0 +1,49 @@ +## Cómo controlar el Módulo de Cámara con código Python + +La biblioteca Python `picamera` te permite controlar tu Módulo de Cámara y crear proyectos increíbles. + +- Abre un editor Python 3, como **Thonny Python IDE**: + + ![Abrir Thonny](images/thonny-app-menu.png) + +- Abre un nuevo archivo y guárdalo como `camera.py`. + + **Nota:** es importante que **nunca guardes el archivo como `picamera.py`**. + +- Escribe el siguiente código: + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- Guarda y ejecuta tu programa. La vista previa de la cámara debería mostrarse durante cinco segundos y luego cerrarse nuevamente. + + ![Vista previa de imagen](images/preview.jpg) + + **Nota:** la vista previa de la cámara solo funciona cuando el monitor está conectado a tu Raspberry Pi. Si estás usando acceso remoto (como SSH o VNC) no verás la vista previa de la cámara. + +- Si tu vista previa está al revés, puedes girarla 180 grados con el siguiente código: + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + Puedes girar la imagen `90`, `180`, o `270` grados. Para restablecer la imagen, configura la `rotación` a `0` grados. + +Es mejor hacer que la vista previa sea un poco transparente para que puedas ver si ocurren errores en tu programa mientras la vista previa esté activa. + +- Haz que la vista previa de la cámara sea transparente configurando un nivel `alpha`: + + ```python + camera.start_preview(alpha=200) + ``` + + El valor `alpha` puede ser cualquier número entre `0` y `255`. \ No newline at end of file diff --git a/es-LA/step_6.md b/es-LA/step_6.md new file mode 100644 index 00000000..2daa978b --- /dev/null +++ b/es-LA/step_6.md @@ -0,0 +1,38 @@ +## Captura imágenes fijas con código Python + +Ahora usa el Módulo de Cámara y Python para capturar imágenes fijas. + +- Modifica tu código para agregar una línea `camera.capture()`: + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **Nota:** es importante configurar `sleep` durante al menos dos segundos antes de capturar una imagen, ya que esto le da tiempo al sensor de la cámara para detectar los niveles de luz. + +- Ejecuta el código. + +Deberías ver la vista previa de la cámara abierta durante cinco segundos y luego debería capturarse una imagen fija. Mientras se está tomando la foto, puedes ver la vista previa ajustarse brevemente a una resolución diferente. + +Tu nueva imagen se guardará en el Escritorio. + +- Ahora agrega un ciclo para tomar cinco fotos seguidas: + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + La variable `i` cuenta cuántas veces se ejecutó el ciclo, de `0` a `4`. Por lo tanto, las fotos se guardan como `image0.jpg`, `image1.jpg` y así sucesivamente. + +- Ejecuta el código otra vez y mantén el Módulo de Cámara en su posición. + +La cámara debería tomar una foto cada cinco segundos. Una vez que se toma la quinta foto, se cierra la vista previa. + +- Mira el Escritorio para encontrar las cinco fotos nuevas. \ No newline at end of file diff --git a/es-LA/step_7.md b/es-LA/step_7.md new file mode 100644 index 00000000..b8212c4d --- /dev/null +++ b/es-LA/step_7.md @@ -0,0 +1,20 @@ +## Graba videos con código Python + +¡Ahora graba un video! + +- Modifica tu código para eliminar `capture()` y en su lugar agrega `start_recording()` y `stop_recording()` + + Tu código debería verse así: + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- Ejecuta el código. + +Tu Raspberry Pi debería abrir una vista previa, grabar 5 segundos de video y luego cerrar la vista previa. + diff --git a/es-LA/step_8.md b/es-LA/step_8.md new file mode 100644 index 00000000..b35d2d07 --- /dev/null +++ b/es-LA/step_8.md @@ -0,0 +1,228 @@ +## Cómo cambiar las configuraciones de la imagen y agregarle efectos + +El software Python `picamera` proporciona un número de efectos y configuraciones para cambiar la apariencia de tus imágenes. + +**Nota:** algunas configuraciones solo afectan la vista previa y no la imagen capturada, algunos afectan solo la imagen capturada y muchos otros afectan a ambas. + +### Define la resolución de la imagen + +Puedes cambiar la `resolución` de la imagen que el Módulo de Cámara produce. + +Por defecto, la resolución de la imagen está configurada segun la resolución de tu monitor. La resolución máxima es 2592×1944 para imágenes fijas, y 1920×1080 para grabaciones de video. + +- Utiliza el siguiente código para establecer la `resolución` al máximo y tomar una foto. + + **Nota:** también tienes que establecer la velocidad de los fotogramas por segundo a `15` para permitir esta resolución máxima. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +La resolución mínima es 64x64. + +- Intenta tomar una foto con la resolución mínima. + +### Agrega texto a tu imagen + +Puedes agregar texto a tu imagen usando el comando `annotate_text`. + +- Ejecuta este código para probarlo: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Cambia el aspecto del texto agregado + +- Establece el tamaño del texto con el siguiente código: + + ```python + camera.annotate_text_size = 50 + ``` + + Puedes establecer el tamaño del texto en cualquier valor entre `6` y `160`. El tamaño predeterminado es `32`. + +También es posible cambiar el color del texto. + +- En primer lugar, agrega `Color` a tu línea `import` en la parte superior del programa: + + ```python + from picamera import PiCamera, Color + ``` + +- Luego, debajo de la línea `import`, modifica el resto de tu código para que se vea así: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Cambia el brillo de la vista previa + +Puedes cambiar el brillo de la vista previa. El brillo predeterminado es `50` y puedes establecerlo en cualquier valor entre `0` y `100`. + +* Ejecuta el siguiente código para probarlo: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- El siguiente ciclo ajusta el brillo y también agrega texto para mostrar el nivel de brillo actual: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Cambia el contraste de la vista previa + +De manera similar al brillo de la vista previa, puedes cambiar el contraste de la vista previa. + +- Ejecuta el siguiente código para probarlo: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Agrega efectos de imagen geniales + +Puedes usar `camera.image_effect` para utilizar un efecto de imagen particular. + +Las opciones de efecto de imagen son las siguientes: + +* `ninguno` +* `negativo` +* `sobreexposición` +* `bosquejo` +* `eliminar el ruido de color` +* `relieve` +* `pintura al óleo` +* `eclosión` +* `dibujo a lápiz` +* `pastel` +* `acuarela` +* `película` +* `desenfoque` +* `saturación` +* `cambio de color` +* `desteñido` +* `estilo póster` +* `punto de color` +* `balance de color` +* `caricatura` +* `desentrelazado1` +* `desentrelazado2` + +El efecto predeterminado es `ninguno`. + +* Elige un efecto de imagen y pruébalo: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Ejecuta este código para probar **todos** los efectos de imágenes con `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Efectos](images/effects.jpg) + +### Establece el modo de exposición de la imagen + +Puedes usar `camera.exposure_mode` para establecer la exposición en un modo particular. + +Las opciones del modo de exposición son las siguientes: +* `apagado` +* `auto` +* `noche` +* `vista previa nocturna` +* `luz de fondo` +* `foco` +* `deportes` +* `nieve` +* `playa` +* `prolongada` +* `fps fijos` +* `estabilización de imagen` +* `fuegos artificiales` + +El modo predeterminado es `auto`. + +* Elige un modo de exposición y pruébalo: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* Puedes repetir todos los modos de exposición con `camera.EXPOSURE_MODES`, así como lo hiciste con efectos de imagen. + +### Cambiar el balance de blancos de la imagen + +Puedes utilizar `camera.awb_mode` para establecer el balance de blancos automático en un modo predeterminado. + +Los modos de balance de blancos disponibles son los siguientes: +* `apagado` +* `auto` +* `iluminación` +* `nublado` +* `sombra` +* `tungsteno` +* `fluorescente` +* `incandescente` +* `destello de luz` +* `horizonte` + +El modo predeterminado es `auto`. + +* Escoge un modo de balance de blancos automático y pruébalo: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* Puedes repetir el modo de balance de blancos automático `camera.AWB_MODES`, así como hiciste con efectos de imagen. \ No newline at end of file diff --git a/es-LA/step_9.md b/es-LA/step_9.md new file mode 100644 index 00000000..42060b55 --- /dev/null +++ b/es-LA/step_9.md @@ -0,0 +1,17 @@ +## ¿Qué sigue? + +Ahora que ya sabes usar tu Módulo de Cámara puedes, por ejemplo: +* Agregar botones para controlar la cámara con la ayuda del código Python [GPIO Zero](https://gpiozero.readthedocs.org/) +* Integrar la cámara con Minecraft Pi +* Publicar automáticamente las fotos de la cámara en Twitter + +Prueba estos proyectos de Módulo de Cámara para seguir aprendiendo: + +- Crea una película en [animación stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) +- Crea una [cabina fotográfica en Minecraft](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Consigue que [el oso Babbage tuitee fotos](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Construye un [detector parental](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Utiliza el Módulo de Cámara NoIR para crear una [caja de pájaros infrarroja](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +Para más información sobre cómo escribir código Python para controlar el Módulo de Cámara, mira la extensa [documentación de picamera ](https://picamera.readthedocs.org/). + diff --git a/fi-FI/images/Getting_Started_With_Picamera_TILE.png b/fi-FI/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/fi-FI/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/fi-FI/images/banner.png b/fi-FI/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/fi-FI/images/banner.png differ diff --git a/fi-FI/images/blur.jpg b/fi-FI/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/fi-FI/images/blur.jpg differ diff --git a/fi-FI/images/camera-module.png b/fi-FI/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/fi-FI/images/camera-module.png differ diff --git a/fi-FI/images/cartoon.jpg b/fi-FI/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/fi-FI/images/cartoon.jpg differ diff --git a/fi-FI/images/colorbalance.jpg b/fi-FI/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/fi-FI/images/colorbalance.jpg differ diff --git a/fi-FI/images/colorpoint.jpg b/fi-FI/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/fi-FI/images/colorpoint.jpg differ diff --git a/fi-FI/images/colorswap.jpg b/fi-FI/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/fi-FI/images/colorswap.jpg differ diff --git a/fi-FI/images/connect-camera-old.gif b/fi-FI/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/fi-FI/images/connect-camera-old.gif differ diff --git a/fi-FI/images/connect-camera.gif b/fi-FI/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/fi-FI/images/connect-camera.gif differ diff --git a/fi-FI/images/connect-camera.gif.gif b/fi-FI/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/fi-FI/images/connect-camera.gif.gif differ diff --git a/fi-FI/images/connect-camera1.png b/fi-FI/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/fi-FI/images/connect-camera1.png differ diff --git a/fi-FI/images/connect-camera2.png b/fi-FI/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/fi-FI/images/connect-camera2.png differ diff --git a/fi-FI/images/connect-camera3.png b/fi-FI/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/fi-FI/images/connect-camera3.png differ diff --git a/fi-FI/images/connect-camera4.png b/fi-FI/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/fi-FI/images/connect-camera4.png differ diff --git a/fi-FI/images/connect-camera5.png b/fi-FI/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/fi-FI/images/connect-camera5.png differ diff --git a/fi-FI/images/deinterlace1.jpg b/fi-FI/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/fi-FI/images/deinterlace1.jpg differ diff --git a/fi-FI/images/deinterlace2.jpg b/fi-FI/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/fi-FI/images/deinterlace2.jpg differ diff --git a/fi-FI/images/denoise.jpg b/fi-FI/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/fi-FI/images/denoise.jpg differ diff --git a/fi-FI/images/desktop-annotated.png b/fi-FI/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/fi-FI/images/desktop-annotated.png differ diff --git a/fi-FI/images/desktop.png b/fi-FI/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/fi-FI/images/desktop.png differ diff --git a/fi-FI/images/effects.jpg b/fi-FI/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/fi-FI/images/effects.jpg differ diff --git a/fi-FI/images/emboss.jpg b/fi-FI/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/fi-FI/images/emboss.jpg differ diff --git a/fi-FI/images/film.jpg b/fi-FI/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/fi-FI/images/film.jpg differ diff --git a/fi-FI/images/gpen.jpg b/fi-FI/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/fi-FI/images/gpen.jpg differ diff --git a/fi-FI/images/hatch.jpg b/fi-FI/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/fi-FI/images/hatch.jpg differ diff --git a/fi-FI/images/negative.jpg b/fi-FI/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/fi-FI/images/negative.jpg differ diff --git a/fi-FI/images/none.jpg b/fi-FI/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/fi-FI/images/none.jpg differ diff --git a/fi-FI/images/oilpaint.jpg b/fi-FI/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/fi-FI/images/oilpaint.jpg differ diff --git a/fi-FI/images/open-terminal-annotated.png b/fi-FI/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/fi-FI/images/open-terminal-annotated.png differ diff --git a/fi-FI/images/open-terminal.png b/fi-FI/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/fi-FI/images/open-terminal.png differ diff --git a/fi-FI/images/pastel.jpg b/fi-FI/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/fi-FI/images/pastel.jpg differ diff --git a/fi-FI/images/pi-camera-attached.jpg b/fi-FI/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/fi-FI/images/pi-camera-attached.jpg differ diff --git a/fi-FI/images/pi-configuration-interfaces-annotated.png b/fi-FI/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/fi-FI/images/pi-configuration-interfaces-annotated.png differ diff --git a/fi-FI/images/pi-configuration-interfaces.png b/fi-FI/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/fi-FI/images/pi-configuration-interfaces.png differ diff --git a/fi-FI/images/pi-configuration-menu.png b/fi-FI/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/fi-FI/images/pi-configuration-menu.png differ diff --git a/fi-FI/images/pi4-camera-port.png b/fi-FI/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/fi-FI/images/pi4-camera-port.png differ diff --git a/fi-FI/images/posterise.jpg b/fi-FI/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/fi-FI/images/posterise.jpg differ diff --git a/fi-FI/images/preview.jpg b/fi-FI/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/fi-FI/images/preview.jpg differ diff --git a/fi-FI/images/raspberry-pi.png b/fi-FI/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/fi-FI/images/raspberry-pi.png differ diff --git a/fi-FI/images/raspistill-help.png b/fi-FI/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/fi-FI/images/raspistill-help.png differ diff --git a/fi-FI/images/raspistill-image.png b/fi-FI/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/fi-FI/images/raspistill-image.png differ diff --git a/fi-FI/images/saturation.jpg b/fi-FI/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/fi-FI/images/saturation.jpg differ diff --git a/fi-FI/images/sketch.jpg b/fi-FI/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/fi-FI/images/sketch.jpg differ diff --git a/fi-FI/images/solarize.jpg b/fi-FI/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/fi-FI/images/solarize.jpg differ diff --git a/fi-FI/images/thonny-app-menu.png b/fi-FI/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/fi-FI/images/thonny-app-menu.png differ diff --git a/fi-FI/images/washedout.jpg b/fi-FI/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/fi-FI/images/washedout.jpg differ diff --git a/fi-FI/images/watercolor.jpg b/fi-FI/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/fi-FI/images/watercolor.jpg differ diff --git a/fi-FI/meta.yml b/fi-FI/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/fi-FI/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/fi-FI/step_1.md b/fi-FI/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/fi-FI/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/fi-FI/step_2.md b/fi-FI/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/fi-FI/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/fi-FI/step_3.md b/fi-FI/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/fi-FI/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/fi-FI/step_4.md b/fi-FI/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/fi-FI/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 Enter 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/fi-FI/step_5.md b/fi-FI/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/fi-FI/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`. \ No newline at end of file diff --git a/fi-FI/step_6.md b/fi-FI/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/fi-FI/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. \ No newline at end of file diff --git a/fi-FI/step_7.md b/fi-FI/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/fi-FI/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. + diff --git a/fi-FI/step_8.md b/fi-FI/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/fi-FI/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/fi-FI/step_9.md b/fi-FI/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/fi-FI/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/fr-FR/images/Getting_Started_With_Picamera_TILE.png b/fr-FR/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/fr-FR/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/fr-FR/images/banner.png b/fr-FR/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/fr-FR/images/banner.png differ diff --git a/fr-FR/images/blur.jpg b/fr-FR/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/fr-FR/images/blur.jpg differ diff --git a/fr-FR/images/camera-module.png b/fr-FR/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/fr-FR/images/camera-module.png differ diff --git a/fr-FR/images/cartoon.jpg b/fr-FR/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/fr-FR/images/cartoon.jpg differ diff --git a/fr-FR/images/colorbalance.jpg b/fr-FR/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/fr-FR/images/colorbalance.jpg differ diff --git a/fr-FR/images/colorpoint.jpg b/fr-FR/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/fr-FR/images/colorpoint.jpg differ diff --git a/fr-FR/images/colorswap.jpg b/fr-FR/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/fr-FR/images/colorswap.jpg differ diff --git a/fr-FR/images/connect-camera-old.gif b/fr-FR/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/fr-FR/images/connect-camera-old.gif differ diff --git a/fr-FR/images/connect-camera.gif b/fr-FR/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/fr-FR/images/connect-camera.gif differ diff --git a/fr-FR/images/connect-camera.gif.gif b/fr-FR/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/fr-FR/images/connect-camera.gif.gif differ diff --git a/fr-FR/images/connect-camera1.png b/fr-FR/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/fr-FR/images/connect-camera1.png differ diff --git a/fr-FR/images/connect-camera2.png b/fr-FR/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/fr-FR/images/connect-camera2.png differ diff --git a/fr-FR/images/connect-camera3.png b/fr-FR/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/fr-FR/images/connect-camera3.png differ diff --git a/fr-FR/images/connect-camera4.png b/fr-FR/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/fr-FR/images/connect-camera4.png differ diff --git a/fr-FR/images/connect-camera5.png b/fr-FR/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/fr-FR/images/connect-camera5.png differ diff --git a/fr-FR/images/deinterlace1.jpg b/fr-FR/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/fr-FR/images/deinterlace1.jpg differ diff --git a/fr-FR/images/deinterlace2.jpg b/fr-FR/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/fr-FR/images/deinterlace2.jpg differ diff --git a/fr-FR/images/denoise.jpg b/fr-FR/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/fr-FR/images/denoise.jpg differ diff --git a/fr-FR/images/desktop-annotated.png b/fr-FR/images/desktop-annotated.png new file mode 100644 index 00000000..c4e8bfee Binary files /dev/null and b/fr-FR/images/desktop-annotated.png differ diff --git a/fr-FR/images/desktop.png b/fr-FR/images/desktop.png new file mode 100644 index 00000000..c7deaa1f Binary files /dev/null and b/fr-FR/images/desktop.png differ diff --git a/fr-FR/images/effects.jpg b/fr-FR/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/fr-FR/images/effects.jpg differ diff --git a/fr-FR/images/emboss.jpg b/fr-FR/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/fr-FR/images/emboss.jpg differ diff --git a/fr-FR/images/film.jpg b/fr-FR/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/fr-FR/images/film.jpg differ diff --git a/fr-FR/images/gpen.jpg b/fr-FR/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/fr-FR/images/gpen.jpg differ diff --git a/fr-FR/images/hatch.jpg b/fr-FR/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/fr-FR/images/hatch.jpg differ diff --git a/fr-FR/images/negative.jpg b/fr-FR/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/fr-FR/images/negative.jpg differ diff --git a/fr-FR/images/none.jpg b/fr-FR/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/fr-FR/images/none.jpg differ diff --git a/fr-FR/images/oilpaint.jpg b/fr-FR/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/fr-FR/images/oilpaint.jpg differ diff --git a/fr-FR/images/open-terminal-annotated.png b/fr-FR/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/fr-FR/images/open-terminal-annotated.png differ diff --git a/fr-FR/images/open-terminal.png b/fr-FR/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/fr-FR/images/open-terminal.png differ diff --git a/fr-FR/images/pastel.jpg b/fr-FR/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/fr-FR/images/pastel.jpg differ diff --git a/fr-FR/images/pi-camera-attached.jpg b/fr-FR/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/fr-FR/images/pi-camera-attached.jpg differ diff --git a/fr-FR/images/pi-configuration-interfaces-annotated.png b/fr-FR/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..7002e6c1 Binary files /dev/null and b/fr-FR/images/pi-configuration-interfaces-annotated.png differ diff --git a/fr-FR/images/pi-configuration-interfaces.png b/fr-FR/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..f9d51258 Binary files /dev/null and b/fr-FR/images/pi-configuration-interfaces.png differ diff --git a/fr-FR/images/pi-configuration-menu.png b/fr-FR/images/pi-configuration-menu.png new file mode 100644 index 00000000..e3fffbf5 Binary files /dev/null and b/fr-FR/images/pi-configuration-menu.png differ diff --git a/fr-FR/images/pi4-camera-port.png b/fr-FR/images/pi4-camera-port.png new file mode 100644 index 00000000..90a3b100 Binary files /dev/null and b/fr-FR/images/pi4-camera-port.png differ diff --git a/fr-FR/images/posterise.jpg b/fr-FR/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/fr-FR/images/posterise.jpg differ diff --git a/fr-FR/images/preview.jpg b/fr-FR/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/fr-FR/images/preview.jpg differ diff --git a/fr-FR/images/raspberry-pi.png b/fr-FR/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/fr-FR/images/raspberry-pi.png differ diff --git a/fr-FR/images/raspistill-help.png b/fr-FR/images/raspistill-help.png new file mode 100644 index 00000000..9dd17001 Binary files /dev/null and b/fr-FR/images/raspistill-help.png differ diff --git a/fr-FR/images/raspistill-image.png b/fr-FR/images/raspistill-image.png new file mode 100644 index 00000000..4a2df755 Binary files /dev/null and b/fr-FR/images/raspistill-image.png differ diff --git a/fr-FR/images/saturation.jpg b/fr-FR/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/fr-FR/images/saturation.jpg differ diff --git a/fr-FR/images/sketch.jpg b/fr-FR/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/fr-FR/images/sketch.jpg differ diff --git a/fr-FR/images/solarize.jpg b/fr-FR/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/fr-FR/images/solarize.jpg differ diff --git a/fr-FR/images/thonny-app-menu.png b/fr-FR/images/thonny-app-menu.png new file mode 100644 index 00000000..9b06aa83 Binary files /dev/null and b/fr-FR/images/thonny-app-menu.png differ diff --git a/fr-FR/images/washedout.jpg b/fr-FR/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/fr-FR/images/washedout.jpg differ diff --git a/fr-FR/images/watercolor.jpg b/fr-FR/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/fr-FR/images/watercolor.jpg differ diff --git a/fr-FR/meta.yml b/fr-FR/meta.yml new file mode 100644 index 00000000..3c1d22a0 --- /dev/null +++ b/fr-FR/meta.yml @@ -0,0 +1,31 @@ +--- +title: Premiers pas avec le module caméra +hero_image: images/banner.png +description: Capturer des images et des vidéos avec le module caméra du Raspberry Pi et Python +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: Introduction + - + title: Ce dont tu auras besoin + - + title: Connecter le module caméra + - + title: Comment contrôler le module caméra via la ligne de commande + completion: + - engaged + - + title: Comment contrôler le module caméra avec du code Python + - + title: Capturer des images fixes avec du code Python + - + title: Enregistrer des vidéos avec du code Python + - + title: Comment modifier les paramètres d'image et ajouter des effets d'image + completion: + - internal + - + title: Et ensuite ? diff --git a/fr-FR/step_1.md b/fr-FR/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/fr-FR/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/fr-FR/step_2.md b/fr-FR/step_2.md new file mode 100644 index 00000000..770383b3 --- /dev/null +++ b/fr-FR/step_2.md @@ -0,0 +1,20 @@ +## Ce dont tu auras besoin + +### Un ordinateur Raspberry Pi avec un port module caméra + +Tous les modèles actuels du Raspberry Pi ont un port pour connecter le module caméra. + +![Raspberry Pi 3B+ avec le port du module caméra étiqueté](images/pi4-camera-port.png) + +**Remarque :** Si tu veux utiliser un Raspberry Pi Zero, tu as besoin d'une nappe caméra qui s'adapte au plus petit port du module caméra du Raspberry Pi Zero. + +### Module caméra du Raspberry Pi + +![Module caméra du Raspberry Pi](images/camera-module.png) + +Il existe deux versions du module caméra : + +* [La version standard](https://www.raspberrypi.org/products/camera-module-v2/), conçue pour prendre des photos en lumière normale +* [La version NoIR](https://www.raspberrypi.org/products/pi-noir-camera-v2/), qui n'a pas de filtre infrarouge, tu peux donc l'utiliser avec une source de lumière infrarouge pour prendre des photos dans l'obscurité + + diff --git a/fr-FR/step_3.md b/fr-FR/step_3.md new file mode 100644 index 00000000..e384d903 --- /dev/null +++ b/fr-FR/step_3.md @@ -0,0 +1,48 @@ +## Connecter le module caméra + +**Assure-toi que ton Raspberry Pi est éteint.** + +--- no-print --- + +1. Trouve le port du module caméra +2. Tire doucement sur les bords du clip en plastique du port +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. Remets le clip en plastique en 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. Trouve le port du module caméra. + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. Tire doucement sur les bords du clip en plastique du port. + +![port du module caméra soulevé](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. + +![nappe caméra inséré dans le port](images/connect-camera3.png) + +4. Remets le clip en plastique en place. + +![camera module port pushed down](images/connect-camera4.png) + +![camera module port pushed down](images/connect-camera4.png) + +--- /print-only --- + +- Démarre ton Raspberry Pi. + +- Va dans le menu principal et ouvre l'outil **Configuration du Raspberry Pi**. + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- Sélectionne l'onglet **Interfaces** et assure-toi que la caméra est **activée** : + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- Redémarre ton Raspberry Pi. diff --git a/fr-FR/step_4.md b/fr-FR/step_4.md new file mode 100644 index 00000000..ac3a3e2e --- /dev/null +++ b/fr-FR/step_4.md @@ -0,0 +1,41 @@ +## Comment contrôler le module caméra via la ligne de commande + +Maintenant que ton module caméra est connecté et que le logiciel est activé, essaie les outils de ligne de commande `raspistill` et `raspivid`. + +- Ouvre une fenêtre de terminal en cliquant sur l'icône du moniteur noir dans la barre des tâches : + +![Ouvrir le terminal](images/open-terminal-annotated.png) + +- Saisis la commande suivante pour capturer une image fixe et l'enregistrer sur le bureau : + +```bash +raspistill -o Desktop/image.jpg +``` + +![commande raspistill saisie dans le terminal](images/raspistill-image.png) + +- Appuie sur Entrée pour exécuter la commande. + +Lorsque la commande s'exécute, tu peux voir l'aperçu de la caméra s'ouvrir pendant cinq secondes avant qu'une image fixe ne soit capturée. + +- Recherche l'icône du fichier image sur le bureau et double-clique sur l'icône du fichier pour ouvrir l'image. + + ![Image sur le bureau](images/desktop-annotated.png) + +En ajoutant différentes options, tu peux définir la taille et l'apparence de l'image que prend la commande `raspistill`. + +- Par exemple, ajoute `-h` et `-w` pour modifier la hauteur et la largeur de l'image : + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- Enregistre maintenant une vidéo avec le module caméra en utilisant la commande `raspivid` : + +```bash +raspivid -o Desktop/video.h264 +``` + +- Pour lire le fichier vidéo, double-clique sur l'icône du fichier `video.h264` sur le bureau pour l'ouvrir dans VLC Media Player. + +Pour plus d'informations et d'autres options que tu peux utiliser avec ces commandes, lis la documentation pour [raspistill](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) et la [documentation pour raspivid](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md). diff --git a/fr-FR/step_5.md b/fr-FR/step_5.md new file mode 100644 index 00000000..f178a994 --- /dev/null +++ b/fr-FR/step_5.md @@ -0,0 +1,49 @@ +## Comment contrôler le module caméra avec du code Python + +La bibliothèque Python `picamera` te permet de contrôler ton module caméra et de créer des projets incroyables. + +- Ouvre un éditeur Python 3, tel que **Thonny Python IDE** : + + ![Ouvrir Thonny](images/thonny-app-menu.png) + +- Ouvre un nouveau fichier et enregistre-le sous `camera.py`. + + **Remarque :** il est important que tu **ne sauvegardes jamais le fichier en tant que `picamera.py`**. + +- Entre le code suivant : + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- Enregistre et teste ton programme. L'aperçu de la caméra devrait s'afficher pendant cinq secondes, puis se refermer. + + ![Aperçu de l'image](images/preview.jpg) + + **Remarque :** l'aperçu de la caméra ne fonctionne que lorsqu'un moniteur est connecté à ton Raspberry Pi. Si tu utilises un accès à distance (tel que SSH ou VNC), tu ne verras pas l'aperçu de la caméra. + +- Si ton aperçu est à l'envers, tu peux le faire pivoter de 180 degrés avec le code suivant : + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + Tu peux faire pivoter l'image de `90`, `180` ou `270` degrés. Pour réinitialiser l'image, définis la `rotation` sur `0` degrés. + +Il est préférable de rendre l'aperçu légèrement transparent afin de voir si des erreurs se produisent dans ton programme lorsque l'aperçu est activé. + +- Rendre l'aperçu de la caméra transparent en définissant un niveau `alpha` : + + ```python + camera.start_preview(alpha=200) + ``` + + La valeur `alpha` peut être n'importe quel nombre compris entre `0` et `255`. \ No newline at end of file diff --git a/fr-FR/step_6.md b/fr-FR/step_6.md new file mode 100644 index 00000000..6e4303f1 --- /dev/null +++ b/fr-FR/step_6.md @@ -0,0 +1,38 @@ +## Capturer des images fixes avec du code Python + +Utilise maintenant le module caméra et Python pour capturer des images fixes. + +- Modifie ton code pour ajouter une ligne `camera.capture()` : + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **Remarque :** c'est important d'utiliser un `sleep` pendant au moins deux secondes avant de capturer une image, car cela donne au capteur de l'appareil photo le temps de détecter les niveaux de lumière. + +- Exécute le code. + +Tu devrais voir l'aperçu de la caméra pendant cinq secondes, et ensuite une image fixe devrait être capturée. Pendant la prise de vue, tu peux voir l'aperçu s'ajuster brièvement à une résolution différente. + +Ta nouvelle image devrait être enregistrée sur le bureau. + +- Maintenant, ajoute une boucle pour prendre cinq images d'affilée : + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + La variable `i` compte le nombre de fois que la boucle a été exécutée, de `0` à `4`. Par conséquent, les images sont enregistrées sous `image0.jpg`, `image1.jpg`, et ainsi de suite. + +- Exécute à nouveau le code et maintiens le module caméra en position. + +La caméra doit prendre une image toutes les cinq secondes. Une fois la cinquième image prise, l'aperçu se ferme. + +- Regarde ton bureau pour trouver les cinq nouvelles images. \ No newline at end of file diff --git a/fr-FR/step_7.md b/fr-FR/step_7.md new file mode 100644 index 00000000..3485aa01 --- /dev/null +++ b/fr-FR/step_7.md @@ -0,0 +1,20 @@ +## Enregistrer des vidéos avec du code Python + +Maintenant enregistre une vidéo ! + +- Modifie ton code pour supprimer `capture()` et ajoute à la place `start_recording()` et `stop_recording()` + + Ton code devrait ressembler à ceci : + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- Exécute le code. + +Ton Raspberry Pi devrait ouvrir un aperçu, enregistrer 5 secondes de vidéo, puis fermer l'aperçu. + diff --git a/fr-FR/step_8.md b/fr-FR/step_8.md new file mode 100644 index 00000000..385af1e6 --- /dev/null +++ b/fr-FR/step_8.md @@ -0,0 +1,228 @@ +## Comment modifier les paramètres d'image et ajouter des effets d'image + +Le logiciel Python `picamera` fournit un certain nombre d'effets et de configurations pour changer l'apparence de tes images. + +**Remarque :** certains paramètres n'affectent que l'aperçu et non l'image capturée, certains n'affectent que l'image capturée, et beaucoup d'autres affectent les deux. + +### Définir la résolution de l'image + +Tu peux modifier la `résolution` de l'image prise par le module caméra. + +Par défaut, la résolution de l'image est définie sur la résolution de ton moniteur. La résolution maximale est de 2592 × 1944 pour les images fixes et de 1920 × 1080 pour l'enregistrement vidéo. + +- Utilise le code suivant pour définir la `résolution` au maximum et capture une image. + + **Remarque :** tu dois également définir le taux d'images à `15` pour activer cette résolution maximale. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +La résolution minimale est de 64 × 64. + +- Essaie de capturer une image avec la résolution minimale. + +### Ajouter du texte à ton image + +Tu peux ajouter du texte à ton image à l'aide de la commande `annotate_text`. + +- Exécute ce code pour l'essayer : + + ```python + camera.start_preview() + camera.annotate_text = "Bonjour le monde !" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Modifier l'apparence du texte ajouté + +- Définis la taille du texte avec le code suivant : + + ```python + camera.annotate_text_size = 50 + ``` + + Tu peux définir la taille du texte sur n'importe quelle valeur comprise entre `6` et `160`. La taille par défaut est `32`. + +Il est également possible de modifier la couleur du texte. + +- Tout d'abord, ajoute `Color` à ta ligne `import` en haut du programme : + + ```python + from picamera import PiCamera, Color + ``` + +- Ensuite, sous la ligne `import` , modifie le reste de ton code pour qu'il ressemble à ceci : + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Bonjour le monde " + sleep(5) + camera.stop_preview() + ``` + +### Modifier la luminosité de l'aperçu + +Tu peux modifier la luminosité de l'aperçu. La luminosité par défaut est `50` et tu peux la régler sur n'importe quelle valeur comprise entre `0` et `100`. + +* Exécute le code suivant pour essayer ceci : + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- La boucle suivante ajuste la luminosité et ajoute également du texte pour afficher le niveau de luminosité actuelle : + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Modifier le contraste de l'aperçu + +De la même manière que la luminosité de l'aperçu, tu peux modifier le contraste de l'aperçu. + +- Exécute le code suivant pour essayer ceci : + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Ajouter des effets d'image sympas + +Tu peux utiliser `camera.image_effect` pour appliquer un effet d'image particulier. + +Les options d'effet d'image sont : + +* `none (aucun)` +* `negative (négatif)` +* `solarize (solariser)` +* `sketch (dessin)` +* `denoise (antibruit)` +* `emboss (relief)` +* `oilpaint (peinture à l'huile)` +* `hatch (hachurer)` +* `gpen` +* `pastel` +* `watercolor (aquarelle)` +* `film` +* `blur (flou)` +* `saturation` +* `colorswap (permutation de couleur)` +* `washedout (délavé)` +* `posterise (postériser)` +* `colorpoint (point de couleur)` +* `colorbalance (balance des couleurs)` +* `cartoon (dessin animé)` +* `deinterlace1 (désentrelacement1)` +* `deinterlace2 (désentrelacement2)` + +L'effet par défaut est `none`. + +* Choisis un effet d'image et essaie-le : + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Exécute ce code pour boucler sur **tous** les effets d'image avec `camera.IMAGE_EFFECTS` : + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effets](images/effects.jpg) + +### Définir le mode d'exposition de l'image + +Tu peux utiliser `camera.exposure_mode` pour définir l'exposition sur un mode particulier. + +Les options de mode d'exposition sont : +* `off (désactivé)` +* `auto (automatique)` +* `night (nuit)` +* `nightpreview (vision nocturne)` +* `backlight (éclairage de derrière)` +* `spotlight (projecteur)` +* `sports` +* `snow (neige)` +* `beach (plage)` +* `verylong (très long)` +* `fixedfps (image fixe par seconde )` +* `antishake (anti-tremblement)` +* `fireworks (feux d'artifice)` + +Le mode par défaut est `auto`. + +* Choisis un mode d'exposition et essaie-le : + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* Tu peux boucler tous les modes d'exposition avec `camera.EXPOSURE_MODES`, comme tu l'as fait pour les effets d'image. + +### Modifier la balance des blancs de l'image + +Tu peux utiliser `camera.awb_mode` pour régler la balance des blancs automatique sur un mode prédéfini. + +Les modes de balance des blancs disponibles sont : +* `off (éteint)` +* `auto (automatique)` +* `sunlight (lumière du soleil)` +* `cloudy (nuageux)` +* `shade (ombre)` +* `tungsten (tungstène)` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +La valeur par défaut est `auto`. + +* Choisis un mode de balance des blancs automatique et essaie-le : + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* Tu peux boucler tous les modes de balance des blancs automatique avec `camera.AWB_MODES`, comme tu l'as fait pour les effets d'image. \ No newline at end of file diff --git a/fr-FR/step_9.md b/fr-FR/step_9.md new file mode 100644 index 00000000..afefa4f8 --- /dev/null +++ b/fr-FR/step_9.md @@ -0,0 +1,17 @@ +## Et ensuite ? + +Maintenant que tu sais comment utiliser ton module caméra, tu peux par exemple : +* Ajouter des boutons pour contrôler la caméra à l'aide du code Python [GPIO Zero](https://gpiozero.readthedocs.org/) +* Intégrer la caméra avec Minecraft Pi +* Publier automatiquement les images de la caméra sur Twitter + +Essaie ces projets de module caméra pour en savoir plus : + +- Créer un film à [bouton poussoir stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) +- Créer un [photomaton Minecraft](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Obtenir des [ours Babbage pour tweeter des images](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Construire un [détecteur parent](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Utiliser le module caméra NoIR pour créer une [niche à oiseaux infrarouge](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +Pour plus d'informations sur l'écriture de code Python pour contrôler le module caméra, consulte la grande documentation [picamera](https://picamera.readthedocs.org/). + diff --git a/he-IL/images/Getting_Started_With_Picamera_TILE.png b/he-IL/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/he-IL/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/he-IL/images/banner.png b/he-IL/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/he-IL/images/banner.png differ diff --git a/he-IL/images/blur.jpg b/he-IL/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/he-IL/images/blur.jpg differ diff --git a/he-IL/images/camera-module.png b/he-IL/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/he-IL/images/camera-module.png differ diff --git a/he-IL/images/cartoon.jpg b/he-IL/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/he-IL/images/cartoon.jpg differ diff --git a/he-IL/images/colorbalance.jpg b/he-IL/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/he-IL/images/colorbalance.jpg differ diff --git a/he-IL/images/colorpoint.jpg b/he-IL/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/he-IL/images/colorpoint.jpg differ diff --git a/he-IL/images/colorswap.jpg b/he-IL/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/he-IL/images/colorswap.jpg differ diff --git a/he-IL/images/connect-camera-old.gif b/he-IL/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/he-IL/images/connect-camera-old.gif differ diff --git a/he-IL/images/connect-camera.gif b/he-IL/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/he-IL/images/connect-camera.gif differ diff --git a/he-IL/images/connect-camera.gif.gif b/he-IL/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/he-IL/images/connect-camera.gif.gif differ diff --git a/he-IL/images/connect-camera1.png b/he-IL/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/he-IL/images/connect-camera1.png differ diff --git a/he-IL/images/connect-camera2.png b/he-IL/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/he-IL/images/connect-camera2.png differ diff --git a/he-IL/images/connect-camera3.png b/he-IL/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/he-IL/images/connect-camera3.png differ diff --git a/he-IL/images/connect-camera4.png b/he-IL/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/he-IL/images/connect-camera4.png differ diff --git a/he-IL/images/connect-camera5.png b/he-IL/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/he-IL/images/connect-camera5.png differ diff --git a/he-IL/images/deinterlace1.jpg b/he-IL/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/he-IL/images/deinterlace1.jpg differ diff --git a/he-IL/images/deinterlace2.jpg b/he-IL/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/he-IL/images/deinterlace2.jpg differ diff --git a/he-IL/images/denoise.jpg b/he-IL/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/he-IL/images/denoise.jpg differ diff --git a/he-IL/images/desktop-annotated.png b/he-IL/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/he-IL/images/desktop-annotated.png differ diff --git a/he-IL/images/desktop.png b/he-IL/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/he-IL/images/desktop.png differ diff --git a/he-IL/images/effects.jpg b/he-IL/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/he-IL/images/effects.jpg differ diff --git a/he-IL/images/emboss.jpg b/he-IL/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/he-IL/images/emboss.jpg differ diff --git a/he-IL/images/film.jpg b/he-IL/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/he-IL/images/film.jpg differ diff --git a/he-IL/images/gpen.jpg b/he-IL/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/he-IL/images/gpen.jpg differ diff --git a/he-IL/images/hatch.jpg b/he-IL/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/he-IL/images/hatch.jpg differ diff --git a/he-IL/images/negative.jpg b/he-IL/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/he-IL/images/negative.jpg differ diff --git a/he-IL/images/none.jpg b/he-IL/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/he-IL/images/none.jpg differ diff --git a/he-IL/images/oilpaint.jpg b/he-IL/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/he-IL/images/oilpaint.jpg differ diff --git a/he-IL/images/open-terminal-annotated.png b/he-IL/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/he-IL/images/open-terminal-annotated.png differ diff --git a/he-IL/images/open-terminal.png b/he-IL/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/he-IL/images/open-terminal.png differ diff --git a/he-IL/images/pastel.jpg b/he-IL/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/he-IL/images/pastel.jpg differ diff --git a/he-IL/images/pi-camera-attached.jpg b/he-IL/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/he-IL/images/pi-camera-attached.jpg differ diff --git a/he-IL/images/pi-configuration-interfaces-annotated.png b/he-IL/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/he-IL/images/pi-configuration-interfaces-annotated.png differ diff --git a/he-IL/images/pi-configuration-interfaces.png b/he-IL/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/he-IL/images/pi-configuration-interfaces.png differ diff --git a/he-IL/images/pi-configuration-menu.png b/he-IL/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/he-IL/images/pi-configuration-menu.png differ diff --git a/he-IL/images/pi4-camera-port.png b/he-IL/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/he-IL/images/pi4-camera-port.png differ diff --git a/he-IL/images/posterise.jpg b/he-IL/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/he-IL/images/posterise.jpg differ diff --git a/he-IL/images/preview.jpg b/he-IL/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/he-IL/images/preview.jpg differ diff --git a/he-IL/images/raspberry-pi.png b/he-IL/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/he-IL/images/raspberry-pi.png differ diff --git a/he-IL/images/raspistill-help.png b/he-IL/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/he-IL/images/raspistill-help.png differ diff --git a/he-IL/images/raspistill-image.png b/he-IL/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/he-IL/images/raspistill-image.png differ diff --git a/he-IL/images/saturation.jpg b/he-IL/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/he-IL/images/saturation.jpg differ diff --git a/he-IL/images/sketch.jpg b/he-IL/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/he-IL/images/sketch.jpg differ diff --git a/he-IL/images/solarize.jpg b/he-IL/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/he-IL/images/solarize.jpg differ diff --git a/he-IL/images/thonny-app-menu.png b/he-IL/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/he-IL/images/thonny-app-menu.png differ diff --git a/he-IL/images/washedout.jpg b/he-IL/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/he-IL/images/washedout.jpg differ diff --git a/he-IL/images/watercolor.jpg b/he-IL/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/he-IL/images/watercolor.jpg differ diff --git a/he-IL/meta.yml b/he-IL/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/he-IL/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/he-IL/step_1.md b/he-IL/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/he-IL/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/he-IL/step_2.md b/he-IL/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/he-IL/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/he-IL/step_3.md b/he-IL/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/he-IL/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/he-IL/step_4.md b/he-IL/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/he-IL/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 Enter 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/he-IL/step_5.md b/he-IL/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/he-IL/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`. \ No newline at end of file diff --git a/he-IL/step_6.md b/he-IL/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/he-IL/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. \ No newline at end of file diff --git a/he-IL/step_7.md b/he-IL/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/he-IL/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. + diff --git a/he-IL/step_8.md b/he-IL/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/he-IL/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/he-IL/step_9.md b/he-IL/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/he-IL/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/hi-IN/images/Getting_Started_With_Picamera_TILE.png b/hi-IN/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/hi-IN/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/hi-IN/images/banner.png b/hi-IN/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/hi-IN/images/banner.png differ diff --git a/hi-IN/images/blur.jpg b/hi-IN/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/hi-IN/images/blur.jpg differ diff --git a/hi-IN/images/camera-module.png b/hi-IN/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/hi-IN/images/camera-module.png differ diff --git a/hi-IN/images/cartoon.jpg b/hi-IN/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/hi-IN/images/cartoon.jpg differ diff --git a/hi-IN/images/colorbalance.jpg b/hi-IN/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/hi-IN/images/colorbalance.jpg differ diff --git a/hi-IN/images/colorpoint.jpg b/hi-IN/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/hi-IN/images/colorpoint.jpg differ diff --git a/hi-IN/images/colorswap.jpg b/hi-IN/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/hi-IN/images/colorswap.jpg differ diff --git a/hi-IN/images/connect-camera-old.gif b/hi-IN/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/hi-IN/images/connect-camera-old.gif differ diff --git a/hi-IN/images/connect-camera.gif b/hi-IN/images/connect-camera.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/hi-IN/images/connect-camera.gif differ diff --git a/hi-IN/images/connect-camera.gif.gif b/hi-IN/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/hi-IN/images/connect-camera.gif.gif differ diff --git a/hi-IN/images/connect-camera1.png b/hi-IN/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/hi-IN/images/connect-camera1.png differ diff --git a/hi-IN/images/connect-camera2.png b/hi-IN/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/hi-IN/images/connect-camera2.png differ diff --git a/hi-IN/images/connect-camera3.png b/hi-IN/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/hi-IN/images/connect-camera3.png differ diff --git a/hi-IN/images/connect-camera4.png b/hi-IN/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/hi-IN/images/connect-camera4.png differ diff --git a/hi-IN/images/connect-camera5.png b/hi-IN/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/hi-IN/images/connect-camera5.png differ diff --git a/hi-IN/images/deinterlace1.jpg b/hi-IN/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/hi-IN/images/deinterlace1.jpg differ diff --git a/hi-IN/images/deinterlace2.jpg b/hi-IN/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/hi-IN/images/deinterlace2.jpg differ diff --git a/hi-IN/images/denoise.jpg b/hi-IN/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/hi-IN/images/denoise.jpg differ diff --git a/hi-IN/images/desktop-annotated.png b/hi-IN/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/hi-IN/images/desktop-annotated.png differ diff --git a/hi-IN/images/desktop.png b/hi-IN/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/hi-IN/images/desktop.png differ diff --git a/hi-IN/images/effects.jpg b/hi-IN/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/hi-IN/images/effects.jpg differ diff --git a/hi-IN/images/emboss.jpg b/hi-IN/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/hi-IN/images/emboss.jpg differ diff --git a/hi-IN/images/film.jpg b/hi-IN/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/hi-IN/images/film.jpg differ diff --git a/hi-IN/images/gpen.jpg b/hi-IN/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/hi-IN/images/gpen.jpg differ diff --git a/hi-IN/images/hatch.jpg b/hi-IN/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/hi-IN/images/hatch.jpg differ diff --git a/hi-IN/images/negative.jpg b/hi-IN/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/hi-IN/images/negative.jpg differ diff --git a/hi-IN/images/none.jpg b/hi-IN/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/hi-IN/images/none.jpg differ diff --git a/hi-IN/images/oilpaint.jpg b/hi-IN/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/hi-IN/images/oilpaint.jpg differ diff --git a/hi-IN/images/open-terminal-annotated.png b/hi-IN/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/hi-IN/images/open-terminal-annotated.png differ diff --git a/hi-IN/images/open-terminal.png b/hi-IN/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/hi-IN/images/open-terminal.png differ diff --git a/hi-IN/images/pastel.jpg b/hi-IN/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/hi-IN/images/pastel.jpg differ diff --git a/hi-IN/images/pi-camera-attached.jpg b/hi-IN/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/hi-IN/images/pi-camera-attached.jpg differ diff --git a/hi-IN/images/pi-configuration-interfaces-annotated.png b/hi-IN/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/hi-IN/images/pi-configuration-interfaces-annotated.png differ diff --git a/hi-IN/images/pi-configuration-interfaces.png b/hi-IN/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/hi-IN/images/pi-configuration-interfaces.png differ diff --git a/hi-IN/images/pi-configuration-menu.png b/hi-IN/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/hi-IN/images/pi-configuration-menu.png differ diff --git a/hi-IN/images/pi4-camera-port.png b/hi-IN/images/pi4-camera-port.png new file mode 100644 index 00000000..461a0e1f Binary files /dev/null and b/hi-IN/images/pi4-camera-port.png differ diff --git a/hi-IN/images/posterise.jpg b/hi-IN/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/hi-IN/images/posterise.jpg differ diff --git a/hi-IN/images/preview.jpg b/hi-IN/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/hi-IN/images/preview.jpg differ diff --git a/hi-IN/images/raspberry-pi.png b/hi-IN/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/hi-IN/images/raspberry-pi.png differ diff --git a/hi-IN/images/raspistill-help.png b/hi-IN/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/hi-IN/images/raspistill-help.png differ diff --git a/hi-IN/images/raspistill-image.png b/hi-IN/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/hi-IN/images/raspistill-image.png differ diff --git a/hi-IN/images/saturation.jpg b/hi-IN/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/hi-IN/images/saturation.jpg differ diff --git a/hi-IN/images/sketch.jpg b/hi-IN/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/hi-IN/images/sketch.jpg differ diff --git a/hi-IN/images/solarize.jpg b/hi-IN/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/hi-IN/images/solarize.jpg differ diff --git a/hi-IN/images/thonny-app-menu.png b/hi-IN/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/hi-IN/images/thonny-app-menu.png differ diff --git a/hi-IN/images/washedout.jpg b/hi-IN/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/hi-IN/images/washedout.jpg differ diff --git a/hi-IN/images/watercolor.jpg b/hi-IN/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/hi-IN/images/watercolor.jpg differ diff --git a/hi-IN/meta.yml b/hi-IN/meta.yml new file mode 100644 index 00000000..f2db3832 --- /dev/null +++ b/hi-IN/meta.yml @@ -0,0 +1,31 @@ +--- +title: कैमरा मॉड्यूल के साथ शुरुआत करना +hero_image: images/banner.png +description: Raspberry Pi कैमरा मॉड्यूल और Python के साथ चित्र और वीडियो लें +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: भूमिका + - + title: आपको किन चीज़ों की आवश्यकता होगी + - + title: कैमरा मॉड्यूल कनेक्ट करें + - + title: कमांड लाइन के माध्यम से कैमरा मॉड्यूल को कैसे नियंत्रित करें + completion: + - engaged + - + title: Python कोड के साथ कैमरा मॉड्यूल को कैसे नियंत्रित करें + - + title: Python कोड के साथ स्थिर तस्वीरें ले + - + title: Python कोड के साथ वीडियो रिकॉर्ड करें + - + title: चित्र सेटिंग्स कैसे बदलें और चित्र प्रभाव जोड़ें + completion: + - internal + - + title: आगे क्या? diff --git a/hi-IN/step_1.md b/hi-IN/step_1.md new file mode 100644 index 00000000..04e72f68 --- /dev/null +++ b/hi-IN/step_1.md @@ -0,0 +1,9 @@ +## भूमिका + +[[[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/hi-IN/step_2.md b/hi-IN/step_2.md new file mode 100644 index 00000000..7b5ab8ff --- /dev/null +++ b/hi-IN/step_2.md @@ -0,0 +1,20 @@ +## आपको किन चीज़ों की आवश्यकता होगी + +### कैमरा मॉड्यूल पोर्ट के साथ Raspberry Pi कंप्यूटर + +Raspberry Pi के सभी मौजूदा मॉडल में कैमरा मॉड्यूल को जोड़ने के लिए एक पोर्ट है। + +![Raspberry Pi 3B+ जिसमें कैमरा मॉड्यूल अंकित किया हुआ है](images/pi4-camera-port.png) + +**ध्यान दें:** यदि आप Raspberry Pi Zero का उपयोग करना चाहते हैं, तो आपको एक कैमरा मॉड्यूल रिबन केबल की आवश्यकता होती है जो Raspberry Pi Zero के छोटे कैमरा मॉड्यूल पोर्ट में फिट आता है। + +### Raspberry Pi कैमरा मॉड्यूल + +![Raspberry Pi कैमरा मॉड्यूल](images/camera-module.png) + +कैमरा मॉड्यूल के दो संस्करण हैं: + +* [Standard संस्करण](https://www.raspberrypi.org/products/camera-module-v2/), जिसे सामान्य प्रकाश में चित्र लेने के लिए डिज़ाइन किया गया है +* [NoIR version](https://www.raspberrypi.org/products/pi-noir-camera-v2/), जिसमें इन्फ्रारेड फ़िल्टर नहीं है, इसलिए आप इसे अंधेरे में तस्वीरें लेने के लिए एक इन्फ्रारेड प्रकाश स्रोत के साथ मिलकर इस्तेमाल कर सकते हैं + + diff --git a/hi-IN/step_3.md b/hi-IN/step_3.md new file mode 100644 index 00000000..650ce6b4 --- /dev/null +++ b/hi-IN/step_3.md @@ -0,0 +1,48 @@ +## कैमरा मॉड्यूल कनेक्ट करें + +**सुनिश्चित करें कि आपका Raspberry Pi बंद है।** + +--- no-print --- + +1. कैमरा मॉड्यूल पोर्ट का पता लगाएँ +2. पोर्ट के प्लास्टिक क्लिप के किनारों पर धीरे से ऊपर खींचें +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. प्लास्टिक क्लिप को वापस उसकी जगह पर लगा दें + +![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. कैमरा मॉड्यूल पोर्ट का पता लगाएँ। + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. पोर्ट के प्लास्टिक क्लिप के किनारों पर धीरे से ऊपर खींचें + +![कैमरा मॉड्यूल पोर्ट ऊपर उठा हुआ](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. + +![कैमरा मॉड्यूल रिबन केबल पोर्ट में डाला गया](images/connect-camera3.png) + +4. प्लास्टिक क्लिप को वापस उसकी जगह पर लगा दें। + +![कैमरा मॉड्यूल पोर्ट नीचे दबाया हुआ](images/connect-camera4.png) + +![कैमरा मॉड्यूल पोर्ट नीचे दबाया हुआ](images/connect-camera4.png) + +--- /print-only --- + +- अपने Raspberry Pi को शुरू करना। + +- मुख्य मेन्यू पर जाएं और **Raspberry Pi Configuration** टूल खोलें। + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- **Interfaces** टैब चुनें और सुनिश्चित करें कि कैमरा **enabled** है: + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- अपने Raspberry Pi को बंद करके फिरसे शुरू करें। diff --git a/hi-IN/step_4.md b/hi-IN/step_4.md new file mode 100644 index 00000000..f2bec3c4 --- /dev/null +++ b/hi-IN/step_4.md @@ -0,0 +1,41 @@ +## कमांड लाइन के माध्यम से कैमरा मॉड्यूल को कैसे नियंत्रित करें + +अब आपका कैमरा मॉड्यूल जुड़ा हुआ है और सॉफ्टवेयर सक्षम है, कमांड लाइन टूल `raspistill` और `raspivid` को इस्तेमाल करने की कोशिश करें। + +- टास्कबार में ब्लैक मॉनिटर आइकन पर क्लिक करके एक टर्मिनल विंडो खोलें: + +![टर्मिनल खोलें](images/open-terminal-annotated.png) + +- एक स्थिर चित्र लेने के लिए और इसे डेस्कटॉप पर सेव करने के लिए निम्न कमांड टाइप करें: + +```bash +raspistill -o Desktop/image.jpg +``` + +![raspistill कमांड टर्मिनल में लिखा हुआ](images/raspistill-image.png) + +- कमांड चलाने के लिए Enter दबाएँ। + +जब कमांड चलता है, आप देख सकते हैं की स्थिर तस्वीर लेने से पहले कैमरा पूर्वावलोकन पाँच सेकंड के लिए खुलता है। + +- डेस्कटॉप पर चित्र फ़ाइल आइकन के लिए देखें, और चित्र को खोलने के लिए फ़ाइल आइकन पर डबल-क्लिक करें। + + ![डेस्कटॉप पर चित्र](images/desktop-annotated.png) + +विभिन्न विकल्पों को जोड़कर, आप `raspistill` कमांड द्वारा लिए गए चित्र के आकार और रूप को सेट कर सकते हैं । + +- उदाहरण के लिए, चित्र की ऊंचाई और चौड़ाई बदलने के लिए `-h` और `-w` जोड़ें: + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- अब निम्नलिखित `raspivid` कमांड का उपयोग करके कैमरा मॉड्यूल के साथ एक वीडियो रिकॉर्ड करें: + +```bash +raspivid -o Desktop/video.h264 +``` + +- वीडियो फ़ाइल को वीएलसी (VLC) मीडिया प्लेयर में खोलने के लिए डेस्कटॉप पर `video.h264` फ़ाइल आइकन पर डबल-क्लिक करें। + +अधिक जानकारी और अन्य विकल्पों के लिए जिनका आप इन कमांड्स के साथ उपयोग कर सकते हैं, [raspistill दस्तावेज़ीकरण](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) और [raspivid दस्तावेज़ीकरण](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md) पढ़ें। diff --git a/hi-IN/step_5.md b/hi-IN/step_5.md new file mode 100644 index 00000000..1e2287c7 --- /dev/null +++ b/hi-IN/step_5.md @@ -0,0 +1,49 @@ +## Python कोड के साथ कैमरा मॉड्यूल को कैसे नियंत्रित करें + +Python `picamera` लाइब्रेरी आपको अपने कैमरा मॉड्यूल को नियंत्रित करने और अद्भुत प्रोजेक्ट्स बनाने की अनुमति देती है। + +- एक Python 3 एडिटर खोलें, जैसे **Thonny Python IDE**: + + ![Thonny खोलें](images/thonny-app-menu.png) + +- एक नयी फ़ाइल बनाएं और उसे `camera.py` के नाम से सेव करें। + + **ध्यान दें:** यह महत्वपूर्ण है कि आप **कभी भी फाइल को `picamera.py` के नाम से सेव न करें**। + +- निम्नलिखित कोड को दर्ज करें: + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- अपना प्रोग्राम सेव करें और चलाएं। कैमरा पूर्वावलोकन पांच सेकंड के लिए दिखाया जाना चाहिए और फिर बंद हो जाना चाहिए। + + ![चित्र पूर्वावलोकन](images/preview.jpg) + + **ध्यान दें:** कैमरा पूर्वावलोकन केवल तभी काम करता है जब कोई मॉनिटर आपके Raspberry Pi से जुड़ा होता है। यदि आप रिमोट एक्सेस (जैसे SSH या VNC) का उपयोग कर रहे हैं, तो आप कैमरा पूर्वावलोकन नहीं देखेंगे। + +- यदि आपका पूर्वावलोकन उल्टा है, तो आप इसे निम्न कोड के साथ 180 डिग्री तक घुमा सकते हैं: + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + आप चित्र को `90`, `180`, या `270` डिग्री से घुमा सकते हैं। चित्र को रीसेट करने के लिए, `rotation` को `0` डिग्री पर सेट करें। + +पूर्वावलोकन को थोड़ा आरपार देखने योग्य बनाना सबसे अच्छा है ताकि आप देख सकें कि पूर्वावलोकन चालू होने के दौरान आपके प्रोग्राम में त्रुटियां हैं या नहीं। + +- `alpha` लेवल सेट करके कैमरा पूर्वावलोकन आरपार देखने योग्य बनाएं: + + ```python + camera.start_preview(alpha=200) + ``` + + `alpha` मान `0` और `255` के बीच कोई भी संख्या हो सकती है। \ No newline at end of file diff --git a/hi-IN/step_6.md b/hi-IN/step_6.md new file mode 100644 index 00000000..9dc58fd4 --- /dev/null +++ b/hi-IN/step_6.md @@ -0,0 +1,38 @@ +## Python कोड के साथ स्थिर तस्वीरें ले + +अब कुछ स्थिर तस्वीरें लेने के लिए कैमरा मॉड्यूल और Python का उपयोग करें। + +- अपने कोड में संशोधन करके `camera.capture()` पंक्ति जोड़ें: + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **ध्यान दें:** चित्र को कैप्चर करने से पहले कम से कम दो सेकंड के लिए `sleep` महत्वपूर्ण है, क्योंकि इससे कैमरे के सेंसर को प्रकाश के स्तर को महसूस करने का समय मिलता है। + +- अपना कोड चलाएँ। + +आपको कैमरा पूर्वावलोकन पांच सेकंड के लिए खुला दिखना चाहिए, और फिर एक स्थिर तस्वीर खिंचनी चाहिए। जब तस्वीर ली जा रही है, आप पूर्वावलोकन को कुछ अलग रिज़ॉल्यूशन में समायोजित होते देख सकते हैं। + +आपकी नई तस्वीर डेस्कटॉप पर सेव होनी चाहिए। + +- अब एक साथ लगातार पाँच चित्र लेने के लिए एक लूप जोड़ें: + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + वेरिएबल `i` गिनता है कि लूप कितनी बार चला है, `0` से `4` तक। इसलिए, चित्र `image0.jpg`, `image1.jpg`, और इसी तरह सेव की जाते हैं। + +- कोड को फिर से चलाएँ और कैमरा मॉड्यूल को स्थिति में रखें। + +कैमरे को हर पांच सेकंड में एक तस्वीर लेनी चाहिए। पांचवीं तस्वीर लेने के बाद, पूर्वावलोकन बंद हो जाता है। + +- पाँच नए चित्रों को खोजने के लिए अपने डेस्कटॉप को देखें। \ No newline at end of file diff --git a/hi-IN/step_7.md b/hi-IN/step_7.md new file mode 100644 index 00000000..8d47d9b7 --- /dev/null +++ b/hi-IN/step_7.md @@ -0,0 +1,20 @@ +## पायथन कोड के साथ वीडियो रिकॉर्ड करना + +अब एक वीडियो रिकॉर्ड करें! + +- अपने कोड में संशोधन करके `capture()` को हटाएं और इसके बजाय `start_recording()` और `stop_recording()` जोड़ें + + आपका कोड अब इस तरह दिखना चाहिए: + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- अपना कोड चलाएँ। + +आपके Raspberry Pi को एक पूर्वावलोकन खोलना चाहिए, 5 सेकंड का वीडियो रिकॉर्ड करना चाहिए, और फिर पूर्वावलोकन बंद करना चाहिए। + diff --git a/hi-IN/step_8.md b/hi-IN/step_8.md new file mode 100644 index 00000000..3faba7f2 --- /dev/null +++ b/hi-IN/step_8.md @@ -0,0 +1,228 @@ +## चित्र सेटिंग कैसे बदलें और चित्र प्रभाव कैसे जोड़ें + +Python `picamera` सॉफ़्टवेयर आपके चित्रों को देखने के तरीके को बदलने के लिए कई प्रभाव और कॉन्फ़िगरेशन प्रदान करता है। + +**ध्यान दें:** कुछ सेटिंग्स केवल पूर्वावलोकन को प्रभावित करती हैं न कि कैप्चर किये गए चित्र को, कुछ केवल कैप्चर किये गए चित्र को प्रभावित करती हैं, और कई अन्य दोनों को प्रभावित करती हैं। + +### चित्र रिज़ॉल्यूशन सेट करें + +आप कैमरा मॉड्यूल द्वारा लिए गए चित्र के `resolution` को बदल सकते हैं। + +डिफ़ॉल्ट रूप से, चित्र रिज़ॉल्यूशन आपके मॉनिटर के रिज़ॉल्यूशन पर सेट होता है। स्थिर तस्वीरों के लिए अधिकतम रिज़ॉल्यूशन 2592×1944, और वीडियो रिकॉर्डिंग के लिए 1920×1080 है। + +- `resolution` को अधिकतम सेट करने और तस्वीर लेने के लिए निम्न कोड का उपयोग करें। + + **ध्यान दें:** आपको इस अधिकतम रिज़ॉल्यूशन को सक्षम करने के लिए फ्रेम दर को `15` पर सेट करने की भी आवश्यकता है। + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +न्यूनतम रिज़ॉल्यूशन 64×64 है। + +- न्यूनतम रिज़ॉल्यूशन के साथ एक तस्वीर लेने की कोशिश करें। + +### अपने चित्र में टेक्स्ट जोड़ें + +आप `annotate_text` कमांड का उपयोग करके अपने चित्र में टेक्स्ट जोड़ सकते हैं। + +- इसे आज़माने के लिए यह कोड चलाएँ: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### जोड़े गए टेक्स्ट का रूप बदलें + +- निम्नलिखित कोड के साथ टेक्स्ट का आकार निर्धारित करें: + + ```python + camera.annotate_text_size = 50 + ``` + + आप टेक्स्ट के आकार को `6` से `60` के बीच किसी भी संख्या पर सेट कर सकते हैं। डिफ़ॉल्ट आकार `32` है। + +टेक्स्ट का रंग बदलना भी संभव है। + +- सबसे पहले, प्रोग्राम के शीर्ष पर अपने `import` लाइन में `Color` जोड़ें: + + ```python + from picamera import PiCamera, Color + ``` + +- फिर `import` पंक्ति के नीचे, अपने शेष कोड में संशोधन करें ताकि यह इस तरह दिखाई दे: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### पूर्वावलोकन की चमक बदलें + +आप बदल सकते हैं कि पूर्वावलोकन कितना उज्ज्वल दिखाई देता है। डिफ़ॉल्ट चमक `50` है, और आप इसे `0` और `100` के बीच किसी भी संख्या पर सेट कर सकते हैं। + +* इसे आज़माने के लिए निम्न कोड चलाएँ: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- निम्न लूप चमक को समायोजित करता है और वर्तमान चमक स्तर को प्रदर्शित करने के लिए टेक्स्ट भी जोड़ता है: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### पूर्वावलोकन का कॉन्ट्रास्ट बदलें + +पूर्वावलोकन चमक की तरह, आप पूर्वावलोकन के कॉन्ट्रास्ट को बदल सकते हैं। + +- इसे आज़माने के लिए निम्न कोड चलाएँ: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### शानदार चित्र प्रभाव जोड़ें + +आप एक विशेष चित्र प्रभाव को लागू करने के लिए `camera.image_effect` का उपयोग कर सकते हैं। + +चित्र प्रभाव के निम्नलिखित विकल्प हैं: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +डिफ़ॉल्ट प्रभाव `none` है। + +* एक चित्र प्रभाव चुनें और इसे आज़माएँ: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* `camera.IMAGE_EFFECTS` के साथ **सभी** चित्र प्रभावों पर लूप करने के लिए इस कोड को चलाएं: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![प्रभाव](images/effects.jpg) + +### चित्र एक्सपोज़र मोड सेट करें + +आप किसी विशेष मोड में एक्सपोज़र सेट करने के लिए `camera.exposure_mode` का उपयोग कर सकते हैं। + +एक्सपोज़र मोड के विकल्प निम्नलिखित हैं: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +डिफ़ॉल्ट मोड `auto` है। + +* एक एक्सपोज़र मोड चुनें और इसे आज़माएँ: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* आप सभी एक्सपोज़र मोड को `camera.EXPOSURE_MODES` के साथ लूप कर सकते हैं, जैसे आपने चित्र प्रभावों के लिए किया था। + +### चित्र के व्हाइट बैलेंस को बदलें + +प्रीसेट मोड में ऑटो व्हाइट बैलेंस को सेट करने के लिए आप `camera.awb_mode` का उपयोग कर सकते हैं। + +उपलब्ध ऑटो व्हाइट बैलेंस मोड हैं: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +डिफ़ॉल्ट `auto` है। + +* एक ऑटो व्हाइट बैलेंस मोड चुनें और इसे आज़माएँ: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* आप सभी ऑटो व्हाइट बैलेंस मोड को `camera.EXPOSURE_MODES` के साथ लूप कर सकते हैं, जैसे आपने चित्र प्रभावों के लिए किया था। \ No newline at end of file diff --git a/hi-IN/step_9.md b/hi-IN/step_9.md new file mode 100644 index 00000000..4f812483 --- /dev/null +++ b/hi-IN/step_9.md @@ -0,0 +1,17 @@ +## आगे क्या? + +अब आप जानते हैं कि अपने कैमरा मॉड्यूल का उपयोग कैसे करें, आप उदाहरण के लिए कर सकते हैं: +* [GPIO Zero](https://gpiozero.readthedocs.org/) Python कोड की मदद से कैमरे को नियंत्रित करने के लिए बटन जोड़ें +* Minecraft Pi के साथ कैमरे को एकीकृत करें +* कैमरे की तस्वीरों को अपने आप Twitter पर पोस्ट करें + +अधिक जानने के लिए इन कैमरा मॉड्यूल प्रोजेक्ट्स को आज़माएं: + +- एक [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) फिल्म बनाएं +- एक [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) बनाएं +- [तस्वीरों को ट्वीट करने के लिए Babbage भालू](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) प्राप्त करें +- एक [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) बनाएँ +- [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) बनाने के लिए NoIR कैमरा मॉड्यूल का उपयोग करें + +कैमरा मॉड्यूल को नियंत्रित करने के लिए Python कोड लिखने के बारे में अधिक जानकारी के लिए, व्यापक [picamera documentation](https://picamera.readthedocs.org/) देखें। + diff --git a/hu-HU/images/Getting_Started_With_Picamera_TILE.png b/hu-HU/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/hu-HU/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/hu-HU/images/banner.png b/hu-HU/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/hu-HU/images/banner.png differ diff --git a/hu-HU/images/blur.jpg b/hu-HU/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/hu-HU/images/blur.jpg differ diff --git a/hu-HU/images/camera-module.png b/hu-HU/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/hu-HU/images/camera-module.png differ diff --git a/hu-HU/images/cartoon.jpg b/hu-HU/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/hu-HU/images/cartoon.jpg differ diff --git a/hu-HU/images/colorbalance.jpg b/hu-HU/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/hu-HU/images/colorbalance.jpg differ diff --git a/hu-HU/images/colorpoint.jpg b/hu-HU/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/hu-HU/images/colorpoint.jpg differ diff --git a/hu-HU/images/colorswap.jpg b/hu-HU/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/hu-HU/images/colorswap.jpg differ diff --git a/hu-HU/images/connect-camera-old.gif b/hu-HU/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/hu-HU/images/connect-camera-old.gif differ diff --git a/hu-HU/images/connect-camera.gif b/hu-HU/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/hu-HU/images/connect-camera.gif differ diff --git a/hu-HU/images/connect-camera.gif.gif b/hu-HU/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/hu-HU/images/connect-camera.gif.gif differ diff --git a/hu-HU/images/connect-camera1.png b/hu-HU/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/hu-HU/images/connect-camera1.png differ diff --git a/hu-HU/images/connect-camera2.png b/hu-HU/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/hu-HU/images/connect-camera2.png differ diff --git a/hu-HU/images/connect-camera3.png b/hu-HU/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/hu-HU/images/connect-camera3.png differ diff --git a/hu-HU/images/connect-camera4.png b/hu-HU/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/hu-HU/images/connect-camera4.png differ diff --git a/hu-HU/images/connect-camera5.png b/hu-HU/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/hu-HU/images/connect-camera5.png differ diff --git a/hu-HU/images/deinterlace1.jpg b/hu-HU/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/hu-HU/images/deinterlace1.jpg differ diff --git a/hu-HU/images/deinterlace2.jpg b/hu-HU/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/hu-HU/images/deinterlace2.jpg differ diff --git a/hu-HU/images/denoise.jpg b/hu-HU/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/hu-HU/images/denoise.jpg differ diff --git a/hu-HU/images/desktop-annotated.png b/hu-HU/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/hu-HU/images/desktop-annotated.png differ diff --git a/hu-HU/images/desktop.png b/hu-HU/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/hu-HU/images/desktop.png differ diff --git a/hu-HU/images/effects.jpg b/hu-HU/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/hu-HU/images/effects.jpg differ diff --git a/hu-HU/images/emboss.jpg b/hu-HU/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/hu-HU/images/emboss.jpg differ diff --git a/hu-HU/images/film.jpg b/hu-HU/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/hu-HU/images/film.jpg differ diff --git a/hu-HU/images/gpen.jpg b/hu-HU/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/hu-HU/images/gpen.jpg differ diff --git a/hu-HU/images/hatch.jpg b/hu-HU/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/hu-HU/images/hatch.jpg differ diff --git a/hu-HU/images/negative.jpg b/hu-HU/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/hu-HU/images/negative.jpg differ diff --git a/hu-HU/images/none.jpg b/hu-HU/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/hu-HU/images/none.jpg differ diff --git a/hu-HU/images/oilpaint.jpg b/hu-HU/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/hu-HU/images/oilpaint.jpg differ diff --git a/hu-HU/images/open-terminal-annotated.png b/hu-HU/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/hu-HU/images/open-terminal-annotated.png differ diff --git a/hu-HU/images/open-terminal.png b/hu-HU/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/hu-HU/images/open-terminal.png differ diff --git a/hu-HU/images/pastel.jpg b/hu-HU/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/hu-HU/images/pastel.jpg differ diff --git a/hu-HU/images/pi-camera-attached.jpg b/hu-HU/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/hu-HU/images/pi-camera-attached.jpg differ diff --git a/hu-HU/images/pi-configuration-interfaces-annotated.png b/hu-HU/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/hu-HU/images/pi-configuration-interfaces-annotated.png differ diff --git a/hu-HU/images/pi-configuration-interfaces.png b/hu-HU/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/hu-HU/images/pi-configuration-interfaces.png differ diff --git a/hu-HU/images/pi-configuration-menu.png b/hu-HU/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/hu-HU/images/pi-configuration-menu.png differ diff --git a/hu-HU/images/pi4-camera-port.png b/hu-HU/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/hu-HU/images/pi4-camera-port.png differ diff --git a/hu-HU/images/posterise.jpg b/hu-HU/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/hu-HU/images/posterise.jpg differ diff --git a/hu-HU/images/preview.jpg b/hu-HU/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/hu-HU/images/preview.jpg differ diff --git a/hu-HU/images/raspberry-pi.png b/hu-HU/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/hu-HU/images/raspberry-pi.png differ diff --git a/hu-HU/images/raspistill-help.png b/hu-HU/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/hu-HU/images/raspistill-help.png differ diff --git a/hu-HU/images/raspistill-image.png b/hu-HU/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/hu-HU/images/raspistill-image.png differ diff --git a/hu-HU/images/saturation.jpg b/hu-HU/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/hu-HU/images/saturation.jpg differ diff --git a/hu-HU/images/sketch.jpg b/hu-HU/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/hu-HU/images/sketch.jpg differ diff --git a/hu-HU/images/solarize.jpg b/hu-HU/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/hu-HU/images/solarize.jpg differ diff --git a/hu-HU/images/thonny-app-menu.png b/hu-HU/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/hu-HU/images/thonny-app-menu.png differ diff --git a/hu-HU/images/washedout.jpg b/hu-HU/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/hu-HU/images/washedout.jpg differ diff --git a/hu-HU/images/watercolor.jpg b/hu-HU/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/hu-HU/images/watercolor.jpg differ diff --git a/hu-HU/meta.yml b/hu-HU/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/hu-HU/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/hu-HU/step_1.md b/hu-HU/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/hu-HU/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/hu-HU/step_2.md b/hu-HU/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/hu-HU/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/hu-HU/step_3.md b/hu-HU/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/hu-HU/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/hu-HU/step_4.md b/hu-HU/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/hu-HU/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 Enter 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/hu-HU/step_5.md b/hu-HU/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/hu-HU/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`. \ No newline at end of file diff --git a/hu-HU/step_6.md b/hu-HU/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/hu-HU/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. \ No newline at end of file diff --git a/hu-HU/step_7.md b/hu-HU/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/hu-HU/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. + diff --git a/hu-HU/step_8.md b/hu-HU/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/hu-HU/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/hu-HU/step_9.md b/hu-HU/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/hu-HU/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/it-IT/images/Getting_Started_With_Picamera_TILE.png b/it-IT/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/it-IT/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/it-IT/images/banner.png b/it-IT/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/it-IT/images/banner.png differ diff --git a/it-IT/images/blur.jpg b/it-IT/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/it-IT/images/blur.jpg differ diff --git a/it-IT/images/camera-module.png b/it-IT/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/it-IT/images/camera-module.png differ diff --git a/it-IT/images/cartoon.jpg b/it-IT/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/it-IT/images/cartoon.jpg differ diff --git a/it-IT/images/colorbalance.jpg b/it-IT/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/it-IT/images/colorbalance.jpg differ diff --git a/it-IT/images/colorpoint.jpg b/it-IT/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/it-IT/images/colorpoint.jpg differ diff --git a/it-IT/images/colorswap.jpg b/it-IT/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/it-IT/images/colorswap.jpg differ diff --git a/it-IT/images/connect-camera-old.gif b/it-IT/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/it-IT/images/connect-camera-old.gif differ diff --git a/it-IT/images/connect-camera.gif b/it-IT/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/it-IT/images/connect-camera.gif differ diff --git a/it-IT/images/connect-camera.gif.gif b/it-IT/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/it-IT/images/connect-camera.gif.gif differ diff --git a/it-IT/images/connect-camera1.png b/it-IT/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/it-IT/images/connect-camera1.png differ diff --git a/it-IT/images/connect-camera2.png b/it-IT/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/it-IT/images/connect-camera2.png differ diff --git a/it-IT/images/connect-camera3.png b/it-IT/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/it-IT/images/connect-camera3.png differ diff --git a/it-IT/images/connect-camera4.png b/it-IT/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/it-IT/images/connect-camera4.png differ diff --git a/it-IT/images/connect-camera5.png b/it-IT/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/it-IT/images/connect-camera5.png differ diff --git a/it-IT/images/deinterlace1.jpg b/it-IT/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/it-IT/images/deinterlace1.jpg differ diff --git a/it-IT/images/deinterlace2.jpg b/it-IT/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/it-IT/images/deinterlace2.jpg differ diff --git a/it-IT/images/denoise.jpg b/it-IT/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/it-IT/images/denoise.jpg differ diff --git a/it-IT/images/desktop-annotated.png b/it-IT/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/it-IT/images/desktop-annotated.png differ diff --git a/it-IT/images/desktop.png b/it-IT/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/it-IT/images/desktop.png differ diff --git a/it-IT/images/effects.jpg b/it-IT/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/it-IT/images/effects.jpg differ diff --git a/it-IT/images/emboss.jpg b/it-IT/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/it-IT/images/emboss.jpg differ diff --git a/it-IT/images/film.jpg b/it-IT/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/it-IT/images/film.jpg differ diff --git a/it-IT/images/gpen.jpg b/it-IT/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/it-IT/images/gpen.jpg differ diff --git a/it-IT/images/hatch.jpg b/it-IT/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/it-IT/images/hatch.jpg differ diff --git a/it-IT/images/negative.jpg b/it-IT/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/it-IT/images/negative.jpg differ diff --git a/it-IT/images/none.jpg b/it-IT/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/it-IT/images/none.jpg differ diff --git a/it-IT/images/oilpaint.jpg b/it-IT/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/it-IT/images/oilpaint.jpg differ diff --git a/it-IT/images/open-terminal-annotated.png b/it-IT/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/it-IT/images/open-terminal-annotated.png differ diff --git a/it-IT/images/open-terminal.png b/it-IT/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/it-IT/images/open-terminal.png differ diff --git a/it-IT/images/pastel.jpg b/it-IT/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/it-IT/images/pastel.jpg differ diff --git a/it-IT/images/pi-camera-attached.jpg b/it-IT/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/it-IT/images/pi-camera-attached.jpg differ diff --git a/it-IT/images/pi-configuration-interfaces-annotated.png b/it-IT/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/it-IT/images/pi-configuration-interfaces-annotated.png differ diff --git a/it-IT/images/pi-configuration-interfaces.png b/it-IT/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/it-IT/images/pi-configuration-interfaces.png differ diff --git a/it-IT/images/pi-configuration-menu.png b/it-IT/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/it-IT/images/pi-configuration-menu.png differ diff --git a/it-IT/images/pi4-camera-port.png b/it-IT/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/it-IT/images/pi4-camera-port.png differ diff --git a/it-IT/images/posterise.jpg b/it-IT/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/it-IT/images/posterise.jpg differ diff --git a/it-IT/images/preview.jpg b/it-IT/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/it-IT/images/preview.jpg differ diff --git a/it-IT/images/raspberry-pi.png b/it-IT/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/it-IT/images/raspberry-pi.png differ diff --git a/it-IT/images/raspistill-help.png b/it-IT/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/it-IT/images/raspistill-help.png differ diff --git a/it-IT/images/raspistill-image.png b/it-IT/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/it-IT/images/raspistill-image.png differ diff --git a/it-IT/images/saturation.jpg b/it-IT/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/it-IT/images/saturation.jpg differ diff --git a/it-IT/images/sketch.jpg b/it-IT/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/it-IT/images/sketch.jpg differ diff --git a/it-IT/images/solarize.jpg b/it-IT/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/it-IT/images/solarize.jpg differ diff --git a/it-IT/images/thonny-app-menu.png b/it-IT/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/it-IT/images/thonny-app-menu.png differ diff --git a/it-IT/images/washedout.jpg b/it-IT/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/it-IT/images/washedout.jpg differ diff --git a/it-IT/images/watercolor.jpg b/it-IT/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/it-IT/images/watercolor.jpg differ diff --git a/it-IT/meta.yml b/it-IT/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/it-IT/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/it-IT/step_1.md b/it-IT/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/it-IT/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/it-IT/step_2.md b/it-IT/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/it-IT/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/it-IT/step_3.md b/it-IT/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/it-IT/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/it-IT/step_4.md b/it-IT/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/it-IT/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 Enter 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/it-IT/step_5.md b/it-IT/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/it-IT/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`. \ No newline at end of file diff --git a/it-IT/step_6.md b/it-IT/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/it-IT/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. \ No newline at end of file diff --git a/it-IT/step_7.md b/it-IT/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/it-IT/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. + diff --git a/it-IT/step_8.md b/it-IT/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/it-IT/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/it-IT/step_9.md b/it-IT/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/it-IT/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/ja-JP/images/Getting_Started_With_Picamera_TILE.png b/ja-JP/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/ja-JP/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/ja-JP/images/banner.png b/ja-JP/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/ja-JP/images/banner.png differ diff --git a/ja-JP/images/blur.jpg b/ja-JP/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/ja-JP/images/blur.jpg differ diff --git a/ja-JP/images/camera-module.png b/ja-JP/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/ja-JP/images/camera-module.png differ diff --git a/ja-JP/images/cartoon.jpg b/ja-JP/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/ja-JP/images/cartoon.jpg differ diff --git a/ja-JP/images/colorbalance.jpg b/ja-JP/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/ja-JP/images/colorbalance.jpg differ diff --git a/ja-JP/images/colorpoint.jpg b/ja-JP/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/ja-JP/images/colorpoint.jpg differ diff --git a/ja-JP/images/colorswap.jpg b/ja-JP/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/ja-JP/images/colorswap.jpg differ diff --git a/ja-JP/images/connect-camera-old.gif b/ja-JP/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ja-JP/images/connect-camera-old.gif differ diff --git a/ja-JP/images/connect-camera.gif b/ja-JP/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ja-JP/images/connect-camera.gif differ diff --git a/ja-JP/images/connect-camera.gif.gif b/ja-JP/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ja-JP/images/connect-camera.gif.gif differ diff --git a/ja-JP/images/connect-camera1.png b/ja-JP/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/ja-JP/images/connect-camera1.png differ diff --git a/ja-JP/images/connect-camera2.png b/ja-JP/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/ja-JP/images/connect-camera2.png differ diff --git a/ja-JP/images/connect-camera3.png b/ja-JP/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/ja-JP/images/connect-camera3.png differ diff --git a/ja-JP/images/connect-camera4.png b/ja-JP/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/ja-JP/images/connect-camera4.png differ diff --git a/ja-JP/images/connect-camera5.png b/ja-JP/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/ja-JP/images/connect-camera5.png differ diff --git a/ja-JP/images/deinterlace1.jpg b/ja-JP/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/ja-JP/images/deinterlace1.jpg differ diff --git a/ja-JP/images/deinterlace2.jpg b/ja-JP/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/ja-JP/images/deinterlace2.jpg differ diff --git a/ja-JP/images/denoise.jpg b/ja-JP/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/ja-JP/images/denoise.jpg differ diff --git a/ja-JP/images/desktop-annotated.png b/ja-JP/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/ja-JP/images/desktop-annotated.png differ diff --git a/ja-JP/images/desktop.png b/ja-JP/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/ja-JP/images/desktop.png differ diff --git a/ja-JP/images/effects.jpg b/ja-JP/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/ja-JP/images/effects.jpg differ diff --git a/ja-JP/images/emboss.jpg b/ja-JP/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/ja-JP/images/emboss.jpg differ diff --git a/ja-JP/images/film.jpg b/ja-JP/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/ja-JP/images/film.jpg differ diff --git a/ja-JP/images/gpen.jpg b/ja-JP/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/ja-JP/images/gpen.jpg differ diff --git a/ja-JP/images/hatch.jpg b/ja-JP/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/ja-JP/images/hatch.jpg differ diff --git a/ja-JP/images/negative.jpg b/ja-JP/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/ja-JP/images/negative.jpg differ diff --git a/ja-JP/images/none.jpg b/ja-JP/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/ja-JP/images/none.jpg differ diff --git a/ja-JP/images/oilpaint.jpg b/ja-JP/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/ja-JP/images/oilpaint.jpg differ diff --git a/ja-JP/images/open-terminal-annotated.png b/ja-JP/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/ja-JP/images/open-terminal-annotated.png differ diff --git a/ja-JP/images/open-terminal.png b/ja-JP/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/ja-JP/images/open-terminal.png differ diff --git a/ja-JP/images/pastel.jpg b/ja-JP/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/ja-JP/images/pastel.jpg differ diff --git a/ja-JP/images/pi-camera-attached.jpg b/ja-JP/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/ja-JP/images/pi-camera-attached.jpg differ diff --git a/ja-JP/images/pi-configuration-interfaces-annotated.png b/ja-JP/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/ja-JP/images/pi-configuration-interfaces-annotated.png differ diff --git a/ja-JP/images/pi-configuration-interfaces.png b/ja-JP/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/ja-JP/images/pi-configuration-interfaces.png differ diff --git a/ja-JP/images/pi-configuration-menu.png b/ja-JP/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/ja-JP/images/pi-configuration-menu.png differ diff --git a/ja-JP/images/pi4-camera-port.png b/ja-JP/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/ja-JP/images/pi4-camera-port.png differ diff --git a/ja-JP/images/posterise.jpg b/ja-JP/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/ja-JP/images/posterise.jpg differ diff --git a/ja-JP/images/preview.jpg b/ja-JP/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/ja-JP/images/preview.jpg differ diff --git a/ja-JP/images/raspberry-pi.png b/ja-JP/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/ja-JP/images/raspberry-pi.png differ diff --git a/ja-JP/images/raspistill-help.png b/ja-JP/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/ja-JP/images/raspistill-help.png differ diff --git a/ja-JP/images/raspistill-image.png b/ja-JP/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/ja-JP/images/raspistill-image.png differ diff --git a/ja-JP/images/saturation.jpg b/ja-JP/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/ja-JP/images/saturation.jpg differ diff --git a/ja-JP/images/sketch.jpg b/ja-JP/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/ja-JP/images/sketch.jpg differ diff --git a/ja-JP/images/solarize.jpg b/ja-JP/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/ja-JP/images/solarize.jpg differ diff --git a/ja-JP/images/thonny-app-menu.png b/ja-JP/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/ja-JP/images/thonny-app-menu.png differ diff --git a/ja-JP/images/washedout.jpg b/ja-JP/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/ja-JP/images/washedout.jpg differ diff --git a/ja-JP/images/watercolor.jpg b/ja-JP/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/ja-JP/images/watercolor.jpg differ diff --git a/ja-JP/meta.yml b/ja-JP/meta.yml new file mode 100644 index 00000000..d1d80801 --- /dev/null +++ b/ja-JP/meta.yml @@ -0,0 +1,31 @@ +--- +title: カメラモジュールを始めよう +hero_image: images/banner.png +description: RaspberryPiカメラモジュールとPythonで写真とビデオを撮る +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: はじめに + - + title: 必要なもの + - + title: カメラモジュールを接続する + - + title: コマンドラインでカメラモジュールをコントロールする方法 + completion: + - engaged + - + title: Pythonコードでカメラモジュールをコントロールする方法 + - + title: Pythonコードで静止画を撮る + - + title: Pythonコードでビデオを録画する + - + title: 画像設定を変更して、画像効果を追加する方法 + completion: + - internal + - + title: 次は何をしましょうか？ diff --git a/ja-JP/step_1.md b/ja-JP/step_1.md new file mode 100644 index 00000000..27ec4754 --- /dev/null +++ b/ja-JP/step_1.md @@ -0,0 +1,9 @@ +## はじめに + +[[[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/ja-JP/step_2.md b/ja-JP/step_2.md new file mode 100644 index 00000000..8eceba9d --- /dev/null +++ b/ja-JP/step_2.md @@ -0,0 +1,20 @@ +## 必要なもの + +### カメラモジュールポート付きRaspberry Piコンピューター + +現在のRaspberry Piのすべてのモデルには、カメラモジュールを接続するためのポートがあります。 + +![カメラモジュールポートのラベルが取り付けられたRaspberry Pi 3B +](images/pi4-camera-port.png) + +**注意：** Raspberry Pi Zeroを使用する場合は、Raspberry Pi Zeroの小さいカメラモジュールポートに合うカメラモジュールリボンケーブルが必要です。 + +### Raspberry Piカメラモジュール + +![Raspberry Piカメラモジュール](images/camera-module.png) + +カメラモジュールには2つのバージョンがあります。 + +* [標準バージョン](https://www.raspberrypi.org/products/camera-module-v2/)は、通常の光の中で写真を撮るように設計されています +* [NoIR バージョン](https://www.raspberrypi.org/products/pi-noir-camera-v2/)は、赤外線フィルタを持たないので、赤外線の光源と一緒に暗闇の中で写真を撮ることができます + + diff --git a/ja-JP/step_3.md b/ja-JP/step_3.md new file mode 100644 index 00000000..7907eb99 --- /dev/null +++ b/ja-JP/step_3.md @@ -0,0 +1,48 @@ +## カメラモジュールを接続する + +**Raspberry Piがオフになっていることを確認してください。** + +--- no-print --- + +1. カメラモジュールポートを見つけます +2. ポートのプラスチッククリップの端（はし）をそっと引き上げます +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. プラスチッククリップを元の位置にもどします + +![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. カメラモジュールポートを見つけます。 + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. ポートのプラスチッククリップの端（はし）をそっと引き上げます。 + +![持ち上げられたカメラモジュールポート](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. + +![ポートに差しこまれたカメラモジュールリボンケーブル](images/connect-camera3.png) + +4. プラスチッククリップを元の位置にもどします。 + +![camera module port pushed down](images/connect-camera4.png) + +![camera module port pushed down](images/connect-camera4.png) + +--- /print-only --- + +- Raspberry Piを起動します。 + +- メインメニューに移動し、 **Raspberry Pi Configuration** (設定)ツールを開きます。 + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- **Interfaces** (インターフェイス)タブを選択し、カメラが**enabled**(有効)になっていることを確認します + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- Raspberry Piを再起動します。 diff --git a/ja-JP/step_4.md b/ja-JP/step_4.md new file mode 100644 index 00000000..895cf6ed --- /dev/null +++ b/ja-JP/step_4.md @@ -0,0 +1,41 @@ +## コマンドラインでカメラモジュールをコントロールする方法 + +カメラモジュールが接続され、ソフトウェアが有効になりました。コマンドラインツールである `raspistill` と `raspivid` を試してみてください。 + +- タスクバーの黒いモニターアイコンをクリックして、ターミナルウィンドウを開きます。 + +![ターミナルを開く](images/open-terminal-annotated.png) + +- 静止画を撮影し、デスクトップに保存するには、次のコマンドを入力します。 + +```bash +raspistill -o Desktop / image.jpg +``` + +![raspistillコマンドがターミナルに入力される](images/raspistill-image.png) + +- Enter を押してコマンドを実行します。 + +コマンドが実行されると、静止画が撮影される5秒前からカメラのプレビューが開きます。 + +- デスクトップの画像ファイルアイコンを探し、ファイルアイコンをダブルクリックして画像を開きます。 + + ![デスクトップ上の画像](images/desktop-annotated.png) + +さまざまなオプションを追加することで、`raspistill` コマンドが受け取る画像サイズと見え方を設定することができます。 + +- たとえば、画像の高さと幅を変更するには、 `-h` と `-w` を追加します。 + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- 続いて、次の `raspivid` コマンドを使用して、カメラモジュールでビデオを録画します。 + +```bash +raspivid -o Desktop/video.h264 +``` + +- ビデオファイルを再生するには、デスクトップの `video.h264` ファイルアイコンをダブルクリックして、VLC MediaPlayerで開きます。 + +より詳しい情報やこれらのコマンドで使用できるその他のオプションについては、[raspistill のドキュメント](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) および [raspividのドキュメント](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md) を読んでください。 diff --git a/ja-JP/step_5.md b/ja-JP/step_5.md new file mode 100644 index 00000000..415c5b2a --- /dev/null +++ b/ja-JP/step_5.md @@ -0,0 +1,49 @@ +## Pythonコードでカメラモジュールをコントロールする方法 + +Python `picamera` ライブラリを使用すると、カメラモジュールをコントロールして素晴らしいプロジェクトを作成できます。 + +- **Thonny Python IDE** など、Python 3 エディタを開きます。 + + ![Thonnyを開く](images/thonny-app-menu.png) + +- 新しいファイルを開き、 `camera.py` として保存します。 + + **注意:** **ファイルを`picamera.py `として保存しない** ことが重要です。 + +- 次のコードを入力します。 + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- プログラムを保存して実行します。 カメラのプレビューが5秒間表示され、再び閉じます。 + + ![画像プレビュー](images/preview.jpg) + + **注意:** カメラのプレビューは、モニターがRaspberry Piに接続されている場合にのみ機能します。 リモートアクセス（SSHやVNCなど）を使用している場合、カメラのプレビューは表示されません。 + +- プレビューが上下逆になっている場合は、次のコードを使用してプレビューを180度回転させることができます。 + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + 画像を `90`、 `180`、または `270` 度回転させることができます。 画像をリセットするには、 `rotation` (回転)を `0` 度に設定します。 + +プレビューがオンのときにプログラムでエラーが発生するかどうかを確認できるように、プレビューを少し透（す）けて見えるようにすることをお勧（すす）めします。 + +- `alpha` レベルを設定して、カメラプレビューを透かします。 + + ```python + camera.start_preview(alpha=200) + ``` + + `alpha` の値は `0` から `255` の間の任意の数値にできます。 \ No newline at end of file diff --git a/ja-JP/step_6.md b/ja-JP/step_6.md new file mode 100644 index 00000000..f3cb5d00 --- /dev/null +++ b/ja-JP/step_6.md @@ -0,0 +1,38 @@ +## Pythonコードで静止画を撮る + +次に、カメラモジュールとPythonを使って静止画を撮りましょう。 + +- コードを修正して、 `camera.capture()` 行を追加します。 + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **注意:** 画像をキャプチャする前に、少なくとも2秒間 `スリープ` することが重要です。 これにより、カメラのセンサーに光のレベルを感知する時間を与えられます。 + +- コードを実行します。 + +カメラのプレビューが5秒間開いてから、静止画が撮影されます。 写真が撮影されている間、プレビューが別の解像度（かいぞうど）にささっと調整されているのを見ることができます。 + +新しい画像はデスクトップに保存されているはずです。 + +- 次に、5枚の写真を連続で撮るためのループを追加します。 + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + 変数 `i` は、ループの実行回数を `0` から `4` まで数えます。 そのため、画像は `image0.jpg`、 `image1.jpg`、などとして保存されます。 + +- もう一度コードを実行し、カメラモジュールを適当な位置に保持します。 + +カメラは５秒ごとに１枚の写真を撮ります。 5枚目の写真を撮ると、プレビューは終了します。 + +- デスクトップを見ると５枚の新しい写真があります。 \ No newline at end of file diff --git a/ja-JP/step_7.md b/ja-JP/step_7.md new file mode 100644 index 00000000..9a7f7690 --- /dev/null +++ b/ja-JP/step_7.md @@ -0,0 +1,20 @@ +## Pythonコードでビデオを録画する + +ビデオを録画しましょう！ + +- コードを修正して、 `capture()` を取り除き、代わりに `start_recording()` (録画開始)と `stop_recording()` (録画停止)を追加します。 + + コードは次のようになります。 + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- コードを実行します。 + +Raspberry Piはプレビューを開き、5秒間のビデオを録画してから、プレビューを閉じます。 + diff --git a/ja-JP/step_8.md b/ja-JP/step_8.md new file mode 100644 index 00000000..f3aa096a --- /dev/null +++ b/ja-JP/step_8.md @@ -0,0 +1,228 @@ +## 画像設定を変更して、画像効果を追加する方法 + +Pythonの `picamera` ソフトウェアは、画像の見た目を変更するための多くの効果と設定を提供します。 + +**注意:** 一部の設定は、プレビューにのみ反映され、撮影された画像には反映されません。また、一部の設定は撮影された画像にのみ反映されます。多くの設定は両方に反映されます。 + +### 画像の解像度を設定する + +カメラモジュールが撮影する画像の `resolution`(解像度)を変更できます。 + +デフォルト（初期設定）では、画像の解像度はモニターの解像度に設定されています。 最大解像度は、静止画の場合は2592×1944、ビデオ録画の場合は1920×1080です。 + +- 次のコードを使用して、 `resolution` を最大に設定し、写真を撮ります。 + + **注意:** この最大解像度を有効にするには、フレームレートを `15` に設定する必要があります。 + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +最小解像度は64×64です。 + +- 最小解像度で写真を撮ってみてください。 + +### 画像にテキストを追加する + +コマンド `annotate_text` (注釈を付ける)を使用して画像にテキストを追加することができます。 + +- このコードを実行してみましょう。 + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### 追加したテキストの見かけを変更する + +- 次のコードでテキストサイズを設定します。 + + ```python + camera.annotate_text_size = 50 + ``` + + `6` から `160` までの任意の文字サイズに設定できます。 デフォルトのサイズは `32` です。 + +テキストの色を変更することもできます。 + +- まず、`Color` を、プログラムの上部にある `import` 行に追加します。 + + ```python + from picamera import PiCamera, Color + ``` + +- 次に、 `import` 行の下で、残りのコードを次のように修正します。 + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### プレビューの明るさを変更する + +プレビューの明るさを変更できます。 デフォルトの明るさは `50`で、 `0` から `100` の間の任意の値に設定できます。 + +* これを試すには、次のコードを実行します。 + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- 次のループは、明るさを調整し、現在の明るさのレベルを表示するテキストを追加します。 + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### プレビューのコントラストを変更する + +プレビューの明るさと同様に、プレビューのコントラストを変更できます。 + +- これを試すには、次のコードを実行します。 + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### かっこいい画像効果を追加する + +`camera.image_effect` を使用して、特定の画像効果を適用できます。 + +画像効果のオプションは次のとおりです。 + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +デフォルトの効果は `none` です。 + +* 画像効果を選んで試してみてください。 + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* **すべて** の画像効果を`camera.IMAGE_EFFECTS`を使ってループさせるためにこのコードを実行してください。 + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![効果](images/effects.jpg) + +### 画像露出モード（光の量、明るさ）を設定する + +`camera.exposure_mode` を使用して、露出を特定のモードに設定できます。 + +露出モードのオプションは次のとおりです。 +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +デフォルトのモードは `auto` です。 + +* 露出モードを選択して試してみてください。 + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* 画像効果で行ったように、`camera.EXPOSURE_MODES`を使ってすべての露出モードをループさせることができます。 + +### 画像のホワイトバランスを変更する + +`camera.awb_mode` を使用して、オート(自動)ホワイトバランスをプリセットモードに設定できます。 + +利用できるオートホワイトバランスモードは次のとおりです。 +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +デフォルトは `auto` です。 + +* オートホワイトバランスモードを選択して試してみてください。 + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* 画像効果で行ったように、`camera.AWB_MODES`を使ってすべてのオートホワイトバランスモードをループさせることができます。 \ No newline at end of file diff --git a/ja-JP/step_9.md b/ja-JP/step_9.md new file mode 100644 index 00000000..78fdb070 --- /dev/null +++ b/ja-JP/step_9.md @@ -0,0 +1,17 @@ +## 次は何をしましょうか？ + +これで、カメラモジュールの使い方がわかりました。たとえば、次のようなことができます。 +* [GPIO Zero](https://gpiozero.readthedocs.org/) Pythonコードの助けを借りてカメラを制御するボタンを追加 +* Minecraft Piとカメラを統合 +* カメラの写真をTwitterに自動的に投稿 + +更に学ぶために、次のカメラモジュールプロジェクトをお試しください。 + +- [プッシュボタンストップモーション](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) フィルムを作成 +- [マインクラフトフォトブース](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/)を作成 +- [写真をツイートするためにバベッジベア](https://projects.raspberrypi.org/en/projects/tweeting-babbage/)を取得 +- [親探知機](https://projects.raspberrypi.org/en/projects/parent-detector/)を作成 +- NoIRカメラモジュールを使用して、 [赤外線バードボックス](https://projects.raspberrypi.org/en/projects/infrared-bird-box/)を作成 + +Camera Moduleを制御するためのPythonコードの書き方についての詳細は、 [picamera ドキュメント](https://picamera.readthedocs.org/) を参照してください。 + diff --git a/kn-IN/images/Getting_Started_With_Picamera_TILE.png b/kn-IN/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/kn-IN/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/kn-IN/images/banner.png b/kn-IN/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/kn-IN/images/banner.png differ diff --git a/kn-IN/images/blur.jpg b/kn-IN/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/kn-IN/images/blur.jpg differ diff --git a/kn-IN/images/camera-module.png b/kn-IN/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/kn-IN/images/camera-module.png differ diff --git a/kn-IN/images/cartoon.jpg b/kn-IN/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/kn-IN/images/cartoon.jpg differ diff --git a/kn-IN/images/colorbalance.jpg b/kn-IN/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/kn-IN/images/colorbalance.jpg differ diff --git a/kn-IN/images/colorpoint.jpg b/kn-IN/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/kn-IN/images/colorpoint.jpg differ diff --git a/kn-IN/images/colorswap.jpg b/kn-IN/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/kn-IN/images/colorswap.jpg differ diff --git a/kn-IN/images/connect-camera-old.gif b/kn-IN/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/kn-IN/images/connect-camera-old.gif differ diff --git a/kn-IN/images/connect-camera.gif b/kn-IN/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/kn-IN/images/connect-camera.gif differ diff --git a/kn-IN/images/connect-camera.gif.gif b/kn-IN/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/kn-IN/images/connect-camera.gif.gif differ diff --git a/kn-IN/images/connect-camera1.png b/kn-IN/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/kn-IN/images/connect-camera1.png differ diff --git a/kn-IN/images/connect-camera2.png b/kn-IN/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/kn-IN/images/connect-camera2.png differ diff --git a/kn-IN/images/connect-camera3.png b/kn-IN/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/kn-IN/images/connect-camera3.png differ diff --git a/kn-IN/images/connect-camera4.png b/kn-IN/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/kn-IN/images/connect-camera4.png differ diff --git a/kn-IN/images/connect-camera5.png b/kn-IN/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/kn-IN/images/connect-camera5.png differ diff --git a/kn-IN/images/deinterlace1.jpg b/kn-IN/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/kn-IN/images/deinterlace1.jpg differ diff --git a/kn-IN/images/deinterlace2.jpg b/kn-IN/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/kn-IN/images/deinterlace2.jpg differ diff --git a/kn-IN/images/denoise.jpg b/kn-IN/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/kn-IN/images/denoise.jpg differ diff --git a/kn-IN/images/desktop-annotated.png b/kn-IN/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/kn-IN/images/desktop-annotated.png differ diff --git a/kn-IN/images/desktop.png b/kn-IN/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/kn-IN/images/desktop.png differ diff --git a/kn-IN/images/effects.jpg b/kn-IN/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/kn-IN/images/effects.jpg differ diff --git a/kn-IN/images/emboss.jpg b/kn-IN/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/kn-IN/images/emboss.jpg differ diff --git a/kn-IN/images/film.jpg b/kn-IN/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/kn-IN/images/film.jpg differ diff --git a/kn-IN/images/gpen.jpg b/kn-IN/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/kn-IN/images/gpen.jpg differ diff --git a/kn-IN/images/hatch.jpg b/kn-IN/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/kn-IN/images/hatch.jpg differ diff --git a/kn-IN/images/negative.jpg b/kn-IN/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/kn-IN/images/negative.jpg differ diff --git a/kn-IN/images/none.jpg b/kn-IN/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/kn-IN/images/none.jpg differ diff --git a/kn-IN/images/oilpaint.jpg b/kn-IN/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/kn-IN/images/oilpaint.jpg differ diff --git a/kn-IN/images/open-terminal-annotated.png b/kn-IN/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/kn-IN/images/open-terminal-annotated.png differ diff --git a/kn-IN/images/open-terminal.png b/kn-IN/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/kn-IN/images/open-terminal.png differ diff --git a/kn-IN/images/pastel.jpg b/kn-IN/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/kn-IN/images/pastel.jpg differ diff --git a/kn-IN/images/pi-camera-attached.jpg b/kn-IN/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/kn-IN/images/pi-camera-attached.jpg differ diff --git a/kn-IN/images/pi-configuration-interfaces-annotated.png b/kn-IN/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/kn-IN/images/pi-configuration-interfaces-annotated.png differ diff --git a/kn-IN/images/pi-configuration-interfaces.png b/kn-IN/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/kn-IN/images/pi-configuration-interfaces.png differ diff --git a/kn-IN/images/pi-configuration-menu.png b/kn-IN/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/kn-IN/images/pi-configuration-menu.png differ diff --git a/kn-IN/images/pi4-camera-port.png b/kn-IN/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/kn-IN/images/pi4-camera-port.png differ diff --git a/kn-IN/images/posterise.jpg b/kn-IN/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/kn-IN/images/posterise.jpg differ diff --git a/kn-IN/images/preview.jpg b/kn-IN/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/kn-IN/images/preview.jpg differ diff --git a/kn-IN/images/raspberry-pi.png b/kn-IN/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/kn-IN/images/raspberry-pi.png differ diff --git a/kn-IN/images/raspistill-help.png b/kn-IN/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/kn-IN/images/raspistill-help.png differ diff --git a/kn-IN/images/raspistill-image.png b/kn-IN/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/kn-IN/images/raspistill-image.png differ diff --git a/kn-IN/images/saturation.jpg b/kn-IN/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/kn-IN/images/saturation.jpg differ diff --git a/kn-IN/images/sketch.jpg b/kn-IN/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/kn-IN/images/sketch.jpg differ diff --git a/kn-IN/images/solarize.jpg b/kn-IN/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/kn-IN/images/solarize.jpg differ diff --git a/kn-IN/images/thonny-app-menu.png b/kn-IN/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/kn-IN/images/thonny-app-menu.png differ diff --git a/kn-IN/images/washedout.jpg b/kn-IN/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/kn-IN/images/washedout.jpg differ diff --git a/kn-IN/images/watercolor.jpg b/kn-IN/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/kn-IN/images/watercolor.jpg differ diff --git a/kn-IN/meta.yml b/kn-IN/meta.yml new file mode 100644 index 00000000..574ee363 --- /dev/null +++ b/kn-IN/meta.yml @@ -0,0 +1,31 @@ +--- +title: ಕ್ಯಾಮೆರಾ ಮಾಡ್ಯೂಲ್ನೊಂದಿಗೆ ಪ್ರಾರಂಭಿಸುವುದು +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/kn-IN/step_1.md b/kn-IN/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/kn-IN/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/kn-IN/step_2.md b/kn-IN/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/kn-IN/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/kn-IN/step_3.md b/kn-IN/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/kn-IN/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/kn-IN/step_4.md b/kn-IN/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/kn-IN/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 Enter 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/kn-IN/step_5.md b/kn-IN/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/kn-IN/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`. \ No newline at end of file diff --git a/kn-IN/step_6.md b/kn-IN/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/kn-IN/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. \ No newline at end of file diff --git a/kn-IN/step_7.md b/kn-IN/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/kn-IN/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. + diff --git a/kn-IN/step_8.md b/kn-IN/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/kn-IN/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/kn-IN/step_9.md b/kn-IN/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/kn-IN/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/ko-KR/images/Getting_Started_With_Picamera_TILE.png b/ko-KR/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/ko-KR/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/ko-KR/images/banner.png b/ko-KR/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/ko-KR/images/banner.png differ diff --git a/ko-KR/images/blur.jpg b/ko-KR/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/ko-KR/images/blur.jpg differ diff --git a/ko-KR/images/camera-module.png b/ko-KR/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/ko-KR/images/camera-module.png differ diff --git a/ko-KR/images/cartoon.jpg b/ko-KR/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/ko-KR/images/cartoon.jpg differ diff --git a/ko-KR/images/colorbalance.jpg b/ko-KR/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/ko-KR/images/colorbalance.jpg differ diff --git a/ko-KR/images/colorpoint.jpg b/ko-KR/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/ko-KR/images/colorpoint.jpg differ diff --git a/ko-KR/images/colorswap.jpg b/ko-KR/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/ko-KR/images/colorswap.jpg differ diff --git a/ko-KR/images/connect-camera-old.gif b/ko-KR/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ko-KR/images/connect-camera-old.gif differ diff --git a/ko-KR/images/connect-camera.gif b/ko-KR/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ko-KR/images/connect-camera.gif differ diff --git a/ko-KR/images/connect-camera.gif.gif b/ko-KR/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ko-KR/images/connect-camera.gif.gif differ diff --git a/ko-KR/images/connect-camera1.png b/ko-KR/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/ko-KR/images/connect-camera1.png differ diff --git a/ko-KR/images/connect-camera2.png b/ko-KR/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/ko-KR/images/connect-camera2.png differ diff --git a/ko-KR/images/connect-camera3.png b/ko-KR/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/ko-KR/images/connect-camera3.png differ diff --git a/ko-KR/images/connect-camera4.png b/ko-KR/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/ko-KR/images/connect-camera4.png differ diff --git a/ko-KR/images/connect-camera5.png b/ko-KR/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/ko-KR/images/connect-camera5.png differ diff --git a/ko-KR/images/deinterlace1.jpg b/ko-KR/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/ko-KR/images/deinterlace1.jpg differ diff --git a/ko-KR/images/deinterlace2.jpg b/ko-KR/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/ko-KR/images/deinterlace2.jpg differ diff --git a/ko-KR/images/denoise.jpg b/ko-KR/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/ko-KR/images/denoise.jpg differ diff --git a/ko-KR/images/desktop-annotated.png b/ko-KR/images/desktop-annotated.png new file mode 100644 index 00000000..e267e25e Binary files /dev/null and b/ko-KR/images/desktop-annotated.png differ diff --git a/ko-KR/images/desktop.png b/ko-KR/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/ko-KR/images/desktop.png differ diff --git a/ko-KR/images/effects.jpg b/ko-KR/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/ko-KR/images/effects.jpg differ diff --git a/ko-KR/images/emboss.jpg b/ko-KR/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/ko-KR/images/emboss.jpg differ diff --git a/ko-KR/images/film.jpg b/ko-KR/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/ko-KR/images/film.jpg differ diff --git a/ko-KR/images/gpen.jpg b/ko-KR/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/ko-KR/images/gpen.jpg differ diff --git a/ko-KR/images/hatch.jpg b/ko-KR/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/ko-KR/images/hatch.jpg differ diff --git a/ko-KR/images/negative.jpg b/ko-KR/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/ko-KR/images/negative.jpg differ diff --git a/ko-KR/images/none.jpg b/ko-KR/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/ko-KR/images/none.jpg differ diff --git a/ko-KR/images/oilpaint.jpg b/ko-KR/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/ko-KR/images/oilpaint.jpg differ diff --git a/ko-KR/images/open-terminal-annotated.png b/ko-KR/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/ko-KR/images/open-terminal-annotated.png differ diff --git a/ko-KR/images/open-terminal.png b/ko-KR/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/ko-KR/images/open-terminal.png differ diff --git a/ko-KR/images/pastel.jpg b/ko-KR/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/ko-KR/images/pastel.jpg differ diff --git a/ko-KR/images/pi-camera-attached.jpg b/ko-KR/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/ko-KR/images/pi-camera-attached.jpg differ diff --git a/ko-KR/images/pi-configuration-interfaces-annotated.png b/ko-KR/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..564e8b1f Binary files /dev/null and b/ko-KR/images/pi-configuration-interfaces-annotated.png differ diff --git a/ko-KR/images/pi-configuration-interfaces.png b/ko-KR/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/ko-KR/images/pi-configuration-interfaces.png differ diff --git a/ko-KR/images/pi-configuration-menu.png b/ko-KR/images/pi-configuration-menu.png new file mode 100644 index 00000000..7a20c5eb Binary files /dev/null and b/ko-KR/images/pi-configuration-menu.png differ diff --git a/ko-KR/images/pi4-camera-port.png b/ko-KR/images/pi4-camera-port.png new file mode 100644 index 00000000..befc77a6 Binary files /dev/null and b/ko-KR/images/pi4-camera-port.png differ diff --git a/ko-KR/images/posterise.jpg b/ko-KR/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/ko-KR/images/posterise.jpg differ diff --git a/ko-KR/images/preview.jpg b/ko-KR/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/ko-KR/images/preview.jpg differ diff --git a/ko-KR/images/raspberry-pi.png b/ko-KR/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/ko-KR/images/raspberry-pi.png differ diff --git a/ko-KR/images/raspistill-help.png b/ko-KR/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/ko-KR/images/raspistill-help.png differ diff --git a/ko-KR/images/raspistill-image.png b/ko-KR/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/ko-KR/images/raspistill-image.png differ diff --git a/ko-KR/images/saturation.jpg b/ko-KR/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/ko-KR/images/saturation.jpg differ diff --git a/ko-KR/images/sketch.jpg b/ko-KR/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/ko-KR/images/sketch.jpg differ diff --git a/ko-KR/images/solarize.jpg b/ko-KR/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/ko-KR/images/solarize.jpg differ diff --git a/ko-KR/images/thonny-app-menu.png b/ko-KR/images/thonny-app-menu.png new file mode 100644 index 00000000..8935efb9 Binary files /dev/null and b/ko-KR/images/thonny-app-menu.png differ diff --git a/ko-KR/images/washedout.jpg b/ko-KR/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/ko-KR/images/washedout.jpg differ diff --git a/ko-KR/images/watercolor.jpg b/ko-KR/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/ko-KR/images/watercolor.jpg differ diff --git a/ko-KR/meta.yml b/ko-KR/meta.yml new file mode 100644 index 00000000..468d45d4 --- /dev/null +++ b/ko-KR/meta.yml @@ -0,0 +1,31 @@ +--- +title: 카메라 모듈 시작하기 +hero_image: images/banner.png +description: Raspberry Pi 카메라 모듈과 Python으로 사진과 동영상을 촬영합시다. +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: 소개 + - + title: 준비물 + - + title: 카메라 모듈 연결 + - + title: 명령 줄을 통해 카메라 모듈을 제어하는 방법 + completion: + - engaged + - + title: Python 코드를 통해 카메라 모듈을 제어하는 방법 + - + title: Python 코드로 스틸 사진 찍기 + - + title: Python 코드로 비디오 녹화 + - + title: 이미지 설정을 변경하고 이미지 효과를 추가하는 방법 + completion: + - internal + - + title: 더 나아가기 diff --git a/ko-KR/step_1.md b/ko-KR/step_1.md new file mode 100644 index 00000000..a1dcc691 --- /dev/null +++ b/ko-KR/step_1.md @@ -0,0 +1,9 @@ +## 들어가며 + +[[[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/ko-KR/step_2.md b/ko-KR/step_2.md new file mode 100644 index 00000000..b833db17 --- /dev/null +++ b/ko-KR/step_2.md @@ -0,0 +1,20 @@ +## 준비물 + +### 카메라 모듈 포트가 있는 Raspberry Pi + +현재 모든 Raspberry Pi 모델에는 카메라 모듈을 연결하는 포트가 있습니다. + +![카메라 모듈 포트가 분류된 Raspberry Pi 3B+](images/pi4-camera-port.png) + +**주의:** Raspberry Pi Zero를 사용하고 싶다면 Raspberry Pi Zero의 작은 카메라 모듈 포트에 맞는 카메라 모듈 리본 케이블이 필요합니다. + +### Raspberry Pi 카메라 모듈 + +![Raspberry Pi 카메라 모듈](images/camera-module.png) + +카메라 모듈에는 두 버전이 있습니다: + +* [standard 버전](https://www.raspberrypi.org/products/camera-module-v2/), 이것은 일반 조명에서 찍기 위해 설계되었습니다. +* [NoIR 버전](https://www.raspberrypi.org/products/pi-noir-camera-v2/), 이것은 적외선 필터가 없어서 적외선 광원과 함께 사용하여 어두운 곳에서 사진을 찍을 수 있습니다. + + diff --git a/ko-KR/step_3.md b/ko-KR/step_3.md new file mode 100644 index 00000000..ff6cf12c --- /dev/null +++ b/ko-KR/step_3.md @@ -0,0 +1,48 @@ +## 카메라 모듈 연결하기 + +**Raspberry Pi가 꺼졌는지 확인합니다.** + +--- no-print --- + +1. 카메라 모듈 포트를 찾습니다. +2. 포트의 플라스틱 클립 모서리를 부드럽게 위로 당깁니다. +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. 플라스틱 클립을 다시 제자리에 넣습니다. + +![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. 카메라 모듈 포트를 찾습니다. + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. 포트의 플라스틱 클립 모서리를 부드럽게 위로 당깁니다. + +![들어 올려진 카메라 모듈](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. + +![포트에 삽입된 카메라 모듈 리본 케이블](images/connect-camera3.png) + +4. 플라스틱 클립을 다시 제자리에 넣습니다. + +![아래로 눌린 카메라 모듈](images/connect-camera4.png) + +![아래로 눌린 카메라 모듈](images/connect-camera4.png) + +--- /print-only --- + +- Raspberry Pi 시작하기. + +- 메인 메뉴에 가서 **Raspberry Pi 구성** 도구를 엽니다. + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- **Interface** 탭을 선택하고 카메라가 **활성화** 되어 있는지 확인합니다. + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- Raspberry Pi를 다시 시작합니다. diff --git a/ko-KR/step_4.md b/ko-KR/step_4.md new file mode 100644 index 00000000..bf6db553 --- /dev/null +++ b/ko-KR/step_4.md @@ -0,0 +1,41 @@ +## 명령 줄을 통해 카메라 모듈을 제어하는 방법 + +이제 카메라 모듈이 연결되었고 소프트웨어가 활성화 되었습니다. 명령 줄 도구에서 `raspistill`과 `raspivid`를 시도합니다. + +- 작업 표시줄에서 검은 모니터 아이콘을 클릭해서 터미널 창을 엽니다. + +![터미널 열기](images/open-terminal-annotated.png) + +- 다음 명령을 입력하여 스틸 사진을 찍고 바탕 화면에 저장합니다. + +```bash +raspistill -o Desktop/image.jpg +``` + +![터미널에 입력된 raspistill 명령](images/raspistill-image.png) + +- 엔터를 누르고 명령을 실행합니다. + +명령이 작동하면 스틸 사진이 찍히기 전에 카메라 미리보기를 5초 동안 볼 수 있습니다. + +- 바탕 화면에서 사진 파일 아이콘을 찾아 더블 클릭해서 사진을 엽니다. + + ![바탕 화면의 이미지](images/desktop-annotated.png) + +`raspistill` 명령어에 다른 옵션을 추가함으로써, 크기와 사진 형태를 설정할 수 있습니다. + +- 예를 들어, 높이와 너비를 바꾸려면 `-h`와 `-w`를 추가하세요. + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- 이제 다음의 `raspivid` 명령을 사용하여 카메라 모듈로 영상을 녹화합니다. + +```bash +raspivid -o Desktop/video.h264 +``` + +- 영상 파일을 재생하기 위해서 바탕 화면에 있는 `video.h264` 파일 아이콘을 더블 클릭하여 VLC Media Player에서 엽니다. + +당신이 사용할 수 있는 더 많은 정보와 다른 옵션을 보려면 [raspisill를 위한 문서](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md)와 [raspivid를 위한 문서](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md) 명령을 이용할 수 있습니다. diff --git a/ko-KR/step_5.md b/ko-KR/step_5.md new file mode 100644 index 00000000..fad66ec4 --- /dev/null +++ b/ko-KR/step_5.md @@ -0,0 +1,49 @@ +## Python 코드를 통해 카메라 모듈을 제어하는 방법 + +Python `picamera` 라이브러리로 당신은 카메라 모듈을 조절하고 엄청난 프로젝트를 만들 수 있습니다. + +- **Thonny Python IDE**와 같은 Python 3 편집기를 엽니다: + + ![Thonny 열기](images/thonny-app-menu.png) + +- 새로운 파일을 열어 `camera.py`로 저장합니다. + + **주의:** **절대 파일을 `picamera.py`**로 저장하지 말아야 합니다! + +- 다음 코드를 추가하세요: + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- 프로그램을 저장하고 실행합니다. 카메라 미리보기는 5초 동안 보이고 다시 닫혀야 합니다. + + ![이미지 미리보기](images/preview.jpg) + + **주의:** 카메라 미리보기는 모니터가 Raspberry Pi와 연결되었을 때만 작동합니다. 원격 접속 프로그램(SSH나 VNC 같은) 을 이용하고 있다면 카메라 미리보기가 안 보입니다. + +- 미리보기가 위 아래로 뒤집어져 있다면 다음 코드로 180도 회전시킵니다. + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + `90`, `180`, 이나 `270`도로 사진을 회전할 수 있습니다. 이미지를 다시 설정하려면 `rotation`(회전) 을 `0`도로 바꿉니다. + +미리보기가 실행되는 동안 프로그램에서 에러가 발생하는지 보기 위해서 미리보기를 살짝 비쳐보이게 하는 것이 가장 좋습니다. + +- `alpha` 수준을 설정해서 카메라 미리보기가 비쳐보이게 만듭니다. + + ```python + amera.start_preview(alpha=200) + ``` + + `alpha` 값은 `0`과 `255`사이의 아무 숫자가 될 수 있습니다. \ No newline at end of file diff --git a/ko-KR/step_6.md b/ko-KR/step_6.md new file mode 100644 index 00000000..90130731 --- /dev/null +++ b/ko-KR/step_6.md @@ -0,0 +1,38 @@ +## Python 코드로 스틸 사진 찍기 + +이제 스틸 사진을 찍기 위해 카메라 모듈과 Python을 사용합니다. + +- `camera.capture()` 줄을 추가하도록 코드를 수정합니다: + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **주의:** 이미지를 찍기 적어도 2초 전에 `sleep`하는 것은 중요합니다. 왜냐하면 이는 카메라 센서가 조도를 감지할 시간을 주기 때문입니다. + +- 코드를 실행하세요. + +카메라 미리보기가 5 초 동안 열린 다음 스틸 사진이 찍혀야합니다. 사진이 찍히는 동안 미리보기가 다른 해상도로 잠시 조정되는 것을 볼 수 있습니다. + +새 이미지는 컴퓨터에 저장되어야 합니다. + +- 이제 연속으로 5 장의 사진을 찍는 루프를 추가합니다. + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + 변수 `i`는 `0`에서 `4`까지 루프가 몇 번 실행되었는지 셉니다. 따라서 이미지는 `image0.jpg`, `image1.jpg`등으로 저장됩니다. + +- 코드를 다시 실행하고 카메라 모듈을 제자리에 고정합니다. + +카메라는 5 초마다 한 장의 사진을 찍어야합니다. 일단 다섯 번째 사진이 촬영되면 미리보기가 닫힙니다. + +- 5개의 새로운 사진을 컴퓨터에서 찾습니다. \ No newline at end of file diff --git a/ko-KR/step_7.md b/ko-KR/step_7.md new file mode 100644 index 00000000..79e9ccf8 --- /dev/null +++ b/ko-KR/step_7.md @@ -0,0 +1,20 @@ +## Python 코드로 영상 녹화하기 + +이제 영상을 녹화합니다! + +- `capture()` 코드를 제거하고 대신에 `start_recording()`과 `stop_recording()`을 추가하기 위해 코드를 수정합니다. + + 다음과 같은 코드가 될 것입니다: + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- 코드를 실행하세요. + +Raspberry Pi가 미리보기를 열고 5초 동안 영상을 녹화하고, 미리보기를 닫아야 합니다. + diff --git a/ko-KR/step_8.md b/ko-KR/step_8.md new file mode 100644 index 00000000..fe62baad --- /dev/null +++ b/ko-KR/step_8.md @@ -0,0 +1,228 @@ +## 이미지 설정을 변경하고 이미지 효과를 추가하는 방법 + +Python `picamera` 라이브러리는 이미지를 바꾸는 많은 효과와 구성을 제공합니다. + +**주의:** 몇몇 환경설정은 찍힌 사진이 아니라 미리보기에만 영향을 미칩니다. 몇몇 은 찍힌 사진과 많은 다른 것들 모두에 영향을 미칩니다. + +### 이미지 해상도를 설정하기 + +카메라 모듈이 찍는 사진의 `resolution`(해상도) 를 바꿀 수 있습니다. + +기본값으로 이미지 해상도는 당신의 모니터 해상도로 설정되어 있습니다. 스틸 사진의 최대 해상도는 2592×1944이고 영상 녹화는 1920×1080입니다. + +- `resolution`를 최대로 설정하고 사진을 찍기 위해 다음의 코드를 사용하세요. + + **주의:** 최대 해상도를 사용가능하게 하려면 프레임 속도를 `15`로 설정해야 합니다. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +최소 해상도는 64×64 입니다. + +- 최소 해상도로 사진을 찍어보세요. + +### 이미지에 글 추가하기 + +명령 `annotate_text`을 이용해서 이미지에 글을 추가할 수 있습니다. + +- 이 코드를 실행하여 시도해 보세요: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### 추가된 글의 모양을 변경하기 + +- 다음의 코드로 글자의 크기를 설정하세요: + + ```python + camera.annotate_text_size = 50 + ``` + + `6`에서 `160`까지의 아무 크기로 글자 크기를 설정할 수 있습니다. 기본값은 `32` 입니다. + +글자 색깔을 바꾸는 것도 가능합니다. + +- 먼저, `Color`을 프로그램 맨 위에 있는 `import`에 추가하세요. + + ```python + from picamera import PiCamera, Color + ``` + +- 그런 다음 `import` 줄 아래에서 나머지 코드를 다음과 같이 수정합니다. + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### 미리보기의 밝기 변경 + +미리보기의 밝기를 변경할 수 있습니다. 기본 밝기는 `50`이고 `0` 에서 `100`사이의 값으로 설정할 수 있습니다. + +* 이것을 시도하려면 다음 코드를 실행하세요: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- 다음 루프는 밝기를 조정하고 텍스트를 추가하여 현재 밝기 수준을 표시합니다. + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### 미리보기의 대비 변경 + +미리보기 밝기와 마찬가지로 미리보기의 대비를 변경할 수 있습니다. + +- 이것을 시도하려면 다음 코드를 실행하세요: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### 멋진 이미지 효과 추가 + +`camera.image_effect` 을 사용하여 특정 이미지 효과를 적용할 수 있습니다. + +이미지 효과 옵션은 다음과 같습니다: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +기본값은 `none` 입니다. + +* 이미지 효과를 선택하고 사용해보세요: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* **모든** 이미지에 `camera.IMAGE_EFFECTS` 효과를 반복하기 위해서 이 코드를 실행하세요: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![효과](images/effects.jpg) + +### 이미지 노출 모드 설정 + +`camera.exposure_mode`를 사용하여 특정 모드에 대한 노출을 설정할 수 있습니다. + +다음의 옵션들을 사용할 수 있습니다: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +기본 모드는 `auto` 입니다. + +* 노출 모드를 선택하고 시도해 보세요: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* 이미지 효과에서 했던 것 처럼 전반적인 노출 모드를 `camera.EXPOSURE_MODES`로 반복할 수 있습니다. + +### 이미지 화이트 밸런스 변경 + +`camera.awb_mode`를 사용하여 자동 화이트 밸런스를 사전 설정 모드로 설정할 수 있습니다. + +사용 가능한 자동 화이트 밸런스 모드는 다음과 같습니다: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +기본값은 `auto`입니다. + +* 자동 화이트 밸런스 모드를 선택하고 사용해 보세요: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* 이미지 효과에서 했던 것 처럼 전반적인 화이트 밸런스 모드를 `camera.AWB_MODES`로 반복 할 수 있습니다. \ No newline at end of file diff --git a/ko-KR/step_9.md b/ko-KR/step_9.md new file mode 100644 index 00000000..bddbdfac --- /dev/null +++ b/ko-KR/step_9.md @@ -0,0 +1,17 @@ +## 더 나아가기 + +이제 카메라 모듈 사용 방법을 알았습니다. 예를 들면 다음과 같습니다: +* [GPIO Zero](https://gpiozero.readthedocs.org/) Python 코드로 카메라를 제어 버튼 추가 +* 카메라를 Minecraft Pi와 통합 +* 카메라의 사진을 트위터에 자동으로 게시 + +자세한 내용은 다음 카메라 모듈 프로젝트를 시도하세요: + +- [정지 동작 버튼 누르기](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) 필름 만들기 +- [마인크래프트 포토 부스](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) 만들기 +- 사진을 트윗하기 위해 [배비지 베어 얻기](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- [부모 감지기](https://projects.raspberrypi.org/en/projects/parent-detector/) 건설하기 +- NoIR 카메라 모듈을 사용하여 [적외선 새 상자](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) 만들기 + +카메라 모듈을 제어하기 위한 Python 코드를 쓰기 위한 정보는 연장적인 [picamera documentation](https://picamera.readthedocs.org/)에서 보세요. + diff --git a/mr-IN/images/Getting_Started_With_Picamera_TILE.png b/mr-IN/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/mr-IN/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/mr-IN/images/banner.png b/mr-IN/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/mr-IN/images/banner.png differ diff --git a/mr-IN/images/blur.jpg b/mr-IN/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/mr-IN/images/blur.jpg differ diff --git a/mr-IN/images/camera-module.png b/mr-IN/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/mr-IN/images/camera-module.png differ diff --git a/mr-IN/images/cartoon.jpg b/mr-IN/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/mr-IN/images/cartoon.jpg differ diff --git a/mr-IN/images/colorbalance.jpg b/mr-IN/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/mr-IN/images/colorbalance.jpg differ diff --git a/mr-IN/images/colorpoint.jpg b/mr-IN/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/mr-IN/images/colorpoint.jpg differ diff --git a/mr-IN/images/colorswap.jpg b/mr-IN/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/mr-IN/images/colorswap.jpg differ diff --git a/mr-IN/images/connect-camera-old.gif b/mr-IN/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/mr-IN/images/connect-camera-old.gif differ diff --git a/mr-IN/images/connect-camera.gif b/mr-IN/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/mr-IN/images/connect-camera.gif differ diff --git a/mr-IN/images/connect-camera.gif.gif b/mr-IN/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/mr-IN/images/connect-camera.gif.gif differ diff --git a/mr-IN/images/connect-camera1.png b/mr-IN/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/mr-IN/images/connect-camera1.png differ diff --git a/mr-IN/images/connect-camera2.png b/mr-IN/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/mr-IN/images/connect-camera2.png differ diff --git a/mr-IN/images/connect-camera3.png b/mr-IN/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/mr-IN/images/connect-camera3.png differ diff --git a/mr-IN/images/connect-camera4.png b/mr-IN/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/mr-IN/images/connect-camera4.png differ diff --git a/mr-IN/images/connect-camera5.png b/mr-IN/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/mr-IN/images/connect-camera5.png differ diff --git a/mr-IN/images/deinterlace1.jpg b/mr-IN/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/mr-IN/images/deinterlace1.jpg differ diff --git a/mr-IN/images/deinterlace2.jpg b/mr-IN/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/mr-IN/images/deinterlace2.jpg differ diff --git a/mr-IN/images/denoise.jpg b/mr-IN/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/mr-IN/images/denoise.jpg differ diff --git a/mr-IN/images/desktop-annotated.png b/mr-IN/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/mr-IN/images/desktop-annotated.png differ diff --git a/mr-IN/images/desktop.png b/mr-IN/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/mr-IN/images/desktop.png differ diff --git a/mr-IN/images/effects.jpg b/mr-IN/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/mr-IN/images/effects.jpg differ diff --git a/mr-IN/images/emboss.jpg b/mr-IN/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/mr-IN/images/emboss.jpg differ diff --git a/mr-IN/images/film.jpg b/mr-IN/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/mr-IN/images/film.jpg differ diff --git a/mr-IN/images/gpen.jpg b/mr-IN/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/mr-IN/images/gpen.jpg differ diff --git a/mr-IN/images/hatch.jpg b/mr-IN/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/mr-IN/images/hatch.jpg differ diff --git a/mr-IN/images/negative.jpg b/mr-IN/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/mr-IN/images/negative.jpg differ diff --git a/mr-IN/images/none.jpg b/mr-IN/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/mr-IN/images/none.jpg differ diff --git a/mr-IN/images/oilpaint.jpg b/mr-IN/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/mr-IN/images/oilpaint.jpg differ diff --git a/mr-IN/images/open-terminal-annotated.png b/mr-IN/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/mr-IN/images/open-terminal-annotated.png differ diff --git a/mr-IN/images/open-terminal.png b/mr-IN/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/mr-IN/images/open-terminal.png differ diff --git a/mr-IN/images/pastel.jpg b/mr-IN/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/mr-IN/images/pastel.jpg differ diff --git a/mr-IN/images/pi-camera-attached.jpg b/mr-IN/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/mr-IN/images/pi-camera-attached.jpg differ diff --git a/mr-IN/images/pi-configuration-interfaces-annotated.png b/mr-IN/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/mr-IN/images/pi-configuration-interfaces-annotated.png differ diff --git a/mr-IN/images/pi-configuration-interfaces.png b/mr-IN/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/mr-IN/images/pi-configuration-interfaces.png differ diff --git a/mr-IN/images/pi-configuration-menu.png b/mr-IN/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/mr-IN/images/pi-configuration-menu.png differ diff --git a/mr-IN/images/pi4-camera-port.png b/mr-IN/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/mr-IN/images/pi4-camera-port.png differ diff --git a/mr-IN/images/posterise.jpg b/mr-IN/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/mr-IN/images/posterise.jpg differ diff --git a/mr-IN/images/preview.jpg b/mr-IN/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/mr-IN/images/preview.jpg differ diff --git a/mr-IN/images/raspberry-pi.png b/mr-IN/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/mr-IN/images/raspberry-pi.png differ diff --git a/mr-IN/images/raspistill-help.png b/mr-IN/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/mr-IN/images/raspistill-help.png differ diff --git a/mr-IN/images/raspistill-image.png b/mr-IN/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/mr-IN/images/raspistill-image.png differ diff --git a/mr-IN/images/saturation.jpg b/mr-IN/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/mr-IN/images/saturation.jpg differ diff --git a/mr-IN/images/sketch.jpg b/mr-IN/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/mr-IN/images/sketch.jpg differ diff --git a/mr-IN/images/solarize.jpg b/mr-IN/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/mr-IN/images/solarize.jpg differ diff --git a/mr-IN/images/thonny-app-menu.png b/mr-IN/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/mr-IN/images/thonny-app-menu.png differ diff --git a/mr-IN/images/washedout.jpg b/mr-IN/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/mr-IN/images/washedout.jpg differ diff --git a/mr-IN/images/watercolor.jpg b/mr-IN/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/mr-IN/images/watercolor.jpg differ diff --git a/mr-IN/meta.yml b/mr-IN/meta.yml new file mode 100644 index 00000000..01a1a75c --- /dev/null +++ b/mr-IN/meta.yml @@ -0,0 +1,31 @@ +--- +title: कॅमेरा मॉड्यूल सुरु करणे +hero_image: images/banner.png +description: Raspberry Pi कॅमेरा मॉड्यूल आणि Python सह चित्रे आणि व्हिडिओ काढा +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: परिचय + - + title: तुम्हाला काय लागेल + - + title: कॅमेरा मॉड्यूल कनेक्ट करा + - + title: कमांड लाइनद्वारे कॅमेरा मॉड्यूल कसे नियंत्रित करावे + completion: + - engaged + - + title: Python कोडसह कॅमेरा मॉड्यूल कसे नियंत्रित करावे + - + title: Python कोडसह स्थिर चित्रे काढा + - + title: Python कोडसह व्हिडिओ रेकॉर्ड करा + - + title: चित्र सेटिंग्ज कशी बदलायची आणि चित्र परिणाम कसा जोडावा + completion: + - internal + - + title: पुढे काय? diff --git a/mr-IN/step_1.md b/mr-IN/step_1.md new file mode 100644 index 00000000..4ded93e9 --- /dev/null +++ b/mr-IN/step_1.md @@ -0,0 +1,9 @@ +## परिचय + +[[[camera-bullseye]]] + +आपल्या Raspberry Pi वर Raspberry Pi कॅमेरा मॉड्यूल कसा जोडायचा आणि चित्र काढणे, व्हिडिओ रेकॉर्ड करणे आणि चित्र परिणाम कसे वापरावे ते शिका. + +![रास्पबेरी पाई कॅमेरा मॉड्यूलसह घेतलेल्या R आणि P अक्षराचे चित्र](images/pi-camera-attached.jpg) + +![Raspberry Pi कॅमेरा मॉड्यूलसह घेतलेल्या R आणि P अक्षराचे चित्र](images/none.jpg) diff --git a/mr-IN/step_2.md b/mr-IN/step_2.md new file mode 100644 index 00000000..d1657546 --- /dev/null +++ b/mr-IN/step_2.md @@ -0,0 +1,20 @@ +## तुम्हाला काय लागेल + +### कॅमेरा मॉड्यूल पोर्टसह Raspberry Pi संगणक + +रास्पबेरी पाईच्या सर्व चालू मॉडेल्समध्ये कॅमेरा मॉड्यूल कनेक्ट करण्यासाठी एक पोर्ट आहे. + +![कॅमेरा मॉड्यूलसह रास्पबेरी पाई 3B+ जोडणे](images/pi4-camera-port.png) + +**टीप:** जर आपल्याला रास्पबेरी पाई झिरो वापरायचा असेल तर आपल्यास कॅमेरा मॉड्यूल रिबन केबलची आवश्यकता आहे जी रास्पबेरी पी झिरोच्या लहान कॅमेरा मॉड्यूल पोर्टला बसेल. + +### रास्पबेरी पाई कॅमेरा मॉड्यूल + +![रास्पबेरी पाई कॅमेरा मॉड्यूल](images/camera-module.png) + +कॅमेरा मॉड्यूलचे दोन प्रकार आहेत: + +* [मानक आवृत्ती](https://www.raspberrypi.org/products/camera-module-v2/) जी सामान्य प्रकाशात चित्रे काढण्यासाठी डिझाइन केलेली आहे +* [NoIR प्रकार](https://www.raspberrypi.org/products/pi-noir-camera-v2/) ज्यामध्ये इन्फ्रारेड फिल्टर नाही, म्हणून आपण अंधारामध्ये चित्रे काढण्यासाठी इन्फ्रारेड प्रकाशाच्या मार्गाने एकत्र वापरु शकता + + diff --git a/mr-IN/step_3.md b/mr-IN/step_3.md new file mode 100644 index 00000000..a9300b4b --- /dev/null +++ b/mr-IN/step_3.md @@ -0,0 +1,48 @@ +## कॅमेरा मॉड्यूल कनेक्ट करा + +**तुमचा रास्पबेरी पाई बंद असल्याचे खात्री करा.** + +--- no-print --- + +1. कॅमेरा मॉड्यूल पोर्ट शोधा +2. पोर्टवरचे प्लास्टिक क्लिप काठेवरुन हळूवारपणे वर खेचा +3. कॅमेरा मॉड्यूल रिबन केबल घाला; केबल बरोबर आत घालत आहात याची खात्री करा +4. प्लॅस्टिक क्लिप पुन्हा त्याच ठिकाणी ढकला + +![रास्पबेरी पाई कॅमेरा मॉड्यूल कसे कनेक्ट करावे त्याचे अ‍ॅनिमेशन](images/connect-camera.gif) + +--- /no-print --- + +--- print-only --- + +1. कॅमेरा मॉड्यूल पोर्ट शोधा. + +![रास्पबेरी पाई आणि कॅमेरा मॉड्यूल](images/connect-camera1.png) + +2. पोर्टवरचे प्लास्टिक क्लिप काठेवरुन हळूवारपणे वर खेचा. + +![कॅमेरा मॉड्यूल पोर्ट वर उचला](images/connect-camera2.png) + +3. कॅमेरा मॉड्यूल रिबन केबल घाला; केबल बरोबर आत घालत आहात याची खात्री करा. + +![कॅमेरा मॉड्यूल रिबन केबल पोर्टमध्ये घाला](images/connect-camera3.png) + +4. प्लॅस्टिक क्लिप पुन्हा त्याच ठिकाणी ढकला. + +![कॅमेरा मॉड्यूल पोर्ट खाली ढकला](images/connect-camera4.png) + +![कॅमेरा मॉड्यूल पोर्ट खाली ढकला](images/connect-camera4.png) + +--- /print-only --- + +- आपला रास्पबेरी पाई सुरु करा. + +- मुख्य मेनूवर जा आणि **Raspberry Pi Configuration** टूल उघडा. + + ![प्राधान्ये मेनूच्या आत रास्पबेरी पाई कॉन्फिगरेशन टूल](images/pi-configuration-menu.png) + +- **इंटरफेस** टॅब निवडा आणि कॅमेरा सुरु होयण्यासाठी परवानगी असल्याचे खात्री करा: + + ![इंटरफेस मेनूसह रास्पबेरी पाई कॉन्फिगरेशन टूल उघडले आणि कॅमेरा सक्षम केला](images/pi-configuration-interfaces-annotated.png) + +- आपला रास्पबेरी पाई रीबूट करा. diff --git a/mr-IN/step_4.md b/mr-IN/step_4.md new file mode 100644 index 00000000..ddcbe6e3 --- /dev/null +++ b/mr-IN/step_4.md @@ -0,0 +1,42 @@ +## कमांड लाइनद्वारे कॅमेरा मॉड्यूल कसे नियंत्रित करावे + +आता आपले कॅमेरा मॉड्यूल कनेक्ट झाले आहे आणि सॉफ्टवेअरला परवानगी दिली आहे, ह्या कमांड लाइन टूल्सचा वापरून पहा ` रासपिस्टील ` आणि ` रासपीव्हीड`. + +- टास्कबारमधील ब्लॅक मॉनिटर चिन्हावर क्लिक करून टर्मिनल विंडो उघडा: + +![टर्मिनल उघडा](images/open-terminal-annotated.png) + +- स्थिर चित्र घेण्यासाठी आणि डेस्कटॉपवर सेव्ह करण्यासाठी खालील आदेश टाइप करा: + +```bash +raspistill -o Desktop/image.jpg +``` + +![रासपिस्टील कमांड टर्मिनलमध्ये दाखल झाली](images/raspistill-image.png) + +- कमांड चालविण्यासाठी Enter दाबा. + +जेव्हा कमांड चालू होते, तेव्हा स्थिर चित्र घेण्यापूर्वी आपण कॅमेरा प्रिव्यू पाच सेकंदांसाठी पाहू शकता. + +- डेस्कटॉपवर चित्र फाइल आयकॉन पहा आणि चित्र उघडण्यासाठी फाइल आयकॉनवर डबल-क्लिक करा. + + ![डेस्कटॉपवरील चित्र](images/desktop-annotated.png) + +वेगवेगळे पर्याय जोडून आपण ` raspistill ` आदेश घेत असलेल्या चित्राचे आकार आणि स्वरूप सेट करू शकता. + +- उदाहरणार्थ, चित्राची उंची आणि रुंदी बदलण्यासाठी ` -h +` आणि ` -w ` जोडा: + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- आता खालील ` raspivid ` कमांडचा वापर करून कॅमेरा मॉड्यूलसह व्हिडिओ रेकॉर्ड करा: + +```bash +raspivid -o Desktop/video.h264 +``` + +- व्हिडिओ फाइल प्ले करण्यासाठी, डेस्कटॉपवरील ` video.h264 ` फाइल VLC मीडिया प्लेयरमध्ये उघडण्यासाठी त्यावरील आयकॉनवर डबल-क्लिक करा. + +अधिक माहितीसाठी आणि इतर पर्यायांसाठी आपण या आदेशांसह वापरू शकता [डॉक्युमेंटेशन फॉर रासपिस्टील](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) आणि [ डॉक्युमेंटेशन फॉर रासपीव्हीड ](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md) हे कमांड वाचा. diff --git a/mr-IN/step_5.md b/mr-IN/step_5.md new file mode 100644 index 00000000..67e83e3f --- /dev/null +++ b/mr-IN/step_5.md @@ -0,0 +1,49 @@ +## पायथन कोडसह कॅमेरा मॉड्यूल कसे नियंत्रित करावे + +पायथन `पाईकॅमेरा ` लायब्ररी आपल्याला आपला कॅमेरा मॉड्यूल नियंत्रित करण्यास आणि आश्चर्यकारक प्रोजेक्ट्स तयार करण्यास परवानगी देते. + +- पायथन 3 एडिटर उघडा, जसे ** Thonny Python IDE**: + + ![ओपन Thonny](images/thonny-app-menu.png) + +- एक नवीन फाईल उघडा आणि त्यास ` camera.py ` म्हणून सेव्ह करा. + + ** टीप: ** हे महत्वाचे आहे की आपण ** कधीही ` picamera.py <` ** म्हणून फाइल सेव्ह करू नका. + +- खालील कोड एंटर करा: + + ```python + from picamera import Picamera + from time import sleep + + camera = Picamera () + + camera.start_preview() + sleep (5) + camera.stop_preview() + ``` + +- आपला प्रोग्राम सेव्ह करा आणि चालवा. कॅमेरा प्रिव्यू पाच सेकंदासाठी दाखवावा आणि नंतर पुन्हा बंद करावा. + + ![चित्र प्रिव्यू](images/preview.jpg) + + ** टीप: ** जेव्हा मॉनिटर आपल्या रास्पबेरी पाईला कनेक्ट केलेला असेल तेव्हाच कॅमेरा प्रिव्यू काम करते. आपण रिमोट ऍक्सेस वापरत असल्यास(जसे की SSH किंवा VNC), आपण 'कॅमेरा प्रिव्यू पाहू शकणार नाही. + +- जर आपले प्रिव्यू उलट असेल तर आपण खालील कोडसह 180 डिग्री तो फिरवू शकता: + + ```python + camera = PiCamera() + camera. rotation = 180 + ``` + + आपण चित्र ` 90 `, ` 180 `, किंवा ` 270 ` डिग्रीमध्ये फिरवू शकता. चित्र रीसेट करण्यासाठी ` rotation ` ` 0 ` डिग्रीमध्ये सेट करा. + +प्रिव्यू किंचित पाहणे चांगले आहे जेणेकरून प्रिव्यू चालू असताना आपल्या प्रोग्राममध्ये चुका आढळतात की नाही ते आपण पाहू शकता. + +- ` alpha` पातळी सेट करुन कॅमेरा प्रिव्यू बनवा: + + ```python + camera.start_preview(alpha=200) + ``` + + ` अल्फा मूल्य 0 ` आणि ` 255 ` दरम्यान कोणतीही संख्या असू शकते. \ No newline at end of file diff --git a/mr-IN/step_6.md b/mr-IN/step_6.md new file mode 100644 index 00000000..fe0cce78 --- /dev/null +++ b/mr-IN/step_6.md @@ -0,0 +1,38 @@ +## पायथन कोडसह स्थीर चित्रे घ्या + +काही स्थिर चित्रे घेण्यासाठी आता कॅमेरा मॉड्यूल आणि पायथन वापरा. + +- ` camera.capture () ` ओळ जोडण्यासाठी आपल्या कोडमध्ये सुधारणा करा: + + ```python + cameta.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + ** टीप: ** चित्र कॅप्चर करण्यापूर्वी ` स्लीप` कमीतकमी दोन सेकंदांकरिता हे महत्वाचे आहे कारण यामुळे कॅमेरा सेन्सरला प्रकाश पातळी समजण्यास वेळ देते. + +- कोड चालवा. + +आपण कॅमेरा प्रिव्यू पाच सेकंदांसाठी पाहिले पाहिजे आणि नंतर स्थिर चित्र कॅप्चर केले पाहिजे. चित्र घेतल्यामुळे आपण प्रिव्यू थोडक्यात वेगवेगळे निराकरणासह पाहू शकता. + +आपली नवीन चित्र डेस्कटॉपवर सेव्ह केली जावी. + +- सलग पाच चित्रे घेण्यासाठी आता एक लूप जोडा: + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + ` i ` व्हेरिएबल ` 0 ` पासून ` 4 ` पर्यंत किती वेळा लूप चालू आहे याची गणना करते. म्हणूनच, चित्र ` image0.jpg `, ` image1.jpg ` म्हणून सेव्ह केल्या जातात. + +- कोड पुन्हा चालवा आणि एका ठिकाणी कॅमेरा मॉड्यूल दाबून ठेवा. + +कॅमेर्‍याने दर पाच सेकंदात एक चित्र घ्यावे. एकदा पाचवे चित्र घेतल्यानंतर प्रिव्यू बंद होते. + +- पाच नवीन चित्रे शोधण्यासाठी आपल्या डेस्कटॉपवर पहा. \ No newline at end of file diff --git a/mr-IN/step_7.md b/mr-IN/step_7.md new file mode 100644 index 00000000..d2e30489 --- /dev/null +++ b/mr-IN/step_7.md @@ -0,0 +1,18 @@ +## पायथन कोडसह व्हिडिओ रेकॉर्ड करा + +आता एक व्हिडिओ रेकॉर्ड करा! + +- ` capture`() काढून टाकण्यासाठी आपल्या कोडमध्ये सुधारणा करा आणि त्याऐवजी ` start_recording()` आणि ` stop_recording() जोडा

+ +

आपला कोड आता यासारखा दिसला पाहिजे: +

    camera.start_preview()
+    camera.start_recording('/home/pi/Desktop/video.h264')
+    sleep(5)
+    camera.stop_recording()
+    camera.stop_preview()
+`
+ +- कोड चालवा. + +आपल्या रास्पबेरी पाईने प्रिव्यू उघडावा, 5 सेकंदाचा व्हिडिओ रेकॉर्ड करावा आणि नंतर प्रिव्यू बंद करा. + diff --git a/mr-IN/step_8.md b/mr-IN/step_8.md new file mode 100644 index 00000000..337651b8 --- /dev/null +++ b/mr-IN/step_8.md @@ -0,0 +1,228 @@ +## चित्र सेटिंग्ज कशी बदलायची आणि चित्र प्रभाव कसा वाढवावा + +पायथन ` पाईकॅमेरा ` सॉफ्टवेअर आपले चित्र कशे दिसतात हे बदलण्यासाठी बरेच प्रभाव आणि कॉन्फिगरेशन प्रदान करते. + +**टीप:** काही सेटिंग्ज केवळ प्रिव्यूवर परिणाम करतात आणि कॅप्चर केलेल्या चित्रावर नाहीत तर काही केवळ कॅप्चर केलेल्या चित्रावर परिणाम करतात आणि बर्‍याचदा इतरांवर दोन्ही प्रभाव करतात. + +### चित्र ठराव सेट करा + +आपण कॅमेरा मॉड्यूलने घेतलेल्या चित्राचे ` रिझोल्यूशन ` बदलू शकता. + +डीफॉल्टनुसार, चित्राचे रेझोल्यूशन आपल्या मॉनिटरच्या रेजोल्यूशनवर सेट केले जाते. स्थिर फोटोंसाठी अधिकतम रिझोल्यूशन 2592 × 1944 आणि व्हिडिओ रेकॉर्डिंगसाठी 1920 × 1080 आहे. + +- जास्तीत जास्त ` रिझोल्यूशन ` सेट करण्यासाठी आणि चित्र काढण्यासाठी खालील कोड वापरा. + + ** टीप: ** हे जास्तीत जास्त रिजोल्यूशन सक्षम करण्यासाठी आपल्याला ` 15 ` वर फ्रेम रेट देखील सेट करणे आवश्यक आहे. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +कमीतकमी रिझोल्यूशन 64 × 64 हे आहे. + +- कमीतकमी रिझोल्यूशनसह फोटो काढण्याचा प्रयत्न करा. + +### आपल्या चित्राला टेक्स्ट जोडा + +` annotate_text` आदेश वापरून आपण आपल्या चित्रावर टेक्स्ट जोडू शकता. + +- प्रयत्न करण्यासाठी हा कोड चालवा: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### ऍड केलेल्या टेक्स्ट मधे बदल करा + +- खालील कोडसह टेक्स्टचा आकार सेट करा: + + ```python + camera.annotate_text_size = 50 + ``` + + `6` ते `160`दरम्यान कोणत्याही टेक्स्टचा आकार सेट करू शकता. डीफॉल्ट आकार `32` हा आहे. + +टेक्स्टचा रंग बदलणे देखील शक्य आहे. + +- सर्वप्रथम, ऍड ` color` प्रोग्रामच्या सगळ्यात वरच्या ओळीवर ` इम्पोर्ट ` करा: + + ```python + पाईकॅमेरामधून इम्पोर्ट पाईकॅमेरा, रंग + ``` + +- नंतर ` इम्पोर्ट ` रेषा खाली आपल्या उर्वरित कोडमध्ये सुधारणा करा जेणेकरुन हे दिसते: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### प्रिव्यूची चमक बदला + +प्रिव्यू किती चमकदार आहे ते आपण बदलू शकता. डीफॉल्ट ब्राइटनेस `50` `0` आणि `100`दरम्यान कोणत्याही मूल्यावर सेट करू शकता. + +* हे वापरून पहाण्यासाठी खालील कोड चालवा: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- खालील लूप चमक समायोजित करते आणि सद्य ब्राइटनेस पातळी दर्शविण्यासाठी टेक्स्ट ऍड करते: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### प्रिव्यूची चमक बदला + +प्रीव्यू ब्राइटनेस प्रमाणेच तुम्ही प्रीव्यूचा कॉन्ट्रास्ट बदलू शकता. + +- हे वापरून पहाण्यासाठी खालील कोड चालवा: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### मस्त चित्रावर प्रभाव ऍड करा + +विशिष्ट चित्रावर प्रभाव लागू करण्यासाठी आपण ` camera.image_effect ` वापरू शकता. + +चित्र प्रभाव पर्याय असे आहेत: + +* `एकही नाही` +* `नकारात्मक` +* `सोलराईज` +* `स्केच` +* `डीनॉईज` +* `emboss` +* `ऑईल पेंट` +* `hatch` +* `gpen` +* `रंगीत खडू` +* `वॉटर कलर` +* `चित्रपट` +* `अस्पष्ट` +* `सॅच्युरेशन` +* `कलर्सवॅप` +* `वॉशआउट` +* `पोस्टरिझ` +* `कलरपॉईंट` +* `कलर बॅलेन्स` +* `कार्टून` +* `डीइंटरलेस1` +* `डीइंटरलेस2` + +डीफॉल्ट आकार `none` हा आहे. + +* एक चित्राचा प्रभाव निवडा आणि प्रयत्न करा: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* **all** सगळ्या चित्रांच्या प्रभावावर लूप करण्यासाठी ह्या कोडचा वापर करा `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![इफेक्ट](images/effects.jpg) + +### चित्रांचे एक्सपोजर मोड सेट करा + +विशिष्ट मोडमध्ये एक्सपोजर सेट करण्यासाठी `camera.exposure_mode` वापरू शकता. + +एक्सपोजर मोडचे पर्याय असे आहेत: +* `ऑफ` +* `ऑटो` +* `नाईट` +* `नाईटप्रिव्यू` +* `बॅकलाईट` +* `स्पॉटलाईट` +* `खेळ` +* `बर्फ` +* `बिच` +* `खूप लांब` +* `फिक्स्ड एफपीएस` +* `अँटीशेक` +* `फटाके` + +डीफॉल्ट मोड`auto` हा आहे. + +* एक्सपोजर मोड निवडा आणि प्रयत्न करा: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* आपण चित्रांच्या प्रभावांसाठी केले त्याप्रमाणे ` camera.EXPOSURE_MODES ` ह्याच्या साह्याने सर्व एक्सपोजर मोडमध्ये लूप करू शकता. + +### चित्राची व्हाईट बॅलन्स बदला + +ऑटो व्हाईट बॅलन्सला प्रीसेट मोडमध्ये सेट करण्यासाठी आपण `camera.awb_mode` वापरा. + +उपलब्ध ऑटो व्हाईट बॅलन्स मोड आहेत: +* `बंद` +* `ऑटो` +* `सूर्यप्रकाश` +* `ढगाळ` +* `सावली` +* `टंगस्टन` +* `फ्लुरोसंट` +* `चमकणारा` +* `फ्लॅश` +* `हॉरीझॉन` + +डीफॉल्ट`auto` हा आहे. + +* एक ऑटो व्हाइट बॅलन्स मोड निवडा आणि प्रयत्न करा: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* ऑटो व्हाईट बॅलन्सला प्रीसेट मोडमध्ये सेट करण्यासाठी आपण `camera.awb_mode` वापरा जसे आपण चित्रांच्या प्रभावांसाठी केले त्याप्रमाणे. \ No newline at end of file diff --git a/mr-IN/step_9.md b/mr-IN/step_9.md new file mode 100644 index 00000000..186c4a8e --- /dev/null +++ b/mr-IN/step_9.md @@ -0,0 +1,17 @@ +## मदत कुठे शोधावी? + +आपला कॅमेरा मॉड्यूल कसा वापरायचा हे आता आपल्याला माहित आहे, उदाहरणार्थ आपण हे करू शकता: +* [ GPIO Zero ](https://gpiozero.readthedocs.org/) पायथन कोडच्या मदतीने कॅमेरा नियंत्रित करण्यासाठी बटणे जोडा +* मिनीक्राफ्ट पाई सह कॅमेराला एकत्र करा +* ट्विटरवर कॅमेर्‍याची चित्रे आपोआप पोस्ट करा + +अधिक जाणून घेण्यासाठी हे कॅमेरा मॉड्यूल प्रकल्प वापरून पहा: + +- एक [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) फिल्मच तयार करा +- [Minecraft photobooth ](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) बनवा +- मिळवा [बॅबेज बेअर टू ट्विट पिक्चरर्स](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- [ पॅरेन्ट डिटेक्टर ](https://projects.raspberrypi.org/en/projects/parent-detector/) तयार करा +- [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/)तयार करण्यासाठी NoIR कॅमेरा मॉड्यूल वापरा + +कॅमेरा मॉड्यूल नियंत्रित करण्यासाठी पायथन कोड लिहिण्याबद्दल अधिक माहितीसाठी,[ पाईकॅमेरा डॉक्युमेंटेशन ](https://picamera.readthedocs.org/) वाचा. + diff --git a/nl-NL/images/Getting_Started_With_Picamera_TILE.png b/nl-NL/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/nl-NL/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/nl-NL/images/banner.png b/nl-NL/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/nl-NL/images/banner.png differ diff --git a/nl-NL/images/blur.jpg b/nl-NL/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/nl-NL/images/blur.jpg differ diff --git a/nl-NL/images/camera-module.png b/nl-NL/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/nl-NL/images/camera-module.png differ diff --git a/nl-NL/images/cartoon.jpg b/nl-NL/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/nl-NL/images/cartoon.jpg differ diff --git a/nl-NL/images/colorbalance.jpg b/nl-NL/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/nl-NL/images/colorbalance.jpg differ diff --git a/nl-NL/images/colorpoint.jpg b/nl-NL/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/nl-NL/images/colorpoint.jpg differ diff --git a/nl-NL/images/colorswap.jpg b/nl-NL/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/nl-NL/images/colorswap.jpg differ diff --git a/nl-NL/images/connect-camera-old.gif b/nl-NL/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/nl-NL/images/connect-camera-old.gif differ diff --git a/nl-NL/images/connect-camera.gif b/nl-NL/images/connect-camera.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/nl-NL/images/connect-camera.gif differ diff --git a/nl-NL/images/connect-camera.gif.gif b/nl-NL/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/nl-NL/images/connect-camera.gif.gif differ diff --git a/nl-NL/images/connect-camera1.png b/nl-NL/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/nl-NL/images/connect-camera1.png differ diff --git a/nl-NL/images/connect-camera2.png b/nl-NL/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/nl-NL/images/connect-camera2.png differ diff --git a/nl-NL/images/connect-camera3.png b/nl-NL/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/nl-NL/images/connect-camera3.png differ diff --git a/nl-NL/images/connect-camera4.png b/nl-NL/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/nl-NL/images/connect-camera4.png differ diff --git a/nl-NL/images/connect-camera5.png b/nl-NL/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/nl-NL/images/connect-camera5.png differ diff --git a/nl-NL/images/deinterlace1.jpg b/nl-NL/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/nl-NL/images/deinterlace1.jpg differ diff --git a/nl-NL/images/deinterlace2.jpg b/nl-NL/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/nl-NL/images/deinterlace2.jpg differ diff --git a/nl-NL/images/denoise.jpg b/nl-NL/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/nl-NL/images/denoise.jpg differ diff --git a/nl-NL/images/desktop-annotated.png b/nl-NL/images/desktop-annotated.png new file mode 100644 index 00000000..df1b2804 Binary files /dev/null and b/nl-NL/images/desktop-annotated.png differ diff --git a/nl-NL/images/desktop.png b/nl-NL/images/desktop.png new file mode 100644 index 00000000..0e52ffd5 Binary files /dev/null and b/nl-NL/images/desktop.png differ diff --git a/nl-NL/images/effects.jpg b/nl-NL/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/nl-NL/images/effects.jpg differ diff --git a/nl-NL/images/emboss.jpg b/nl-NL/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/nl-NL/images/emboss.jpg differ diff --git a/nl-NL/images/film.jpg b/nl-NL/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/nl-NL/images/film.jpg differ diff --git a/nl-NL/images/gpen.jpg b/nl-NL/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/nl-NL/images/gpen.jpg differ diff --git a/nl-NL/images/hatch.jpg b/nl-NL/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/nl-NL/images/hatch.jpg differ diff --git a/nl-NL/images/negative.jpg b/nl-NL/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/nl-NL/images/negative.jpg differ diff --git a/nl-NL/images/none.jpg b/nl-NL/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/nl-NL/images/none.jpg differ diff --git a/nl-NL/images/oilpaint.jpg b/nl-NL/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/nl-NL/images/oilpaint.jpg differ diff --git a/nl-NL/images/open-terminal-annotated.png b/nl-NL/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/nl-NL/images/open-terminal-annotated.png differ diff --git a/nl-NL/images/open-terminal.png b/nl-NL/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/nl-NL/images/open-terminal.png differ diff --git a/nl-NL/images/pastel.jpg b/nl-NL/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/nl-NL/images/pastel.jpg differ diff --git a/nl-NL/images/pi-camera-attached.jpg b/nl-NL/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/nl-NL/images/pi-camera-attached.jpg differ diff --git a/nl-NL/images/pi-configuration-interfaces-annotated.png b/nl-NL/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..3cbafa13 Binary files /dev/null and b/nl-NL/images/pi-configuration-interfaces-annotated.png differ diff --git a/nl-NL/images/pi-configuration-interfaces.png b/nl-NL/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..ffa106e3 Binary files /dev/null and b/nl-NL/images/pi-configuration-interfaces.png differ diff --git a/nl-NL/images/pi-configuration-menu.png b/nl-NL/images/pi-configuration-menu.png new file mode 100644 index 00000000..0ec59584 Binary files /dev/null and b/nl-NL/images/pi-configuration-menu.png differ diff --git a/nl-NL/images/pi4-camera-port.png b/nl-NL/images/pi4-camera-port.png new file mode 100644 index 00000000..255ae887 Binary files /dev/null and b/nl-NL/images/pi4-camera-port.png differ diff --git a/nl-NL/images/posterise.jpg b/nl-NL/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/nl-NL/images/posterise.jpg differ diff --git a/nl-NL/images/preview.jpg b/nl-NL/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/nl-NL/images/preview.jpg differ diff --git a/nl-NL/images/raspberry-pi.png b/nl-NL/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/nl-NL/images/raspberry-pi.png differ diff --git a/nl-NL/images/raspistill-help.png b/nl-NL/images/raspistill-help.png new file mode 100644 index 00000000..e2fe4866 Binary files /dev/null and b/nl-NL/images/raspistill-help.png differ diff --git a/nl-NL/images/raspistill-image.png b/nl-NL/images/raspistill-image.png new file mode 100644 index 00000000..e9d620c4 Binary files /dev/null and b/nl-NL/images/raspistill-image.png differ diff --git a/nl-NL/images/saturation.jpg b/nl-NL/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/nl-NL/images/saturation.jpg differ diff --git a/nl-NL/images/sketch.jpg b/nl-NL/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/nl-NL/images/sketch.jpg differ diff --git a/nl-NL/images/solarize.jpg b/nl-NL/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/nl-NL/images/solarize.jpg differ diff --git a/nl-NL/images/thonny-app-menu.png b/nl-NL/images/thonny-app-menu.png new file mode 100644 index 00000000..f310ab8d Binary files /dev/null and b/nl-NL/images/thonny-app-menu.png differ diff --git a/nl-NL/images/washedout.jpg b/nl-NL/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/nl-NL/images/washedout.jpg differ diff --git a/nl-NL/images/watercolor.jpg b/nl-NL/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/nl-NL/images/watercolor.jpg differ diff --git a/nl-NL/meta.yml b/nl-NL/meta.yml new file mode 100644 index 00000000..69d7c9f5 --- /dev/null +++ b/nl-NL/meta.yml @@ -0,0 +1,31 @@ +--- +title: Aan de slag met de cameramodule +hero_image: images/banner.png +description: Maak foto's en video's met de Raspberry Pi-cameramodule en Python +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: Inleiding + - + title: Wat heb je nodig + - + title: Sluit de cameramodule aan + - + title: De cameramodule bedienen via de opdrachtregel + completion: + - engaged + - + title: De cameramodule bedienen met Python-code + - + title: Maak foto's met Python-code + - + title: Neem video op met Python-code + - + title: Hoe je de beeldinstellingen kunt wijzigen en beeldeffecten kunt toevoegen + completion: + - internal + - + title: Wat kun je verder nog doen? diff --git a/nl-NL/step_1.md b/nl-NL/step_1.md new file mode 100644 index 00000000..4571a1f5 --- /dev/null +++ b/nl-NL/step_1.md @@ -0,0 +1,9 @@ +## Inleiding + +[[[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/nl-NL/step_2.md b/nl-NL/step_2.md new file mode 100644 index 00000000..a5fb5b9e --- /dev/null +++ b/nl-NL/step_2.md @@ -0,0 +1,20 @@ +## Wat heb je nodig + +### Raspberry Pi-computer met een cameramodulepoort + +Alle huidige modellen Raspberry Pi hebben een poort voor het aansluiten van de cameramodule. + +![Raspberry Pi 3B + met cameramodulepoort gelabeld](images/pi4-camera-port.png) + +**Opmerking:** als je een Raspberry Pi Zero wilt gebruiken, heb je een Cameramodule-lintkabel nodig die past bij de kleinere poort van de Raspberry Pi Zero voor de cameramodule. + +### Raspberry Pi-cameramodule + +![Raspberry Pi-cameramodule](images/camera-module.png) + +Er zijn twee versies van de cameramodule: + +* [De standaardversie](https://www.raspberrypi.org/products/camera-module-v2/), die is ontworpen om foto's te maken bij normaal licht +* [De NoIR-versie](https://www.raspberrypi.org/products/pi-noir-camera-v2/), die geen infraroodfilter heeft, dus je kunt het samen met een infraroodlichtbron gebruiken om foto's te maken in het donker + + diff --git a/nl-NL/step_3.md b/nl-NL/step_3.md new file mode 100644 index 00000000..5f8e383f --- /dev/null +++ b/nl-NL/step_3.md @@ -0,0 +1,48 @@ +## Sluit de cameramodule aan + +**Zorg ervoor dat je Raspberry Pi is uitgeschakeld.** + +--- no-print --- + +1. Zoek de poort van de cameramodule +2. Trek voorzichtig de randen van de plastic clip van de poort omhoog +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. Druk de plastic klem terug op zijn plaats + +![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. Zoek de poort van de cameramodule. + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. Trek voorzichtig de randen van de plastic clip van de poort omhoog. + +![de poort van de cameramodule is omhoog getild](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. + +![lintkabel van cameramodule in poort gestoken](images/connect-camera3.png) + +4. Druk de plastic klem terug op zijn plaats. + +![camera module port pushed down](images/connect-camera4.png) + +![camera module port pushed down](images/connect-camera4.png) + +--- /print-only --- + +- Start de Raspberry Pi op. + +- Ga naar het hoofdmenu en open het **Raspberry Pi-configuratie** programma. + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- Selecteer het tabblad **interfaces** en zorg ervoor dat de camera **ingeschakeld** is: + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- Start je Raspberry Pi opnieuw op. diff --git a/nl-NL/step_4.md b/nl-NL/step_4.md new file mode 100644 index 00000000..ce04340a --- /dev/null +++ b/nl-NL/step_4.md @@ -0,0 +1,41 @@ +## De cameramodule bedienen via de opdrachtregel + +Nu de cameramodule is aangesloten en de software is ingeschakeld, probeer dan de opdrachtregelprogramma's `raspistill` en `raspivid` uit. + +- Open een terminalvenster door op het zwarte monitorpictogram op de taakbalk te klikken: + +![Open de terminal](images/open-terminal-annotated.png) + +- Typ de volgende opdracht om een foto te maken en op het bureaublad op te slaan: + +```bash +raspistill -o Desktop/image.jpg +``` + +![raspistill commando ingevoerd in de terminal](images/raspistill-image.png) + +- Druk op Enter om het commando uit te voeren. + +Wanneer de opdracht wordt uitgevoerd, wordt het cameravoorbeeld vijf seconden geopend voordat er een foto wordt gemaakt. + +- Zoek het pictogram van het afbeeldingsbestand op het bureaublad en dubbelklik op het pictogram om de afbeelding te openen. + + ![Afbeelding op bureaublad](images/desktop-annotated.png) + +Door verschillende opties toe te voegen, kun je de grootte en het uiterlijk van de afbeelding instellen die het `raspistill` commando maakt. + +- Voeg bijvoorbeeld `-h` en `-w` toe om de hoogte en breedte van de afbeelding te wijzigen: + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- Neem nu een video op met de cameramodule door het volgende `raspivid` commando te gebruiken: + +```bash +raspivid -o Desktop/video.h264 +``` + +- Om het videobestand af te spelen, dubbelklik je op het `video.h264` bestandspictogram op het bureaublad om het te openen in VLC Media Player. + +Lees voor meer informatie en andere opties die je met deze commando's kunt gebruiken de [documentatie voor raspistill](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) en de [documentatioe voor raspivid](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md). diff --git a/nl-NL/step_5.md b/nl-NL/step_5.md new file mode 100644 index 00000000..0920e01a --- /dev/null +++ b/nl-NL/step_5.md @@ -0,0 +1,49 @@ +## De cameramodule bedienen met Python-code + +Met de Python `picamera` bibliotheek kun je je cameramodule besturen en geweldige projecten maken. + +- Open een Python 3 editor, zoals **Thonny Python IDE**: + + ![Open Thonny](images/thonny-app-menu.png) + +- Open een nieuw bestand en sla het op als `camera.py`. + + **Opmerking:** het is belangrijk dat je **het bestand nooit opslaat als `picamera.py`**. + +- Voer de volgende code in: + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera() + + camera.start_preview() + sleep(5) + camera.stop_preview() + ``` + +- Sla je programma op en voer het uit. Het voorbeeld van de camera moet vijf seconden lang worden weergegeven en vervolgens weer worden gesloten. + + ![Voorbeeld van afbeelding](images/preview.jpg) + + **Opmerking:** het voorbeeld van de camera werkt alleen als een monitor is aangesloten op de Raspberry Pi. Als je externe toegang gebruikt (zoals SSH of VNC), zie je het voorbeeld van de camera niet. + +- Als je voorbeeld ondersteboven staat, kun je het met de volgende code 180 graden draaien: + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + Je kunt de afbeelding draaien met `90`, `180` of `270` graden. Om de afbeelding te resetten, stel je `rotation` in op `0` graden. + +Het is het beste om het voorbeeld een beetje doorschijnend te maken, zodat je kunt zien of er fouten in je programma optreden terwijl het voorbeeld is ingeschakeld. + +- Laat het voorbeeld van de camera zien door een `alpha`-niveau in te stellen: + + ```python + camera.start_preview(alpha=200) + ``` + + De `alpha` waarde kan elk getal zijn tussen `0` en `255`. \ No newline at end of file diff --git a/nl-NL/step_6.md b/nl-NL/step_6.md new file mode 100644 index 00000000..b92cc437 --- /dev/null +++ b/nl-NL/step_6.md @@ -0,0 +1,38 @@ +## Maak foto's met Python-code + +Gebruik nu de cameramodule en Python om wat foto's te maken. + +- Wijzig je code om een `camera.capture()` regel toe te voegen: + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **Opmerking:** het is belangrijk om `te slapen` gedurende ten minste twee seconden voordat een afbeelding wordt gemaakt, omdat dit de sensor van de camera tijd geeft om het lichtniveau te detecteren. + +- Voer de code uit. + +Je zou het voorbeeld van de camera vijf seconden open moeten zien staan en dan zou er een foto moeten worden gemaakt. Terwijl de foto wordt gemaakt, kun je zien dat het voorbeeld kort wordt aangepast aan een andere resolutie. + +Je nieuwe afbeelding moet op het bureaublad worden opgeslagen. + +- Voeg nu een lus toe om vijf foto's achter elkaar te maken: + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + De variabele `i` telt hoe vaak de lus is uitgevoerd, van `0` tot `4`. Daarom worden de afbeeldingen opgeslagen als `image0.jpg`, `image1.jpg`, enzovoort. + +- Voer de code opnieuw uit en houd de cameramodule op zijn plaats. + +De camera zou elke vijf seconden een foto moeten maken. Zodra de vijfde foto is gemaakt, wordt het voorbeeld gesloten. + +- Kijk op je bureaublad om de vijf nieuwe afbeeldingen te vinden. \ No newline at end of file diff --git a/nl-NL/step_7.md b/nl-NL/step_7.md new file mode 100644 index 00000000..ebe87969 --- /dev/null +++ b/nl-NL/step_7.md @@ -0,0 +1,20 @@ +## Video opnemen met Python-code + +Neem nu een video op! + +- Wijzig je code om `capture()` te verwijderen en voeg in plaats daarvan `start_recording()` en `stop_recording()` toe + + Je code zou er als volgt uit moeten zien: + + ```python + camera.start_preview() + camera.start_recording('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_recording() + camera.stop_preview() + ``` + +- Voer de code uit. + +De Raspberry Pi zou een voorbeeld moeten openen, 5 seconden video moeten opnemen en vervolgens het voorbeeld moeten sluiten. + diff --git a/nl-NL/step_8.md b/nl-NL/step_8.md new file mode 100644 index 00000000..880ffb95 --- /dev/null +++ b/nl-NL/step_8.md @@ -0,0 +1,228 @@ +## Hoe je de beeldinstellingen kunt wijzigen en beeldeffecten kunt toevoegen + +De Python `picamera` software biedt een aantal effecten en configuraties om te veranderen hoe je afbeeldingen eruit zien. + +**Opmerking:** sommige instellingen hebben alleen invloed op het voorbeeld en niet op de gemaakte afbeelding, sommige hebben alleen invloed op de gemaakte afbeelding en veel andere op beide. + +### Stel de beeldresolutie in + +Je kunt de `resolutie` van de afbeelding die de cameramodule maakt wijzigen. + +Standaard is de beeldresolutie ingesteld op de resolutie van je monitor. De maximale resolutie is 2592×1944 voor foto's en 1920×1080 voor video-opnamen. + +- Gebruik de volgende code om de `resolutie` op maximum in te stellen en een foto te maken. + + **Opmerking:** je moet ook de framesnelheid instellen op `15` om deze maximale resolutie in te schakelen. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +De minimale resolutie is 64×64. + +- Probeer een foto te maken met de minimale resolutie. + +### Voeg tekst toe aan je afbeelding + +Je kunt tekst aan je afbeelding toevoegen met de opdracht `annotate_text`. + +- Voer deze code uit om het uit te proberen: + + ```python + camera.start_preview() + camera.annotate_text = "Hallo wereld!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Wijzig het uiterlijk van de toegevoegde tekst + +- Stel de tekstgrootte in met de volgende code: + + ```python + camera.annotate_text_size = 50 + ``` + + Je kunt de tekstgrootte instellen op alles tussen `6` en `160`. De standaardgrootte is `32`. + +Het is ook mogelijk om de tekstkleur te wijzigen. + +- Voeg eerst `Color` toe aan de `import` regel bovenaan het programma: + + ```python + from picamera import PiCamera, Color + ``` + +- Wijzig vervolgens onder de regel `import` de rest van je code zodat het er zo uitziet: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hallo wereld " + sleep(5) + camera.stop_preview() + ``` + +### Wijzig de helderheid van het voorbeeld + +Je kunt wijzigen hoe helder het voorbeeld wordt weergegeven. De standaard helderheid is `50`, en je kunt deze instellen op elke waarde tussen `0` en `100`. + +* Voer de volgende code uit om dit uit te proberen: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- De volgende lus past de helderheid aan en voegt ook tekst toe om het huidige helderheidsniveau weer te geven: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Helderheid: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Wijzig het contrast van het voorbeeld + +Net als de helderheid van het voorbeeld kun je het contrast van het voorbeeld wijzigen. + +- Voer de volgende code uit om dit uit te proberen: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Voeg coole beeldeffecten toe + +Je kunt `camera.image_effect` gebruiken om een bepaald beeldeffect toe te passen. + +De opties voor beeldeffecten zijn: + +* `none (geen)` +* `negative (negatief)` +* `solarize (overbelichten)` +* `sketch (schets)` +* `denoise (kleurruis verwijderen)` +* `emboss (reliëf)` +* `oilpaint (olieverf)` +* `hatch (arcering)` +* `gpen (potlood)` +* `pastel` +* `watercolor (waterverf)` +* `film` +* `blur (vervagen)` +* `saturation (verzadiging)` +* `colorswap (kleurwisseling)` +* `washedout (uitgewassen)` +* `posterise (posterstijl)` +* `colorpoint (kleurpunt)` +* `colorbalance (kleurbalans)` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +Het standaardeffect is `none`. + +* Kies een beeldeffect en probeer het uit: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Voer deze code uit om **alle** beeldeffecten uit `camera.IMAGE_EFFECTS` te herhalen: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effecten](images/effects.jpg) + +### Stel de belichtingsmodus in + +Je kunt `camera.exposure_mode` gebruiken om de belichting in te stellen op een bepaalde modus. + +De opties voor de belichtingsmodus zijn: +* `off (uit)` +* `auto` +* `night (nacht)` +* `nightpreview (nachtvoorbeeld)` +* `backlight (achtergrondverlichting)` +* `spotlight (schijnwerper)` +* `sports (sporten)` +* `snow (sneeuw)` +* `beach (strand)` +* `verylong (heel lang)` +* `fixedfps (vaste fps)` +* `antishake (beeldstabilisatie)` +* `fireworks (vuurwerk)` + +De standaardmodus is `auto`. + +* Kies een belichtingsmodus en probeer het uit: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* Je kunt alle belichtingsmodi doorlopen met `camera.EXPOSURE_MODES`, zoals je deed voor de beeldeffecten. + +### Wijzig de witbalans van de afbeelding + +Je kunt `camera.awb_mode` gebruiken om de automatische witbalans in te stellen op een vooraf ingestelde modus. + +De beschikbare automatische witbalans-modi zijn: +* `off (uit)` +* `auto` +* `sunlight (zonlicht)` +* `cloudy (bewolkt)` +* `shade (schaduw)` +* `tungsten (wolfraam)` +* `fluorescent (fluorescerend)` +* `incandescent (gloeilamp)` +* `flash (flitser)` +* `horizon` + +De standaard is `auto`. + +* Kies een automatische witbalans en probeer het uit: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* Je kunt met `camera.AWB_MODES` alle automatische witbalansmodi doorlopen, net zoals bij de beeldeffecten. \ No newline at end of file diff --git a/nl-NL/step_9.md b/nl-NL/step_9.md new file mode 100644 index 00000000..e4d5dab7 --- /dev/null +++ b/nl-NL/step_9.md @@ -0,0 +1,17 @@ +## Wat kun je verder nog doen? + +Nu je weet hoe je de cameramodule moet gebruiken, kun je bijvoorbeeld: +* Voeg knoppen toe om de camera te bedienen met behulp van de [GPIO Zero](https://gpiozero.readthedocs.org/) Python-code +* Integreer de camera met Minecraft Pi +* Plaats de foto's van de camera automatisch op Twitter + +Probeer deze cameramodule-projecten voor meer informatie: + +- Maak een [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Maak een [Minecraft fotohokje](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Haal [Babbage beer om afbeeldingen te tweeten](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Bouw een [ouderdetector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Gebruik de NoIR-cameramodule om een [infrarood vogelhuisje](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) te maken + +Zie de uitgebreide [picamera documentatie](https://picamera.readthedocs.org/) voor meer informatie over het schrijven van Python-code om de cameramodule te besturen. + diff --git a/no-NO/images/Getting_Started_With_Picamera_TILE.png b/no-NO/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/no-NO/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/no-NO/images/banner.png b/no-NO/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/no-NO/images/banner.png differ diff --git a/no-NO/images/blur.jpg b/no-NO/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/no-NO/images/blur.jpg differ diff --git a/no-NO/images/camera-module.png b/no-NO/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/no-NO/images/camera-module.png differ diff --git a/no-NO/images/cartoon.jpg b/no-NO/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/no-NO/images/cartoon.jpg differ diff --git a/no-NO/images/colorbalance.jpg b/no-NO/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/no-NO/images/colorbalance.jpg differ diff --git a/no-NO/images/colorpoint.jpg b/no-NO/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/no-NO/images/colorpoint.jpg differ diff --git a/no-NO/images/colorswap.jpg b/no-NO/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/no-NO/images/colorswap.jpg differ diff --git a/no-NO/images/connect-camera-old.gif b/no-NO/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/no-NO/images/connect-camera-old.gif differ diff --git a/no-NO/images/connect-camera.gif b/no-NO/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/no-NO/images/connect-camera.gif differ diff --git a/no-NO/images/connect-camera.gif.gif b/no-NO/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/no-NO/images/connect-camera.gif.gif differ diff --git a/no-NO/images/connect-camera1.png b/no-NO/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/no-NO/images/connect-camera1.png differ diff --git a/no-NO/images/connect-camera2.png b/no-NO/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/no-NO/images/connect-camera2.png differ diff --git a/no-NO/images/connect-camera3.png b/no-NO/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/no-NO/images/connect-camera3.png differ diff --git a/no-NO/images/connect-camera4.png b/no-NO/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/no-NO/images/connect-camera4.png differ diff --git a/no-NO/images/connect-camera5.png b/no-NO/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/no-NO/images/connect-camera5.png differ diff --git a/no-NO/images/deinterlace1.jpg b/no-NO/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/no-NO/images/deinterlace1.jpg differ diff --git a/no-NO/images/deinterlace2.jpg b/no-NO/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/no-NO/images/deinterlace2.jpg differ diff --git a/no-NO/images/denoise.jpg b/no-NO/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/no-NO/images/denoise.jpg differ diff --git a/no-NO/images/desktop-annotated.png b/no-NO/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/no-NO/images/desktop-annotated.png differ diff --git a/no-NO/images/desktop.png b/no-NO/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/no-NO/images/desktop.png differ diff --git a/no-NO/images/effects.jpg b/no-NO/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/no-NO/images/effects.jpg differ diff --git a/no-NO/images/emboss.jpg b/no-NO/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/no-NO/images/emboss.jpg differ diff --git a/no-NO/images/film.jpg b/no-NO/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/no-NO/images/film.jpg differ diff --git a/no-NO/images/gpen.jpg b/no-NO/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/no-NO/images/gpen.jpg differ diff --git a/no-NO/images/hatch.jpg b/no-NO/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/no-NO/images/hatch.jpg differ diff --git a/no-NO/images/negative.jpg b/no-NO/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/no-NO/images/negative.jpg differ diff --git a/no-NO/images/none.jpg b/no-NO/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/no-NO/images/none.jpg differ diff --git a/no-NO/images/oilpaint.jpg b/no-NO/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/no-NO/images/oilpaint.jpg differ diff --git a/no-NO/images/open-terminal-annotated.png b/no-NO/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/no-NO/images/open-terminal-annotated.png differ diff --git a/no-NO/images/open-terminal.png b/no-NO/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/no-NO/images/open-terminal.png differ diff --git a/no-NO/images/pastel.jpg b/no-NO/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/no-NO/images/pastel.jpg differ diff --git a/no-NO/images/pi-camera-attached.jpg b/no-NO/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/no-NO/images/pi-camera-attached.jpg differ diff --git a/no-NO/images/pi-configuration-interfaces-annotated.png b/no-NO/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/no-NO/images/pi-configuration-interfaces-annotated.png differ diff --git a/no-NO/images/pi-configuration-interfaces.png b/no-NO/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/no-NO/images/pi-configuration-interfaces.png differ diff --git a/no-NO/images/pi-configuration-menu.png b/no-NO/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/no-NO/images/pi-configuration-menu.png differ diff --git a/no-NO/images/pi4-camera-port.png b/no-NO/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/no-NO/images/pi4-camera-port.png differ diff --git a/no-NO/images/posterise.jpg b/no-NO/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/no-NO/images/posterise.jpg differ diff --git a/no-NO/images/preview.jpg b/no-NO/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/no-NO/images/preview.jpg differ diff --git a/no-NO/images/raspberry-pi.png b/no-NO/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/no-NO/images/raspberry-pi.png differ diff --git a/no-NO/images/raspistill-help.png b/no-NO/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/no-NO/images/raspistill-help.png differ diff --git a/no-NO/images/raspistill-image.png b/no-NO/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/no-NO/images/raspistill-image.png differ diff --git a/no-NO/images/saturation.jpg b/no-NO/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/no-NO/images/saturation.jpg differ diff --git a/no-NO/images/sketch.jpg b/no-NO/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/no-NO/images/sketch.jpg differ diff --git a/no-NO/images/solarize.jpg b/no-NO/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/no-NO/images/solarize.jpg differ diff --git a/no-NO/images/thonny-app-menu.png b/no-NO/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/no-NO/images/thonny-app-menu.png differ diff --git a/no-NO/images/washedout.jpg b/no-NO/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/no-NO/images/washedout.jpg differ diff --git a/no-NO/images/watercolor.jpg b/no-NO/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/no-NO/images/watercolor.jpg differ diff --git a/no-NO/meta.yml b/no-NO/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/no-NO/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/no-NO/step_1.md b/no-NO/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/no-NO/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/no-NO/step_2.md b/no-NO/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/no-NO/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/no-NO/step_3.md b/no-NO/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/no-NO/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/no-NO/step_4.md b/no-NO/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/no-NO/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 Enter 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/no-NO/step_5.md b/no-NO/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/no-NO/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`. \ No newline at end of file diff --git a/no-NO/step_6.md b/no-NO/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/no-NO/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. \ No newline at end of file diff --git a/no-NO/step_7.md b/no-NO/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/no-NO/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. + diff --git a/no-NO/step_8.md b/no-NO/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/no-NO/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/no-NO/step_9.md b/no-NO/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/no-NO/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/pl-PL/images/Getting_Started_With_Picamera_TILE.png b/pl-PL/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/pl-PL/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/pl-PL/images/banner.png b/pl-PL/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/pl-PL/images/banner.png differ diff --git a/pl-PL/images/blur.jpg b/pl-PL/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/pl-PL/images/blur.jpg differ diff --git a/pl-PL/images/camera-module.png b/pl-PL/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/pl-PL/images/camera-module.png differ diff --git a/pl-PL/images/cartoon.jpg b/pl-PL/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/pl-PL/images/cartoon.jpg differ diff --git a/pl-PL/images/colorbalance.jpg b/pl-PL/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/pl-PL/images/colorbalance.jpg differ diff --git a/pl-PL/images/colorpoint.jpg b/pl-PL/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/pl-PL/images/colorpoint.jpg differ diff --git a/pl-PL/images/colorswap.jpg b/pl-PL/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/pl-PL/images/colorswap.jpg differ diff --git a/pl-PL/images/connect-camera-old.gif b/pl-PL/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/pl-PL/images/connect-camera-old.gif differ diff --git a/pl-PL/images/connect-camera.gif b/pl-PL/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/pl-PL/images/connect-camera.gif differ diff --git a/pl-PL/images/connect-camera.gif.gif b/pl-PL/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/pl-PL/images/connect-camera.gif.gif differ diff --git a/pl-PL/images/connect-camera1.png b/pl-PL/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/pl-PL/images/connect-camera1.png differ diff --git a/pl-PL/images/connect-camera2.png b/pl-PL/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/pl-PL/images/connect-camera2.png differ diff --git a/pl-PL/images/connect-camera3.png b/pl-PL/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/pl-PL/images/connect-camera3.png differ diff --git a/pl-PL/images/connect-camera4.png b/pl-PL/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/pl-PL/images/connect-camera4.png differ diff --git a/pl-PL/images/connect-camera5.png b/pl-PL/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/pl-PL/images/connect-camera5.png differ diff --git a/pl-PL/images/deinterlace1.jpg b/pl-PL/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/pl-PL/images/deinterlace1.jpg differ diff --git a/pl-PL/images/deinterlace2.jpg b/pl-PL/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/pl-PL/images/deinterlace2.jpg differ diff --git a/pl-PL/images/denoise.jpg b/pl-PL/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/pl-PL/images/denoise.jpg differ diff --git a/pl-PL/images/desktop-annotated.png b/pl-PL/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/pl-PL/images/desktop-annotated.png differ diff --git a/pl-PL/images/desktop.png b/pl-PL/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/pl-PL/images/desktop.png differ diff --git a/pl-PL/images/effects.jpg b/pl-PL/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/pl-PL/images/effects.jpg differ diff --git a/pl-PL/images/emboss.jpg b/pl-PL/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/pl-PL/images/emboss.jpg differ diff --git a/pl-PL/images/film.jpg b/pl-PL/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/pl-PL/images/film.jpg differ diff --git a/pl-PL/images/gpen.jpg b/pl-PL/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/pl-PL/images/gpen.jpg differ diff --git a/pl-PL/images/hatch.jpg b/pl-PL/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/pl-PL/images/hatch.jpg differ diff --git a/pl-PL/images/negative.jpg b/pl-PL/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/pl-PL/images/negative.jpg differ diff --git a/pl-PL/images/none.jpg b/pl-PL/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/pl-PL/images/none.jpg differ diff --git a/pl-PL/images/oilpaint.jpg b/pl-PL/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/pl-PL/images/oilpaint.jpg differ diff --git a/pl-PL/images/open-terminal-annotated.png b/pl-PL/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/pl-PL/images/open-terminal-annotated.png differ diff --git a/pl-PL/images/open-terminal.png b/pl-PL/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/pl-PL/images/open-terminal.png differ diff --git a/pl-PL/images/pastel.jpg b/pl-PL/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/pl-PL/images/pastel.jpg differ diff --git a/pl-PL/images/pi-camera-attached.jpg b/pl-PL/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/pl-PL/images/pi-camera-attached.jpg differ diff --git a/pl-PL/images/pi-configuration-interfaces-annotated.png b/pl-PL/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/pl-PL/images/pi-configuration-interfaces-annotated.png differ diff --git a/pl-PL/images/pi-configuration-interfaces.png b/pl-PL/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/pl-PL/images/pi-configuration-interfaces.png differ diff --git a/pl-PL/images/pi-configuration-menu.png b/pl-PL/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/pl-PL/images/pi-configuration-menu.png differ diff --git a/pl-PL/images/pi4-camera-port.png b/pl-PL/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/pl-PL/images/pi4-camera-port.png differ diff --git a/pl-PL/images/posterise.jpg b/pl-PL/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/pl-PL/images/posterise.jpg differ diff --git a/pl-PL/images/preview.jpg b/pl-PL/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/pl-PL/images/preview.jpg differ diff --git a/pl-PL/images/raspberry-pi.png b/pl-PL/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/pl-PL/images/raspberry-pi.png differ diff --git a/pl-PL/images/raspistill-help.png b/pl-PL/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/pl-PL/images/raspistill-help.png differ diff --git a/pl-PL/images/raspistill-image.png b/pl-PL/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/pl-PL/images/raspistill-image.png differ diff --git a/pl-PL/images/saturation.jpg b/pl-PL/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/pl-PL/images/saturation.jpg differ diff --git a/pl-PL/images/sketch.jpg b/pl-PL/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/pl-PL/images/sketch.jpg differ diff --git a/pl-PL/images/solarize.jpg b/pl-PL/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/pl-PL/images/solarize.jpg differ diff --git a/pl-PL/images/thonny-app-menu.png b/pl-PL/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/pl-PL/images/thonny-app-menu.png differ diff --git a/pl-PL/images/washedout.jpg b/pl-PL/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/pl-PL/images/washedout.jpg differ diff --git a/pl-PL/images/watercolor.jpg b/pl-PL/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/pl-PL/images/watercolor.jpg differ diff --git a/pl-PL/meta.yml b/pl-PL/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/pl-PL/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/pl-PL/step_1.md b/pl-PL/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/pl-PL/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/pl-PL/step_2.md b/pl-PL/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/pl-PL/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/pl-PL/step_3.md b/pl-PL/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/pl-PL/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/pl-PL/step_4.md b/pl-PL/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/pl-PL/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 Enter 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/pl-PL/step_5.md b/pl-PL/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/pl-PL/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`. \ No newline at end of file diff --git a/pl-PL/step_6.md b/pl-PL/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/pl-PL/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. \ No newline at end of file diff --git a/pl-PL/step_7.md b/pl-PL/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/pl-PL/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. + diff --git a/pl-PL/step_8.md b/pl-PL/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/pl-PL/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/pl-PL/step_9.md b/pl-PL/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/pl-PL/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/pt-BR/images/Getting_Started_With_Picamera_TILE.png b/pt-BR/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/pt-BR/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/pt-BR/images/banner.png b/pt-BR/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/pt-BR/images/banner.png differ diff --git a/pt-BR/images/blur.jpg b/pt-BR/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/pt-BR/images/blur.jpg differ diff --git a/pt-BR/images/camera-module.png b/pt-BR/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/pt-BR/images/camera-module.png differ diff --git a/pt-BR/images/cartoon.jpg b/pt-BR/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/pt-BR/images/cartoon.jpg differ diff --git a/pt-BR/images/colorbalance.jpg b/pt-BR/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/pt-BR/images/colorbalance.jpg differ diff --git a/pt-BR/images/colorpoint.jpg b/pt-BR/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/pt-BR/images/colorpoint.jpg differ diff --git a/pt-BR/images/colorswap.jpg b/pt-BR/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/pt-BR/images/colorswap.jpg differ diff --git a/pt-BR/images/connect-camera-old.gif b/pt-BR/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/pt-BR/images/connect-camera-old.gif differ diff --git a/pt-BR/images/connect-camera.gif b/pt-BR/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/pt-BR/images/connect-camera.gif differ diff --git a/pt-BR/images/connect-camera.gif.gif b/pt-BR/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/pt-BR/images/connect-camera.gif.gif differ diff --git a/pt-BR/images/connect-camera1.png b/pt-BR/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/pt-BR/images/connect-camera1.png differ diff --git a/pt-BR/images/connect-camera2.png b/pt-BR/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/pt-BR/images/connect-camera2.png differ diff --git a/pt-BR/images/connect-camera3.png b/pt-BR/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/pt-BR/images/connect-camera3.png differ diff --git a/pt-BR/images/connect-camera4.png b/pt-BR/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/pt-BR/images/connect-camera4.png differ diff --git a/pt-BR/images/connect-camera5.png b/pt-BR/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/pt-BR/images/connect-camera5.png differ diff --git a/pt-BR/images/deinterlace1.jpg b/pt-BR/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/pt-BR/images/deinterlace1.jpg differ diff --git a/pt-BR/images/deinterlace2.jpg b/pt-BR/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/pt-BR/images/deinterlace2.jpg differ diff --git a/pt-BR/images/denoise.jpg b/pt-BR/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/pt-BR/images/denoise.jpg differ diff --git a/pt-BR/images/desktop-annotated.png b/pt-BR/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/pt-BR/images/desktop-annotated.png differ diff --git a/pt-BR/images/desktop.png b/pt-BR/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/pt-BR/images/desktop.png differ diff --git a/pt-BR/images/effects.jpg b/pt-BR/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/pt-BR/images/effects.jpg differ diff --git a/pt-BR/images/emboss.jpg b/pt-BR/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/pt-BR/images/emboss.jpg differ diff --git a/pt-BR/images/film.jpg b/pt-BR/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/pt-BR/images/film.jpg differ diff --git a/pt-BR/images/gpen.jpg b/pt-BR/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/pt-BR/images/gpen.jpg differ diff --git a/pt-BR/images/hatch.jpg b/pt-BR/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/pt-BR/images/hatch.jpg differ diff --git a/pt-BR/images/negative.jpg b/pt-BR/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/pt-BR/images/negative.jpg differ diff --git a/pt-BR/images/none.jpg b/pt-BR/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/pt-BR/images/none.jpg differ diff --git a/pt-BR/images/oilpaint.jpg b/pt-BR/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/pt-BR/images/oilpaint.jpg differ diff --git a/pt-BR/images/open-terminal-annotated.png b/pt-BR/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/pt-BR/images/open-terminal-annotated.png differ diff --git a/pt-BR/images/open-terminal.png b/pt-BR/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/pt-BR/images/open-terminal.png differ diff --git a/pt-BR/images/pastel.jpg b/pt-BR/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/pt-BR/images/pastel.jpg differ diff --git a/pt-BR/images/pi-camera-attached.jpg b/pt-BR/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/pt-BR/images/pi-camera-attached.jpg differ diff --git a/pt-BR/images/pi-configuration-interfaces-annotated.png b/pt-BR/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/pt-BR/images/pi-configuration-interfaces-annotated.png differ diff --git a/pt-BR/images/pi-configuration-interfaces.png b/pt-BR/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/pt-BR/images/pi-configuration-interfaces.png differ diff --git a/pt-BR/images/pi-configuration-menu.png b/pt-BR/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/pt-BR/images/pi-configuration-menu.png differ diff --git a/pt-BR/images/pi4-camera-port.png b/pt-BR/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/pt-BR/images/pi4-camera-port.png differ diff --git a/pt-BR/images/posterise.jpg b/pt-BR/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/pt-BR/images/posterise.jpg differ diff --git a/pt-BR/images/preview.jpg b/pt-BR/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/pt-BR/images/preview.jpg differ diff --git a/pt-BR/images/raspberry-pi.png b/pt-BR/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/pt-BR/images/raspberry-pi.png differ diff --git a/pt-BR/images/raspistill-help.png b/pt-BR/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/pt-BR/images/raspistill-help.png differ diff --git a/pt-BR/images/raspistill-image.png b/pt-BR/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/pt-BR/images/raspistill-image.png differ diff --git a/pt-BR/images/saturation.jpg b/pt-BR/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/pt-BR/images/saturation.jpg differ diff --git a/pt-BR/images/sketch.jpg b/pt-BR/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/pt-BR/images/sketch.jpg differ diff --git a/pt-BR/images/solarize.jpg b/pt-BR/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/pt-BR/images/solarize.jpg differ diff --git a/pt-BR/images/thonny-app-menu.png b/pt-BR/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/pt-BR/images/thonny-app-menu.png differ diff --git a/pt-BR/images/washedout.jpg b/pt-BR/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/pt-BR/images/washedout.jpg differ diff --git a/pt-BR/images/watercolor.jpg b/pt-BR/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/pt-BR/images/watercolor.jpg differ diff --git a/pt-BR/meta.yml b/pt-BR/meta.yml new file mode 100644 index 00000000..35f19d3e --- /dev/null +++ b/pt-BR/meta.yml @@ -0,0 +1,31 @@ +--- +title: Introdução ao Módulo de Câmera +hero_image: images/banner.png +description: Tire fotos e vídeos com o Módulo de Câmera Raspberry Pi e Python +listed: true +copyedit: true +version: 4 +last_tested: 2018-05-13 +steps: + - + title: Introdução + - + title: O que você vai precisar + - + title: Conectar o Módulo de Câmera + - + title: Como controlar o Módulo de Câmera através da linha de comando + completion: + - engaged + - + title: Como controlar o Módulo de Câmera com código Python + - + title: Tirar fotos com o código Python + - + title: Gravar vídeo com código Python + - + title: Como alterar as configurações da imagem e adicionar efeitos de imagem + completion: + - internal + - + title: E agora? diff --git a/pt-BR/step_1.md b/pt-BR/step_1.md new file mode 100644 index 00000000..4d9c2df8 --- /dev/null +++ b/pt-BR/step_1.md @@ -0,0 +1,9 @@ +## Introdução + +[[[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/pt-BR/step_2.md b/pt-BR/step_2.md new file mode 100644 index 00000000..a088347d --- /dev/null +++ b/pt-BR/step_2.md @@ -0,0 +1,20 @@ +## O que você vai precisar + +### Computador Raspberry Pi com uma porta Módulo de Câmera + +Todos os modelos atuais do Raspberry Pi possuem uma porta para conectar o Módulo de Câmera. + +![Raspberry Pi 3B+ com o Módulo de Câmera rotulado](images/pi4-camera-port.png) + +**Nota:** Se você deseja usar um Raspberry Pi Zero, você precisa de um cabo flat para Módulo de Câmera que se encaixe na porta menor do Módulo de Câmera do Raspberry Pi Zero. + +### Módulo de Câmera Raspberry Pi + +![Módulo de Câmera Raspberry Pi](images/camera-module.png) + +Existem duas versões do Módulo de Câmera: + +* [A versão padrão](https://www.raspberrypi.org/products/camera-module-v2/), que é projetada para tirar fotos em iluminação natural +* [A versão NoIR](https://www.raspberrypi.org/products/pi-noir-camera-v2/), que não possui um filtro infravermelho, de modo que você possa usá-la junto com uma fonte de luz infravermelha para tirar fotos no escuro + + diff --git a/pt-BR/step_3.md b/pt-BR/step_3.md new file mode 100644 index 00000000..4f41423d --- /dev/null +++ b/pt-BR/step_3.md @@ -0,0 +1,48 @@ +## Conectar o Módulo de Câmera + +**Certifique-se de que o Raspberry Pi esteja desligado.** + +--- no-print --- + +1. Localize a porta do Módulo de Câmera +2. Levante suavemente as bordas do clipe plástico da porta +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. Empurre o clipe plástico de volta ao lugar + +![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. Localize a porta do Módulo de Câmara. + +![Raspberry Pi 4 and camera module](images/connect-camera1.png) + +2. Levante suavemente as bordas do clipe plástico da porta. + +![porta do módulo da câmera levantada](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. + +![cabo flat do módulo da câmera inserido na porta](images/connect-camera3.png) + +4. Empurre o clipe plástico de volta ao lugar. + +![camera module port pushed down](images/connect-camera4.png) + +![camera module port pushed down](images/connect-camera4.png) + +--- /print-only --- + +- Inicie o seu Raspberry Pi. + +- Vá para o menu principal e abra a ferramenta **Configuração do Raspberry Pi**. + + ![Raspberry Pi Configuration Tool inside of the Preferences menu](images/pi-configuration-menu.png) + +- Selecione a guia **Interfaces** e certifique-se de que a câmera esteja **habilitada**: + + ![Raspberry Pi Configuration Tool with the Interfaces menu opened and Camera enabled](images/pi-configuration-interfaces-annotated.png) + +- Reinicie o seu Raspberry Pi. diff --git a/pt-BR/step_4.md b/pt-BR/step_4.md new file mode 100644 index 00000000..72826c5e --- /dev/null +++ b/pt-BR/step_4.md @@ -0,0 +1,41 @@ +## Como controlar o Módulo de Câmera através da linha de comando + +Agora que seu Módulo de Câmera está conectado e o software está ativado, experimente as ferramentas de linha de comando `raspistill` e `raspivid`. + +- Abra uma janela de terminal clicando no ícone do monitor preto na barra de tarefas: + +![Terminal aberto](images/open-terminal-annotated.png) + +- Digite o seguinte comando para tirar uma foto e salvá-la na área de trabalho: + +```bash +raspistill -o Desktop/image.jpg +``` + +![comando raspistill inserido no terminal](images/raspistill-image.png) + +- Pressione Enter para executar o comando. + +Quando o comando é executado, você pode ver a pré-visualização da câmera abrir por cinco segundos antes de uma foto ser tirada. + +- Procure o ícone do arquivo de imagem na área de trabalho e clique duas vezes no ícone do arquivo para abrir a imagem. + + ![Imagem na Área de Trabalho](images/desktop-annotated.png) + +Ao adicionar diferentes opções, você pode definir o tamanho e a aparência da imagem que o comando `raspistill` gera. + +- Por exemplo, adicione `-h` e `-w` para alterar a altura e largura da imagem: + +```bash +raspistill -o Desktop/image-small.jpg -w 640 -h 480 +``` + +- Agora grave um vídeo com o Módulo de Câmera usando o seguinte comando `raspivid`: + +```bash +raspivid -o Desktop/video.h264 +``` + +- Para reproduzir o arquivo de vídeo, clique duas vezes no ícone do arquivo `video.h264` na área de trabalho para abri-lo no VLC Media Player. + +Para mais informações e outras opções que você pode usar com esses comandos, leia a [documentação para raspistill](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspistill.md) e a [documentação para raspivid](https://www.raspberrypi.org/documentation/usage/camera/raspicam/raspivid.md). diff --git a/pt-BR/step_5.md b/pt-BR/step_5.md new file mode 100644 index 00000000..ac49988e --- /dev/null +++ b/pt-BR/step_5.md @@ -0,0 +1,49 @@ +## Como controlar o Módulo de Câmera com código Python + +A biblioteca Python `picamera` permite que você controle seu Módulo de Câmera e crie projetos incríveis. + +- Abra um editor Python 3, como **Thonny Python IDE**: + + ![Abrir Thonny](images/thonny-app-menu.png) + +- Abra um novo arquivo e salve-o como `camera.py`. + + **Nota:** é importante que você **nunca salve o arquivo como `picamera.py`**. + +- Insira o seguinte código: + + ```python + from picamera import PiCamera + from time import sleep + + camera = PiCamera () + + camera.start_preview () + sleep (5) + camera.stop_preview () + ``` + +- Salve e execute seu programa. A pré-visualização da câmera deve ser mostrada por cinco segundos e, em seguida, fechada novamente. + + ![Pré-visualização da imagem](images/preview.jpg) + + **Nota:** a pré-visualização da câmera só funciona quando um monitor está conectado ao seu Raspberry Pi. Se estiver usando acesso remoto (como SSH ou VNC), você não verá a pré-visualização da câmera. + +- Se sua pré-visualização estiver de cabeça para baixo, você pode girá-la 180 graus com o seguinte código: + + ```python + camera = PiCamera() + camera.rotation = 180 + ``` + + Você pode girar a imagem em `90`, `180`, ou `270` graus. Para redefinir a imagem, defina `rotation` como `0` graus. + +É melhor deixar a pré-visualização um pouco transparente para que você possa ver se ocorrem erros no seu programa enquanto a visualização estiver ativa. + +- Torne a pré-visualização da câmera transparente definindo um nível `alfa`: + + ```python + camera.start_preview(alpha=200) + ``` + + O valor `alpha` pode ser qualquer número entre `0` e `255`. \ No newline at end of file diff --git a/pt-BR/step_6.md b/pt-BR/step_6.md new file mode 100644 index 00000000..f8b15344 --- /dev/null +++ b/pt-BR/step_6.md @@ -0,0 +1,38 @@ +## Tirar fotos com o código Python + +Agora use o Módulo de Câmera e o Python para tirar algumas fotos. + +- Altere seu código para adicionar uma linha de `camera.capture()`: + + ```python + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/image.jpg') + camera.stop_preview() + ``` + + **Nota:** é importante definir `sleep` por pelo menos dois segundos antes de capturar uma imagem, porque isso dá ao sensor da câmera o tempo necessário para detectar os níveis de luz. + +- Execute o código. + +Você deve ver a pré-visualização da câmera aberta por cinco segundos e, em seguida, uma imagem estática deve ser capturada. Conforme a foto é tirada, você pode ver a pré-visualização brevemente se ajustando a uma resolução diferente. + +Sua nova imagem será salva na Área de Trabalho. + +- Agora adicione um ciclo para tirar cinco fotos consecutivas: + + ```python + camera.start_preview() + for i in range(5): + sleep(5) + camera.capture('/home/pi/Desktop/image%s.jpg' % i) + camera.stop_preview() + ``` + + A variável `i` conta quantas vezes o ciclo foi executado, de `0` até `4`. Assim, as imagens são salvas como `image0.jpg`, `image1.jpg`, e assim por diante. + +- Execute o código novamente e segure o Módulo de Câmera na posição. + +A câmera irá tirar uma foto a cada cinco segundos. Assim que a quinta foto é tirada, a pré-visualização se encerra. + +- Acesse a sua Área de Trabalho para encontrar as cinco fotos novas. \ No newline at end of file diff --git a/pt-BR/step_7.md b/pt-BR/step_7.md new file mode 100644 index 00000000..02207915 --- /dev/null +++ b/pt-BR/step_7.md @@ -0,0 +1,20 @@ +## Gravando vídeo com código Python + +Agora grave um vídeo! + +- Ajuste seu código para remover `capture()` e, em vez disso, adicione `start_recording()` e `stop_recording()` + + Seu código deve ficar assim: + + ```python + camera.start_preview() + camera.start_graving('/home/pi/Desktop/video.h264') + sleep(5) + camera.stop_graving() + camera.stop_preview() + ``` + +- Execute o código. + +Seu Raspberry Pi deve abrir uma pré-visualização, gravar 5 segundos de vídeo e, em seguida, fechar a prévia. + diff --git a/pt-BR/step_8.md b/pt-BR/step_8.md new file mode 100644 index 00000000..44f24789 --- /dev/null +++ b/pt-BR/step_8.md @@ -0,0 +1,228 @@ +## Como alterar as configurações da imagem e adicionar efeitos de imagem + +O software Python `picamera` disponibiliza uma série de efeitos e configurações para alterar o visual de suas imagens. + +**Nota:** algumas configurações afetam apenas a pré-visualização e não a imagem capturada, algumas afetam apenas a imagem capturada e muitas outras afetam ambos. + +### Defina a resolução da imagem + +Você pode alterar a `resolução` da imagem que o Módulo de Câmera produz. + +Por padrão, a resolução da imagem é definida para a resolução do seu monitor. A resolução máxima é de 2592×1944 para fotos, e de 1920×1080 para gravação de vídeo. + +- Use o código a seguir para definir a `resolution` ao máximo e tire uma foto. + + **Nota:** você também precisa definir a taxa de quadros para `15` para habilitar esta resolução máxima. + + ```python + camera.resolução = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +A resolução mínima é de 64×64. + +- Tente tirar uma foto com a resolução mínima. + +### Adicione texto à sua imagem + +Você pode adicionar texto à sua imagem usando o comando `annotate_text`. + +- Execute este código para testar isso: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Altere a aparência do texto adicionado + +- Defina o tamanho do texto com o seguinte código: + + ```python + camera.annotate_text_size = 50 + ``` + + Você pode definir o tamanho do texto para qualquer valor entre `6` e `160`. O tamanho padrão é `32`. + +Também é possível alterar a cor do texto. + +- Antes de tudo, adicione `Color` à sua linha `import` na parte superior do programa: + + ```python + from picamera import PiCamera, Color + ``` + +- Então abaixo da linha de `import`, altere o resto do seu código para que fique assim: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Altere o brilho da pré-visualização + +Você pode mudar o brilho da pré-visualização. O brilho padrão é `50`, e você pode defini-lo para qualquer valor entre `0` e `100`. + +* Execute o seguinte código para experimentar isso: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- O ciclo a seguir ajusta o brilho e também adiciona texto para exibir o nível atual de brilho: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Alterar o contraste da pré-visualização + +Da mesma forma que o brilho da pré-visualização, você pode mudar o contraste da pré-visualização. + +- Execute o seguinte código para experimentar isso: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Adicione efeitos de imagem legais + +Você pode usar `camera.image_effect` para aplicar um efeito de imagem específico. + +As opções de efeito de imagem são: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +O efeito padrão é `none`. + +* Escolha um efeito de imagem e experimente: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Execute este código para experimentar **todos** os efeitos de imagem com `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Efeitos](images/effects.jpg) + +### Definir o modo de exposição de imagem + +Você pode usar `camera.exposure_mode` para definir a exposição para um modo específico. + +As opções do modo de exposição são: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +O modo padrão é `auto`. + +* Escolha um modo de exposição e experimente: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* Você pode repetir todos os modos de exposição com `câmera.EXPOSURE_MODES`, assim como foi feito com os efeitos de imagem. + +### Alterar o balanço de branco da imagem + +Você pode usar `camera.awb_mode` para definir o balanço de branco automático para um modo predefinido. + +Os modos de balanço de branco automático disponíveis são: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +O padrão é `auto`. + +* Escolha um modo de balanço de branco automático e experimente: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* Você pode repetir todos os modos de balanço de branco automático com `câmera.AWB_MODES`, assim como foi feito com os efeitos de imagem. \ No newline at end of file diff --git a/pt-BR/step_9.md b/pt-BR/step_9.md new file mode 100644 index 00000000..1cc90201 --- /dev/null +++ b/pt-BR/step_9.md @@ -0,0 +1,17 @@ +## E agora? + +Agora que você sabe como usar seu Módulo de Câmera, você pode, por exemplo: +* Adicionar botões para controlar a câmera com a ajuda do código Python [GPIO Zero](https://gpiozero.readthedocs.org/) +* Integrar a câmera ao Minecraft Pi +* Publicar as fotos da câmera automaticamente no Twitter + +Experimente esses projetos do Módulo de Câmera para saber mais: + +- Crie um filme [stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) +- Faça uma [cabine fotográfica no Minecraft](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Faça o [Babbage bear tuitar imagens](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Construa um sistema de [controle dos pais](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use o Módulo de Câmera NoIR para criar uma [caixa infravermelha de pássaros](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +Para obter mais informações sobre como escrever código Python para controlar o Módulo de Câmera, consulte a extensa [documentação picamera](https://picamera.readthedocs.org/). + diff --git a/pt-PT/images/Getting_Started_With_Picamera_TILE.png b/pt-PT/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/pt-PT/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/pt-PT/images/banner.png b/pt-PT/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/pt-PT/images/banner.png differ diff --git a/pt-PT/images/blur.jpg b/pt-PT/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/pt-PT/images/blur.jpg differ diff --git a/pt-PT/images/camera-module.png b/pt-PT/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/pt-PT/images/camera-module.png differ diff --git a/pt-PT/images/cartoon.jpg b/pt-PT/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/pt-PT/images/cartoon.jpg differ diff --git a/pt-PT/images/colorbalance.jpg b/pt-PT/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/pt-PT/images/colorbalance.jpg differ diff --git a/pt-PT/images/colorpoint.jpg b/pt-PT/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/pt-PT/images/colorpoint.jpg differ diff --git a/pt-PT/images/colorswap.jpg b/pt-PT/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/pt-PT/images/colorswap.jpg differ diff --git a/pt-PT/images/connect-camera-old.gif b/pt-PT/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/pt-PT/images/connect-camera-old.gif differ diff --git a/pt-PT/images/connect-camera.gif b/pt-PT/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/pt-PT/images/connect-camera.gif differ diff --git a/pt-PT/images/connect-camera.gif.gif b/pt-PT/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/pt-PT/images/connect-camera.gif.gif differ diff --git a/pt-PT/images/connect-camera1.png b/pt-PT/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/pt-PT/images/connect-camera1.png differ diff --git a/pt-PT/images/connect-camera2.png b/pt-PT/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/pt-PT/images/connect-camera2.png differ diff --git a/pt-PT/images/connect-camera3.png b/pt-PT/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/pt-PT/images/connect-camera3.png differ diff --git a/pt-PT/images/connect-camera4.png b/pt-PT/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/pt-PT/images/connect-camera4.png differ diff --git a/pt-PT/images/connect-camera5.png b/pt-PT/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/pt-PT/images/connect-camera5.png differ diff --git a/pt-PT/images/deinterlace1.jpg b/pt-PT/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/pt-PT/images/deinterlace1.jpg differ diff --git a/pt-PT/images/deinterlace2.jpg b/pt-PT/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/pt-PT/images/deinterlace2.jpg differ diff --git a/pt-PT/images/denoise.jpg b/pt-PT/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/pt-PT/images/denoise.jpg differ diff --git a/pt-PT/images/desktop-annotated.png b/pt-PT/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/pt-PT/images/desktop-annotated.png differ diff --git a/pt-PT/images/desktop.png b/pt-PT/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/pt-PT/images/desktop.png differ diff --git a/pt-PT/images/effects.jpg b/pt-PT/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/pt-PT/images/effects.jpg differ diff --git a/pt-PT/images/emboss.jpg b/pt-PT/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/pt-PT/images/emboss.jpg differ diff --git a/pt-PT/images/film.jpg b/pt-PT/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/pt-PT/images/film.jpg differ diff --git a/pt-PT/images/gpen.jpg b/pt-PT/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/pt-PT/images/gpen.jpg differ diff --git a/pt-PT/images/hatch.jpg b/pt-PT/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/pt-PT/images/hatch.jpg differ diff --git a/pt-PT/images/negative.jpg b/pt-PT/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/pt-PT/images/negative.jpg differ diff --git a/pt-PT/images/none.jpg b/pt-PT/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/pt-PT/images/none.jpg differ diff --git a/pt-PT/images/oilpaint.jpg b/pt-PT/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/pt-PT/images/oilpaint.jpg differ diff --git a/pt-PT/images/open-terminal-annotated.png b/pt-PT/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/pt-PT/images/open-terminal-annotated.png differ diff --git a/pt-PT/images/open-terminal.png b/pt-PT/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/pt-PT/images/open-terminal.png differ diff --git a/pt-PT/images/pastel.jpg b/pt-PT/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/pt-PT/images/pastel.jpg differ diff --git a/pt-PT/images/pi-camera-attached.jpg b/pt-PT/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/pt-PT/images/pi-camera-attached.jpg differ diff --git a/pt-PT/images/pi-configuration-interfaces-annotated.png b/pt-PT/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/pt-PT/images/pi-configuration-interfaces-annotated.png differ diff --git a/pt-PT/images/pi-configuration-interfaces.png b/pt-PT/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/pt-PT/images/pi-configuration-interfaces.png differ diff --git a/pt-PT/images/pi-configuration-menu.png b/pt-PT/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/pt-PT/images/pi-configuration-menu.png differ diff --git a/pt-PT/images/pi4-camera-port.png b/pt-PT/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/pt-PT/images/pi4-camera-port.png differ diff --git a/pt-PT/images/posterise.jpg b/pt-PT/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/pt-PT/images/posterise.jpg differ diff --git a/pt-PT/images/preview.jpg b/pt-PT/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/pt-PT/images/preview.jpg differ diff --git a/pt-PT/images/raspberry-pi.png b/pt-PT/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/pt-PT/images/raspberry-pi.png differ diff --git a/pt-PT/images/raspistill-help.png b/pt-PT/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/pt-PT/images/raspistill-help.png differ diff --git a/pt-PT/images/raspistill-image.png b/pt-PT/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/pt-PT/images/raspistill-image.png differ diff --git a/pt-PT/images/saturation.jpg b/pt-PT/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/pt-PT/images/saturation.jpg differ diff --git a/pt-PT/images/sketch.jpg b/pt-PT/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/pt-PT/images/sketch.jpg differ diff --git a/pt-PT/images/solarize.jpg b/pt-PT/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/pt-PT/images/solarize.jpg differ diff --git a/pt-PT/images/thonny-app-menu.png b/pt-PT/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/pt-PT/images/thonny-app-menu.png differ diff --git a/pt-PT/images/washedout.jpg b/pt-PT/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/pt-PT/images/washedout.jpg differ diff --git a/pt-PT/images/watercolor.jpg b/pt-PT/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/pt-PT/images/watercolor.jpg differ diff --git a/pt-PT/meta.yml b/pt-PT/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/pt-PT/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/pt-PT/step_1.md b/pt-PT/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/pt-PT/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/pt-PT/step_2.md b/pt-PT/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/pt-PT/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/pt-PT/step_3.md b/pt-PT/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/pt-PT/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/pt-PT/step_4.md b/pt-PT/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/pt-PT/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 Enter 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/pt-PT/step_5.md b/pt-PT/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/pt-PT/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`. \ No newline at end of file diff --git a/pt-PT/step_6.md b/pt-PT/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/pt-PT/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. \ No newline at end of file diff --git a/pt-PT/step_7.md b/pt-PT/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/pt-PT/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. + diff --git a/pt-PT/step_8.md b/pt-PT/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/pt-PT/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/pt-PT/step_9.md b/pt-PT/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/pt-PT/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/ro-RO/images/Getting_Started_With_Picamera_TILE.png b/ro-RO/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/ro-RO/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/ro-RO/images/banner.png b/ro-RO/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/ro-RO/images/banner.png differ diff --git a/ro-RO/images/blur.jpg b/ro-RO/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/ro-RO/images/blur.jpg differ diff --git a/ro-RO/images/camera-module.png b/ro-RO/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/ro-RO/images/camera-module.png differ diff --git a/ro-RO/images/cartoon.jpg b/ro-RO/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/ro-RO/images/cartoon.jpg differ diff --git a/ro-RO/images/colorbalance.jpg b/ro-RO/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/ro-RO/images/colorbalance.jpg differ diff --git a/ro-RO/images/colorpoint.jpg b/ro-RO/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/ro-RO/images/colorpoint.jpg differ diff --git a/ro-RO/images/colorswap.jpg b/ro-RO/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/ro-RO/images/colorswap.jpg differ diff --git a/ro-RO/images/connect-camera-old.gif b/ro-RO/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ro-RO/images/connect-camera-old.gif differ diff --git a/ro-RO/images/connect-camera.gif b/ro-RO/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ro-RO/images/connect-camera.gif differ diff --git a/ro-RO/images/connect-camera.gif.gif b/ro-RO/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ro-RO/images/connect-camera.gif.gif differ diff --git a/ro-RO/images/connect-camera1.png b/ro-RO/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/ro-RO/images/connect-camera1.png differ diff --git a/ro-RO/images/connect-camera2.png b/ro-RO/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/ro-RO/images/connect-camera2.png differ diff --git a/ro-RO/images/connect-camera3.png b/ro-RO/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/ro-RO/images/connect-camera3.png differ diff --git a/ro-RO/images/connect-camera4.png b/ro-RO/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/ro-RO/images/connect-camera4.png differ diff --git a/ro-RO/images/connect-camera5.png b/ro-RO/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/ro-RO/images/connect-camera5.png differ diff --git a/ro-RO/images/deinterlace1.jpg b/ro-RO/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/ro-RO/images/deinterlace1.jpg differ diff --git a/ro-RO/images/deinterlace2.jpg b/ro-RO/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/ro-RO/images/deinterlace2.jpg differ diff --git a/ro-RO/images/denoise.jpg b/ro-RO/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/ro-RO/images/denoise.jpg differ diff --git a/ro-RO/images/desktop-annotated.png b/ro-RO/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/ro-RO/images/desktop-annotated.png differ diff --git a/ro-RO/images/desktop.png b/ro-RO/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/ro-RO/images/desktop.png differ diff --git a/ro-RO/images/effects.jpg b/ro-RO/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/ro-RO/images/effects.jpg differ diff --git a/ro-RO/images/emboss.jpg b/ro-RO/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/ro-RO/images/emboss.jpg differ diff --git a/ro-RO/images/film.jpg b/ro-RO/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/ro-RO/images/film.jpg differ diff --git a/ro-RO/images/gpen.jpg b/ro-RO/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/ro-RO/images/gpen.jpg differ diff --git a/ro-RO/images/hatch.jpg b/ro-RO/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/ro-RO/images/hatch.jpg differ diff --git a/ro-RO/images/negative.jpg b/ro-RO/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/ro-RO/images/negative.jpg differ diff --git a/ro-RO/images/none.jpg b/ro-RO/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/ro-RO/images/none.jpg differ diff --git a/ro-RO/images/oilpaint.jpg b/ro-RO/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/ro-RO/images/oilpaint.jpg differ diff --git a/ro-RO/images/open-terminal-annotated.png b/ro-RO/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/ro-RO/images/open-terminal-annotated.png differ diff --git a/ro-RO/images/open-terminal.png b/ro-RO/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/ro-RO/images/open-terminal.png differ diff --git a/ro-RO/images/pastel.jpg b/ro-RO/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/ro-RO/images/pastel.jpg differ diff --git a/ro-RO/images/pi-camera-attached.jpg b/ro-RO/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/ro-RO/images/pi-camera-attached.jpg differ diff --git a/ro-RO/images/pi-configuration-interfaces-annotated.png b/ro-RO/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/ro-RO/images/pi-configuration-interfaces-annotated.png differ diff --git a/ro-RO/images/pi-configuration-interfaces.png b/ro-RO/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/ro-RO/images/pi-configuration-interfaces.png differ diff --git a/ro-RO/images/pi-configuration-menu.png b/ro-RO/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/ro-RO/images/pi-configuration-menu.png differ diff --git a/ro-RO/images/pi4-camera-port.png b/ro-RO/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/ro-RO/images/pi4-camera-port.png differ diff --git a/ro-RO/images/posterise.jpg b/ro-RO/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/ro-RO/images/posterise.jpg differ diff --git a/ro-RO/images/preview.jpg b/ro-RO/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/ro-RO/images/preview.jpg differ diff --git a/ro-RO/images/raspberry-pi.png b/ro-RO/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/ro-RO/images/raspberry-pi.png differ diff --git a/ro-RO/images/raspistill-help.png b/ro-RO/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/ro-RO/images/raspistill-help.png differ diff --git a/ro-RO/images/raspistill-image.png b/ro-RO/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/ro-RO/images/raspistill-image.png differ diff --git a/ro-RO/images/saturation.jpg b/ro-RO/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/ro-RO/images/saturation.jpg differ diff --git a/ro-RO/images/sketch.jpg b/ro-RO/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/ro-RO/images/sketch.jpg differ diff --git a/ro-RO/images/solarize.jpg b/ro-RO/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/ro-RO/images/solarize.jpg differ diff --git a/ro-RO/images/thonny-app-menu.png b/ro-RO/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/ro-RO/images/thonny-app-menu.png differ diff --git a/ro-RO/images/washedout.jpg b/ro-RO/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/ro-RO/images/washedout.jpg differ diff --git a/ro-RO/images/watercolor.jpg b/ro-RO/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/ro-RO/images/watercolor.jpg differ diff --git a/ro-RO/meta.yml b/ro-RO/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/ro-RO/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/ro-RO/step_1.md b/ro-RO/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/ro-RO/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/ro-RO/step_2.md b/ro-RO/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/ro-RO/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/ro-RO/step_3.md b/ro-RO/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/ro-RO/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/ro-RO/step_4.md b/ro-RO/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/ro-RO/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 Enter 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/ro-RO/step_5.md b/ro-RO/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/ro-RO/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`. \ No newline at end of file diff --git a/ro-RO/step_6.md b/ro-RO/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/ro-RO/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. \ No newline at end of file diff --git a/ro-RO/step_7.md b/ro-RO/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/ro-RO/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. + diff --git a/ro-RO/step_8.md b/ro-RO/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/ro-RO/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/ro-RO/step_9.md b/ro-RO/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/ro-RO/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/ru-RU/images/Getting_Started_With_Picamera_TILE.png b/ru-RU/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/ru-RU/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/ru-RU/images/banner.png b/ru-RU/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/ru-RU/images/banner.png differ diff --git a/ru-RU/images/blur.jpg b/ru-RU/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/ru-RU/images/blur.jpg differ diff --git a/ru-RU/images/camera-module.png b/ru-RU/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/ru-RU/images/camera-module.png differ diff --git a/ru-RU/images/cartoon.jpg b/ru-RU/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/ru-RU/images/cartoon.jpg differ diff --git a/ru-RU/images/colorbalance.jpg b/ru-RU/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/ru-RU/images/colorbalance.jpg differ diff --git a/ru-RU/images/colorpoint.jpg b/ru-RU/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/ru-RU/images/colorpoint.jpg differ diff --git a/ru-RU/images/colorswap.jpg b/ru-RU/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/ru-RU/images/colorswap.jpg differ diff --git a/ru-RU/images/connect-camera-old.gif b/ru-RU/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/ru-RU/images/connect-camera-old.gif differ diff --git a/ru-RU/images/connect-camera.gif b/ru-RU/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ru-RU/images/connect-camera.gif differ diff --git a/ru-RU/images/connect-camera.gif.gif b/ru-RU/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/ru-RU/images/connect-camera.gif.gif differ diff --git a/ru-RU/images/connect-camera1.png b/ru-RU/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/ru-RU/images/connect-camera1.png differ diff --git a/ru-RU/images/connect-camera2.png b/ru-RU/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/ru-RU/images/connect-camera2.png differ diff --git a/ru-RU/images/connect-camera3.png b/ru-RU/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/ru-RU/images/connect-camera3.png differ diff --git a/ru-RU/images/connect-camera4.png b/ru-RU/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/ru-RU/images/connect-camera4.png differ diff --git a/ru-RU/images/connect-camera5.png b/ru-RU/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/ru-RU/images/connect-camera5.png differ diff --git a/ru-RU/images/deinterlace1.jpg b/ru-RU/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/ru-RU/images/deinterlace1.jpg differ diff --git a/ru-RU/images/deinterlace2.jpg b/ru-RU/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/ru-RU/images/deinterlace2.jpg differ diff --git a/ru-RU/images/denoise.jpg b/ru-RU/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/ru-RU/images/denoise.jpg differ diff --git a/ru-RU/images/desktop-annotated.png b/ru-RU/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/ru-RU/images/desktop-annotated.png differ diff --git a/ru-RU/images/desktop.png b/ru-RU/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/ru-RU/images/desktop.png differ diff --git a/ru-RU/images/effects.jpg b/ru-RU/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/ru-RU/images/effects.jpg differ diff --git a/ru-RU/images/emboss.jpg b/ru-RU/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/ru-RU/images/emboss.jpg differ diff --git a/ru-RU/images/film.jpg b/ru-RU/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/ru-RU/images/film.jpg differ diff --git a/ru-RU/images/gpen.jpg b/ru-RU/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/ru-RU/images/gpen.jpg differ diff --git a/ru-RU/images/hatch.jpg b/ru-RU/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/ru-RU/images/hatch.jpg differ diff --git a/ru-RU/images/negative.jpg b/ru-RU/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/ru-RU/images/negative.jpg differ diff --git a/ru-RU/images/none.jpg b/ru-RU/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/ru-RU/images/none.jpg differ diff --git a/ru-RU/images/oilpaint.jpg b/ru-RU/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/ru-RU/images/oilpaint.jpg differ diff --git a/ru-RU/images/open-terminal-annotated.png b/ru-RU/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/ru-RU/images/open-terminal-annotated.png differ diff --git a/ru-RU/images/open-terminal.png b/ru-RU/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/ru-RU/images/open-terminal.png differ diff --git a/ru-RU/images/pastel.jpg b/ru-RU/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/ru-RU/images/pastel.jpg differ diff --git a/ru-RU/images/pi-camera-attached.jpg b/ru-RU/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/ru-RU/images/pi-camera-attached.jpg differ diff --git a/ru-RU/images/pi-configuration-interfaces-annotated.png b/ru-RU/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/ru-RU/images/pi-configuration-interfaces-annotated.png differ diff --git a/ru-RU/images/pi-configuration-interfaces.png b/ru-RU/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/ru-RU/images/pi-configuration-interfaces.png differ diff --git a/ru-RU/images/pi-configuration-menu.png b/ru-RU/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/ru-RU/images/pi-configuration-menu.png differ diff --git a/ru-RU/images/pi4-camera-port.png b/ru-RU/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/ru-RU/images/pi4-camera-port.png differ diff --git a/ru-RU/images/posterise.jpg b/ru-RU/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/ru-RU/images/posterise.jpg differ diff --git a/ru-RU/images/preview.jpg b/ru-RU/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/ru-RU/images/preview.jpg differ diff --git a/ru-RU/images/raspberry-pi.png b/ru-RU/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/ru-RU/images/raspberry-pi.png differ diff --git a/ru-RU/images/raspistill-help.png b/ru-RU/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/ru-RU/images/raspistill-help.png differ diff --git a/ru-RU/images/raspistill-image.png b/ru-RU/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/ru-RU/images/raspistill-image.png differ diff --git a/ru-RU/images/saturation.jpg b/ru-RU/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/ru-RU/images/saturation.jpg differ diff --git a/ru-RU/images/sketch.jpg b/ru-RU/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/ru-RU/images/sketch.jpg differ diff --git a/ru-RU/images/solarize.jpg b/ru-RU/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/ru-RU/images/solarize.jpg differ diff --git a/ru-RU/images/thonny-app-menu.png b/ru-RU/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/ru-RU/images/thonny-app-menu.png differ diff --git a/ru-RU/images/washedout.jpg b/ru-RU/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/ru-RU/images/washedout.jpg differ diff --git a/ru-RU/images/watercolor.jpg b/ru-RU/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/ru-RU/images/watercolor.jpg differ diff --git a/ru-RU/meta.yml b/ru-RU/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/ru-RU/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/ru-RU/step_1.md b/ru-RU/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/ru-RU/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/ru-RU/step_2.md b/ru-RU/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/ru-RU/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/ru-RU/step_3.md b/ru-RU/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/ru-RU/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/ru-RU/step_4.md b/ru-RU/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/ru-RU/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 Enter 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/ru-RU/step_5.md b/ru-RU/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/ru-RU/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`. \ No newline at end of file diff --git a/ru-RU/step_6.md b/ru-RU/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/ru-RU/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. \ No newline at end of file diff --git a/ru-RU/step_7.md b/ru-RU/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/ru-RU/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. + diff --git a/ru-RU/step_8.md b/ru-RU/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/ru-RU/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/ru-RU/step_9.md b/ru-RU/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/ru-RU/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/sr-SP/images/Getting_Started_With_Picamera_TILE.png b/sr-SP/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/sr-SP/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/sr-SP/images/banner.png b/sr-SP/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/sr-SP/images/banner.png differ diff --git a/sr-SP/images/blur.jpg b/sr-SP/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/sr-SP/images/blur.jpg differ diff --git a/sr-SP/images/camera-module.png b/sr-SP/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/sr-SP/images/camera-module.png differ diff --git a/sr-SP/images/cartoon.jpg b/sr-SP/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/sr-SP/images/cartoon.jpg differ diff --git a/sr-SP/images/colorbalance.jpg b/sr-SP/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/sr-SP/images/colorbalance.jpg differ diff --git a/sr-SP/images/colorpoint.jpg b/sr-SP/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/sr-SP/images/colorpoint.jpg differ diff --git a/sr-SP/images/colorswap.jpg b/sr-SP/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/sr-SP/images/colorswap.jpg differ diff --git a/sr-SP/images/connect-camera-old.gif b/sr-SP/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/sr-SP/images/connect-camera-old.gif differ diff --git a/sr-SP/images/connect-camera.gif b/sr-SP/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/sr-SP/images/connect-camera.gif differ diff --git a/sr-SP/images/connect-camera.gif.gif b/sr-SP/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/sr-SP/images/connect-camera.gif.gif differ diff --git a/sr-SP/images/connect-camera1.png b/sr-SP/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/sr-SP/images/connect-camera1.png differ diff --git a/sr-SP/images/connect-camera2.png b/sr-SP/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/sr-SP/images/connect-camera2.png differ diff --git a/sr-SP/images/connect-camera3.png b/sr-SP/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/sr-SP/images/connect-camera3.png differ diff --git a/sr-SP/images/connect-camera4.png b/sr-SP/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/sr-SP/images/connect-camera4.png differ diff --git a/sr-SP/images/connect-camera5.png b/sr-SP/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/sr-SP/images/connect-camera5.png differ diff --git a/sr-SP/images/deinterlace1.jpg b/sr-SP/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/sr-SP/images/deinterlace1.jpg differ diff --git a/sr-SP/images/deinterlace2.jpg b/sr-SP/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/sr-SP/images/deinterlace2.jpg differ diff --git a/sr-SP/images/denoise.jpg b/sr-SP/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/sr-SP/images/denoise.jpg differ diff --git a/sr-SP/images/desktop-annotated.png b/sr-SP/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/sr-SP/images/desktop-annotated.png differ diff --git a/sr-SP/images/desktop.png b/sr-SP/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/sr-SP/images/desktop.png differ diff --git a/sr-SP/images/effects.jpg b/sr-SP/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/sr-SP/images/effects.jpg differ diff --git a/sr-SP/images/emboss.jpg b/sr-SP/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/sr-SP/images/emboss.jpg differ diff --git a/sr-SP/images/film.jpg b/sr-SP/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/sr-SP/images/film.jpg differ diff --git a/sr-SP/images/gpen.jpg b/sr-SP/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/sr-SP/images/gpen.jpg differ diff --git a/sr-SP/images/hatch.jpg b/sr-SP/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/sr-SP/images/hatch.jpg differ diff --git a/sr-SP/images/negative.jpg b/sr-SP/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/sr-SP/images/negative.jpg differ diff --git a/sr-SP/images/none.jpg b/sr-SP/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/sr-SP/images/none.jpg differ diff --git a/sr-SP/images/oilpaint.jpg b/sr-SP/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/sr-SP/images/oilpaint.jpg differ diff --git a/sr-SP/images/open-terminal-annotated.png b/sr-SP/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/sr-SP/images/open-terminal-annotated.png differ diff --git a/sr-SP/images/open-terminal.png b/sr-SP/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/sr-SP/images/open-terminal.png differ diff --git a/sr-SP/images/pastel.jpg b/sr-SP/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/sr-SP/images/pastel.jpg differ diff --git a/sr-SP/images/pi-camera-attached.jpg b/sr-SP/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/sr-SP/images/pi-camera-attached.jpg differ diff --git a/sr-SP/images/pi-configuration-interfaces-annotated.png b/sr-SP/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/sr-SP/images/pi-configuration-interfaces-annotated.png differ diff --git a/sr-SP/images/pi-configuration-interfaces.png b/sr-SP/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/sr-SP/images/pi-configuration-interfaces.png differ diff --git a/sr-SP/images/pi-configuration-menu.png b/sr-SP/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/sr-SP/images/pi-configuration-menu.png differ diff --git a/sr-SP/images/pi4-camera-port.png b/sr-SP/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/sr-SP/images/pi4-camera-port.png differ diff --git a/sr-SP/images/posterise.jpg b/sr-SP/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/sr-SP/images/posterise.jpg differ diff --git a/sr-SP/images/preview.jpg b/sr-SP/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/sr-SP/images/preview.jpg differ diff --git a/sr-SP/images/raspberry-pi.png b/sr-SP/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/sr-SP/images/raspberry-pi.png differ diff --git a/sr-SP/images/raspistill-help.png b/sr-SP/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/sr-SP/images/raspistill-help.png differ diff --git a/sr-SP/images/raspistill-image.png b/sr-SP/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/sr-SP/images/raspistill-image.png differ diff --git a/sr-SP/images/saturation.jpg b/sr-SP/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/sr-SP/images/saturation.jpg differ diff --git a/sr-SP/images/sketch.jpg b/sr-SP/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/sr-SP/images/sketch.jpg differ diff --git a/sr-SP/images/solarize.jpg b/sr-SP/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/sr-SP/images/solarize.jpg differ diff --git a/sr-SP/images/thonny-app-menu.png b/sr-SP/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/sr-SP/images/thonny-app-menu.png differ diff --git a/sr-SP/images/washedout.jpg b/sr-SP/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/sr-SP/images/washedout.jpg differ diff --git a/sr-SP/images/watercolor.jpg b/sr-SP/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/sr-SP/images/watercolor.jpg differ diff --git a/sr-SP/meta.yml b/sr-SP/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/sr-SP/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/sr-SP/step_1.md b/sr-SP/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/sr-SP/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/sr-SP/step_2.md b/sr-SP/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/sr-SP/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/sr-SP/step_3.md b/sr-SP/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/sr-SP/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/sr-SP/step_4.md b/sr-SP/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/sr-SP/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 Enter 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/sr-SP/step_5.md b/sr-SP/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/sr-SP/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`. \ No newline at end of file diff --git a/sr-SP/step_6.md b/sr-SP/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/sr-SP/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. \ No newline at end of file diff --git a/sr-SP/step_7.md b/sr-SP/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/sr-SP/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. + diff --git a/sr-SP/step_8.md b/sr-SP/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/sr-SP/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/sr-SP/step_9.md b/sr-SP/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/sr-SP/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/sv-SE/images/Getting_Started_With_Picamera_TILE.png b/sv-SE/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/sv-SE/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/sv-SE/images/banner.png b/sv-SE/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/sv-SE/images/banner.png differ diff --git a/sv-SE/images/blur.jpg b/sv-SE/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/sv-SE/images/blur.jpg differ diff --git a/sv-SE/images/camera-module.png b/sv-SE/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/sv-SE/images/camera-module.png differ diff --git a/sv-SE/images/cartoon.jpg b/sv-SE/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/sv-SE/images/cartoon.jpg differ diff --git a/sv-SE/images/colorbalance.jpg b/sv-SE/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/sv-SE/images/colorbalance.jpg differ diff --git a/sv-SE/images/colorpoint.jpg b/sv-SE/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/sv-SE/images/colorpoint.jpg differ diff --git a/sv-SE/images/colorswap.jpg b/sv-SE/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/sv-SE/images/colorswap.jpg differ diff --git a/sv-SE/images/connect-camera-old.gif b/sv-SE/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/sv-SE/images/connect-camera-old.gif differ diff --git a/sv-SE/images/connect-camera.gif b/sv-SE/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/sv-SE/images/connect-camera.gif differ diff --git a/sv-SE/images/connect-camera.gif.gif b/sv-SE/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/sv-SE/images/connect-camera.gif.gif differ diff --git a/sv-SE/images/connect-camera1.png b/sv-SE/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/sv-SE/images/connect-camera1.png differ diff --git a/sv-SE/images/connect-camera2.png b/sv-SE/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/sv-SE/images/connect-camera2.png differ diff --git a/sv-SE/images/connect-camera3.png b/sv-SE/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/sv-SE/images/connect-camera3.png differ diff --git a/sv-SE/images/connect-camera4.png b/sv-SE/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/sv-SE/images/connect-camera4.png differ diff --git a/sv-SE/images/connect-camera5.png b/sv-SE/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/sv-SE/images/connect-camera5.png differ diff --git a/sv-SE/images/deinterlace1.jpg b/sv-SE/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/sv-SE/images/deinterlace1.jpg differ diff --git a/sv-SE/images/deinterlace2.jpg b/sv-SE/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/sv-SE/images/deinterlace2.jpg differ diff --git a/sv-SE/images/denoise.jpg b/sv-SE/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/sv-SE/images/denoise.jpg differ diff --git a/sv-SE/images/desktop-annotated.png b/sv-SE/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/sv-SE/images/desktop-annotated.png differ diff --git a/sv-SE/images/desktop.png b/sv-SE/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/sv-SE/images/desktop.png differ diff --git a/sv-SE/images/effects.jpg b/sv-SE/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/sv-SE/images/effects.jpg differ diff --git a/sv-SE/images/emboss.jpg b/sv-SE/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/sv-SE/images/emboss.jpg differ diff --git a/sv-SE/images/film.jpg b/sv-SE/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/sv-SE/images/film.jpg differ diff --git a/sv-SE/images/gpen.jpg b/sv-SE/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/sv-SE/images/gpen.jpg differ diff --git a/sv-SE/images/hatch.jpg b/sv-SE/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/sv-SE/images/hatch.jpg differ diff --git a/sv-SE/images/negative.jpg b/sv-SE/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/sv-SE/images/negative.jpg differ diff --git a/sv-SE/images/none.jpg b/sv-SE/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/sv-SE/images/none.jpg differ diff --git a/sv-SE/images/oilpaint.jpg b/sv-SE/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/sv-SE/images/oilpaint.jpg differ diff --git a/sv-SE/images/open-terminal-annotated.png b/sv-SE/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/sv-SE/images/open-terminal-annotated.png differ diff --git a/sv-SE/images/open-terminal.png b/sv-SE/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/sv-SE/images/open-terminal.png differ diff --git a/sv-SE/images/pastel.jpg b/sv-SE/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/sv-SE/images/pastel.jpg differ diff --git a/sv-SE/images/pi-camera-attached.jpg b/sv-SE/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/sv-SE/images/pi-camera-attached.jpg differ diff --git a/sv-SE/images/pi-configuration-interfaces-annotated.png b/sv-SE/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/sv-SE/images/pi-configuration-interfaces-annotated.png differ diff --git a/sv-SE/images/pi-configuration-interfaces.png b/sv-SE/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/sv-SE/images/pi-configuration-interfaces.png differ diff --git a/sv-SE/images/pi-configuration-menu.png b/sv-SE/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/sv-SE/images/pi-configuration-menu.png differ diff --git a/sv-SE/images/pi4-camera-port.png b/sv-SE/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/sv-SE/images/pi4-camera-port.png differ diff --git a/sv-SE/images/posterise.jpg b/sv-SE/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/sv-SE/images/posterise.jpg differ diff --git a/sv-SE/images/preview.jpg b/sv-SE/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/sv-SE/images/preview.jpg differ diff --git a/sv-SE/images/raspberry-pi.png b/sv-SE/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/sv-SE/images/raspberry-pi.png differ diff --git a/sv-SE/images/raspistill-help.png b/sv-SE/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/sv-SE/images/raspistill-help.png differ diff --git a/sv-SE/images/raspistill-image.png b/sv-SE/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/sv-SE/images/raspistill-image.png differ diff --git a/sv-SE/images/saturation.jpg b/sv-SE/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/sv-SE/images/saturation.jpg differ diff --git a/sv-SE/images/sketch.jpg b/sv-SE/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/sv-SE/images/sketch.jpg differ diff --git a/sv-SE/images/solarize.jpg b/sv-SE/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/sv-SE/images/solarize.jpg differ diff --git a/sv-SE/images/thonny-app-menu.png b/sv-SE/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/sv-SE/images/thonny-app-menu.png differ diff --git a/sv-SE/images/washedout.jpg b/sv-SE/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/sv-SE/images/washedout.jpg differ diff --git a/sv-SE/images/watercolor.jpg b/sv-SE/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/sv-SE/images/watercolor.jpg differ diff --git a/sv-SE/meta.yml b/sv-SE/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/sv-SE/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/sv-SE/step_1.md b/sv-SE/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/sv-SE/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/sv-SE/step_2.md b/sv-SE/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/sv-SE/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/sv-SE/step_3.md b/sv-SE/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/sv-SE/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/sv-SE/step_4.md b/sv-SE/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/sv-SE/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 Enter 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/sv-SE/step_5.md b/sv-SE/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/sv-SE/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`. \ No newline at end of file diff --git a/sv-SE/step_6.md b/sv-SE/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/sv-SE/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. \ No newline at end of file diff --git a/sv-SE/step_7.md b/sv-SE/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/sv-SE/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. + diff --git a/sv-SE/step_8.md b/sv-SE/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/sv-SE/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/sv-SE/step_9.md b/sv-SE/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/sv-SE/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/tr-TR/images/Getting_Started_With_Picamera_TILE.png b/tr-TR/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/tr-TR/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/tr-TR/images/banner.png b/tr-TR/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/tr-TR/images/banner.png differ diff --git a/tr-TR/images/blur.jpg b/tr-TR/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/tr-TR/images/blur.jpg differ diff --git a/tr-TR/images/camera-module.png b/tr-TR/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/tr-TR/images/camera-module.png differ diff --git a/tr-TR/images/cartoon.jpg b/tr-TR/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/tr-TR/images/cartoon.jpg differ diff --git a/tr-TR/images/colorbalance.jpg b/tr-TR/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/tr-TR/images/colorbalance.jpg differ diff --git a/tr-TR/images/colorpoint.jpg b/tr-TR/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/tr-TR/images/colorpoint.jpg differ diff --git a/tr-TR/images/colorswap.jpg b/tr-TR/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/tr-TR/images/colorswap.jpg differ diff --git a/tr-TR/images/connect-camera-old.gif b/tr-TR/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/tr-TR/images/connect-camera-old.gif differ diff --git a/tr-TR/images/connect-camera.gif b/tr-TR/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/tr-TR/images/connect-camera.gif differ diff --git a/tr-TR/images/connect-camera.gif.gif b/tr-TR/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/tr-TR/images/connect-camera.gif.gif differ diff --git a/tr-TR/images/connect-camera1.png b/tr-TR/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/tr-TR/images/connect-camera1.png differ diff --git a/tr-TR/images/connect-camera2.png b/tr-TR/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/tr-TR/images/connect-camera2.png differ diff --git a/tr-TR/images/connect-camera3.png b/tr-TR/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/tr-TR/images/connect-camera3.png differ diff --git a/tr-TR/images/connect-camera4.png b/tr-TR/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/tr-TR/images/connect-camera4.png differ diff --git a/tr-TR/images/connect-camera5.png b/tr-TR/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/tr-TR/images/connect-camera5.png differ diff --git a/tr-TR/images/deinterlace1.jpg b/tr-TR/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/tr-TR/images/deinterlace1.jpg differ diff --git a/tr-TR/images/deinterlace2.jpg b/tr-TR/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/tr-TR/images/deinterlace2.jpg differ diff --git a/tr-TR/images/denoise.jpg b/tr-TR/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/tr-TR/images/denoise.jpg differ diff --git a/tr-TR/images/desktop-annotated.png b/tr-TR/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/tr-TR/images/desktop-annotated.png differ diff --git a/tr-TR/images/desktop.png b/tr-TR/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/tr-TR/images/desktop.png differ diff --git a/tr-TR/images/effects.jpg b/tr-TR/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/tr-TR/images/effects.jpg differ diff --git a/tr-TR/images/emboss.jpg b/tr-TR/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/tr-TR/images/emboss.jpg differ diff --git a/tr-TR/images/film.jpg b/tr-TR/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/tr-TR/images/film.jpg differ diff --git a/tr-TR/images/gpen.jpg b/tr-TR/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/tr-TR/images/gpen.jpg differ diff --git a/tr-TR/images/hatch.jpg b/tr-TR/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/tr-TR/images/hatch.jpg differ diff --git a/tr-TR/images/negative.jpg b/tr-TR/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/tr-TR/images/negative.jpg differ diff --git a/tr-TR/images/none.jpg b/tr-TR/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/tr-TR/images/none.jpg differ diff --git a/tr-TR/images/oilpaint.jpg b/tr-TR/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/tr-TR/images/oilpaint.jpg differ diff --git a/tr-TR/images/open-terminal-annotated.png b/tr-TR/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/tr-TR/images/open-terminal-annotated.png differ diff --git a/tr-TR/images/open-terminal.png b/tr-TR/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/tr-TR/images/open-terminal.png differ diff --git a/tr-TR/images/pastel.jpg b/tr-TR/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/tr-TR/images/pastel.jpg differ diff --git a/tr-TR/images/pi-camera-attached.jpg b/tr-TR/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/tr-TR/images/pi-camera-attached.jpg differ diff --git a/tr-TR/images/pi-configuration-interfaces-annotated.png b/tr-TR/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/tr-TR/images/pi-configuration-interfaces-annotated.png differ diff --git a/tr-TR/images/pi-configuration-interfaces.png b/tr-TR/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/tr-TR/images/pi-configuration-interfaces.png differ diff --git a/tr-TR/images/pi-configuration-menu.png b/tr-TR/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/tr-TR/images/pi-configuration-menu.png differ diff --git a/tr-TR/images/pi4-camera-port.png b/tr-TR/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/tr-TR/images/pi4-camera-port.png differ diff --git a/tr-TR/images/posterise.jpg b/tr-TR/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/tr-TR/images/posterise.jpg differ diff --git a/tr-TR/images/preview.jpg b/tr-TR/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/tr-TR/images/preview.jpg differ diff --git a/tr-TR/images/raspberry-pi.png b/tr-TR/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/tr-TR/images/raspberry-pi.png differ diff --git a/tr-TR/images/raspistill-help.png b/tr-TR/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/tr-TR/images/raspistill-help.png differ diff --git a/tr-TR/images/raspistill-image.png b/tr-TR/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/tr-TR/images/raspistill-image.png differ diff --git a/tr-TR/images/saturation.jpg b/tr-TR/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/tr-TR/images/saturation.jpg differ diff --git a/tr-TR/images/sketch.jpg b/tr-TR/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/tr-TR/images/sketch.jpg differ diff --git a/tr-TR/images/solarize.jpg b/tr-TR/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/tr-TR/images/solarize.jpg differ diff --git a/tr-TR/images/thonny-app-menu.png b/tr-TR/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/tr-TR/images/thonny-app-menu.png differ diff --git a/tr-TR/images/washedout.jpg b/tr-TR/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/tr-TR/images/washedout.jpg differ diff --git a/tr-TR/images/watercolor.jpg b/tr-TR/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/tr-TR/images/watercolor.jpg differ diff --git a/tr-TR/meta.yml b/tr-TR/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/tr-TR/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/tr-TR/step_1.md b/tr-TR/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/tr-TR/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/tr-TR/step_2.md b/tr-TR/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/tr-TR/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/tr-TR/step_3.md b/tr-TR/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/tr-TR/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/tr-TR/step_4.md b/tr-TR/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/tr-TR/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 Enter 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/tr-TR/step_5.md b/tr-TR/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/tr-TR/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`. \ No newline at end of file diff --git a/tr-TR/step_6.md b/tr-TR/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/tr-TR/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. \ No newline at end of file diff --git a/tr-TR/step_7.md b/tr-TR/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/tr-TR/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. + diff --git a/tr-TR/step_8.md b/tr-TR/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/tr-TR/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/tr-TR/step_9.md b/tr-TR/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/tr-TR/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/uk-UA/images/Getting_Started_With_Picamera_TILE.png b/uk-UA/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/uk-UA/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/uk-UA/images/banner.png b/uk-UA/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/uk-UA/images/banner.png differ diff --git a/uk-UA/images/blur.jpg b/uk-UA/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/uk-UA/images/blur.jpg differ diff --git a/uk-UA/images/camera-module.png b/uk-UA/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/uk-UA/images/camera-module.png differ diff --git a/uk-UA/images/cartoon.jpg b/uk-UA/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/uk-UA/images/cartoon.jpg differ diff --git a/uk-UA/images/colorbalance.jpg b/uk-UA/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/uk-UA/images/colorbalance.jpg differ diff --git a/uk-UA/images/colorpoint.jpg b/uk-UA/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/uk-UA/images/colorpoint.jpg differ diff --git a/uk-UA/images/colorswap.jpg b/uk-UA/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/uk-UA/images/colorswap.jpg differ diff --git a/uk-UA/images/connect-camera-old.gif b/uk-UA/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/uk-UA/images/connect-camera-old.gif differ diff --git a/uk-UA/images/connect-camera.gif b/uk-UA/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/uk-UA/images/connect-camera.gif differ diff --git a/uk-UA/images/connect-camera.gif.gif b/uk-UA/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/uk-UA/images/connect-camera.gif.gif differ diff --git a/uk-UA/images/connect-camera1.png b/uk-UA/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/uk-UA/images/connect-camera1.png differ diff --git a/uk-UA/images/connect-camera2.png b/uk-UA/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/uk-UA/images/connect-camera2.png differ diff --git a/uk-UA/images/connect-camera3.png b/uk-UA/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/uk-UA/images/connect-camera3.png differ diff --git a/uk-UA/images/connect-camera4.png b/uk-UA/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/uk-UA/images/connect-camera4.png differ diff --git a/uk-UA/images/connect-camera5.png b/uk-UA/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/uk-UA/images/connect-camera5.png differ diff --git a/uk-UA/images/deinterlace1.jpg b/uk-UA/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/uk-UA/images/deinterlace1.jpg differ diff --git a/uk-UA/images/deinterlace2.jpg b/uk-UA/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/uk-UA/images/deinterlace2.jpg differ diff --git a/uk-UA/images/denoise.jpg b/uk-UA/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/uk-UA/images/denoise.jpg differ diff --git a/uk-UA/images/desktop-annotated.png b/uk-UA/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/uk-UA/images/desktop-annotated.png differ diff --git a/uk-UA/images/desktop.png b/uk-UA/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/uk-UA/images/desktop.png differ diff --git a/uk-UA/images/effects.jpg b/uk-UA/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/uk-UA/images/effects.jpg differ diff --git a/uk-UA/images/emboss.jpg b/uk-UA/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/uk-UA/images/emboss.jpg differ diff --git a/uk-UA/images/film.jpg b/uk-UA/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/uk-UA/images/film.jpg differ diff --git a/uk-UA/images/gpen.jpg b/uk-UA/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/uk-UA/images/gpen.jpg differ diff --git a/uk-UA/images/hatch.jpg b/uk-UA/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/uk-UA/images/hatch.jpg differ diff --git a/uk-UA/images/negative.jpg b/uk-UA/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/uk-UA/images/negative.jpg differ diff --git a/uk-UA/images/none.jpg b/uk-UA/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/uk-UA/images/none.jpg differ diff --git a/uk-UA/images/oilpaint.jpg b/uk-UA/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/uk-UA/images/oilpaint.jpg differ diff --git a/uk-UA/images/open-terminal-annotated.png b/uk-UA/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/uk-UA/images/open-terminal-annotated.png differ diff --git a/uk-UA/images/open-terminal.png b/uk-UA/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/uk-UA/images/open-terminal.png differ diff --git a/uk-UA/images/pastel.jpg b/uk-UA/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/uk-UA/images/pastel.jpg differ diff --git a/uk-UA/images/pi-camera-attached.jpg b/uk-UA/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/uk-UA/images/pi-camera-attached.jpg differ diff --git a/uk-UA/images/pi-configuration-interfaces-annotated.png b/uk-UA/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/uk-UA/images/pi-configuration-interfaces-annotated.png differ diff --git a/uk-UA/images/pi-configuration-interfaces.png b/uk-UA/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/uk-UA/images/pi-configuration-interfaces.png differ diff --git a/uk-UA/images/pi-configuration-menu.png b/uk-UA/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/uk-UA/images/pi-configuration-menu.png differ diff --git a/uk-UA/images/pi4-camera-port.png b/uk-UA/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/uk-UA/images/pi4-camera-port.png differ diff --git a/uk-UA/images/posterise.jpg b/uk-UA/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/uk-UA/images/posterise.jpg differ diff --git a/uk-UA/images/preview.jpg b/uk-UA/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/uk-UA/images/preview.jpg differ diff --git a/uk-UA/images/raspberry-pi.png b/uk-UA/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/uk-UA/images/raspberry-pi.png differ diff --git a/uk-UA/images/raspistill-help.png b/uk-UA/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/uk-UA/images/raspistill-help.png differ diff --git a/uk-UA/images/raspistill-image.png b/uk-UA/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/uk-UA/images/raspistill-image.png differ diff --git a/uk-UA/images/saturation.jpg b/uk-UA/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/uk-UA/images/saturation.jpg differ diff --git a/uk-UA/images/sketch.jpg b/uk-UA/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/uk-UA/images/sketch.jpg differ diff --git a/uk-UA/images/solarize.jpg b/uk-UA/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/uk-UA/images/solarize.jpg differ diff --git a/uk-UA/images/thonny-app-menu.png b/uk-UA/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/uk-UA/images/thonny-app-menu.png differ diff --git a/uk-UA/images/washedout.jpg b/uk-UA/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/uk-UA/images/washedout.jpg differ diff --git a/uk-UA/images/watercolor.jpg b/uk-UA/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/uk-UA/images/watercolor.jpg differ diff --git a/uk-UA/meta.yml b/uk-UA/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/uk-UA/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/uk-UA/step_1.md b/uk-UA/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/uk-UA/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/uk-UA/step_2.md b/uk-UA/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/uk-UA/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/uk-UA/step_3.md b/uk-UA/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/uk-UA/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/uk-UA/step_4.md b/uk-UA/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/uk-UA/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 Enter 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/uk-UA/step_5.md b/uk-UA/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/uk-UA/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`. \ No newline at end of file diff --git a/uk-UA/step_6.md b/uk-UA/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/uk-UA/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. \ No newline at end of file diff --git a/uk-UA/step_7.md b/uk-UA/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/uk-UA/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. + diff --git a/uk-UA/step_8.md b/uk-UA/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/uk-UA/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/uk-UA/step_9.md b/uk-UA/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/uk-UA/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/vi-VN/images/Getting_Started_With_Picamera_TILE.png b/vi-VN/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/vi-VN/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/vi-VN/images/banner.png b/vi-VN/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/vi-VN/images/banner.png differ diff --git a/vi-VN/images/blur.jpg b/vi-VN/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/vi-VN/images/blur.jpg differ diff --git a/vi-VN/images/camera-module.png b/vi-VN/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/vi-VN/images/camera-module.png differ diff --git a/vi-VN/images/cartoon.jpg b/vi-VN/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/vi-VN/images/cartoon.jpg differ diff --git a/vi-VN/images/colorbalance.jpg b/vi-VN/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/vi-VN/images/colorbalance.jpg differ diff --git a/vi-VN/images/colorpoint.jpg b/vi-VN/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/vi-VN/images/colorpoint.jpg differ diff --git a/vi-VN/images/colorswap.jpg b/vi-VN/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/vi-VN/images/colorswap.jpg differ diff --git a/vi-VN/images/connect-camera-old.gif b/vi-VN/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/vi-VN/images/connect-camera-old.gif differ diff --git a/vi-VN/images/connect-camera.gif b/vi-VN/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/vi-VN/images/connect-camera.gif differ diff --git a/vi-VN/images/connect-camera.gif.gif b/vi-VN/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/vi-VN/images/connect-camera.gif.gif differ diff --git a/vi-VN/images/connect-camera1.png b/vi-VN/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/vi-VN/images/connect-camera1.png differ diff --git a/vi-VN/images/connect-camera2.png b/vi-VN/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/vi-VN/images/connect-camera2.png differ diff --git a/vi-VN/images/connect-camera3.png b/vi-VN/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/vi-VN/images/connect-camera3.png differ diff --git a/vi-VN/images/connect-camera4.png b/vi-VN/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/vi-VN/images/connect-camera4.png differ diff --git a/vi-VN/images/connect-camera5.png b/vi-VN/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/vi-VN/images/connect-camera5.png differ diff --git a/vi-VN/images/deinterlace1.jpg b/vi-VN/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/vi-VN/images/deinterlace1.jpg differ diff --git a/vi-VN/images/deinterlace2.jpg b/vi-VN/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/vi-VN/images/deinterlace2.jpg differ diff --git a/vi-VN/images/denoise.jpg b/vi-VN/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/vi-VN/images/denoise.jpg differ diff --git a/vi-VN/images/desktop-annotated.png b/vi-VN/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/vi-VN/images/desktop-annotated.png differ diff --git a/vi-VN/images/desktop.png b/vi-VN/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/vi-VN/images/desktop.png differ diff --git a/vi-VN/images/effects.jpg b/vi-VN/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/vi-VN/images/effects.jpg differ diff --git a/vi-VN/images/emboss.jpg b/vi-VN/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/vi-VN/images/emboss.jpg differ diff --git a/vi-VN/images/film.jpg b/vi-VN/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/vi-VN/images/film.jpg differ diff --git a/vi-VN/images/gpen.jpg b/vi-VN/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/vi-VN/images/gpen.jpg differ diff --git a/vi-VN/images/hatch.jpg b/vi-VN/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/vi-VN/images/hatch.jpg differ diff --git a/vi-VN/images/negative.jpg b/vi-VN/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/vi-VN/images/negative.jpg differ diff --git a/vi-VN/images/none.jpg b/vi-VN/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/vi-VN/images/none.jpg differ diff --git a/vi-VN/images/oilpaint.jpg b/vi-VN/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/vi-VN/images/oilpaint.jpg differ diff --git a/vi-VN/images/open-terminal-annotated.png b/vi-VN/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/vi-VN/images/open-terminal-annotated.png differ diff --git a/vi-VN/images/open-terminal.png b/vi-VN/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/vi-VN/images/open-terminal.png differ diff --git a/vi-VN/images/pastel.jpg b/vi-VN/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/vi-VN/images/pastel.jpg differ diff --git a/vi-VN/images/pi-camera-attached.jpg b/vi-VN/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/vi-VN/images/pi-camera-attached.jpg differ diff --git a/vi-VN/images/pi-configuration-interfaces-annotated.png b/vi-VN/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/vi-VN/images/pi-configuration-interfaces-annotated.png differ diff --git a/vi-VN/images/pi-configuration-interfaces.png b/vi-VN/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/vi-VN/images/pi-configuration-interfaces.png differ diff --git a/vi-VN/images/pi-configuration-menu.png b/vi-VN/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/vi-VN/images/pi-configuration-menu.png differ diff --git a/vi-VN/images/pi4-camera-port.png b/vi-VN/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/vi-VN/images/pi4-camera-port.png differ diff --git a/vi-VN/images/posterise.jpg b/vi-VN/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/vi-VN/images/posterise.jpg differ diff --git a/vi-VN/images/preview.jpg b/vi-VN/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/vi-VN/images/preview.jpg differ diff --git a/vi-VN/images/raspberry-pi.png b/vi-VN/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/vi-VN/images/raspberry-pi.png differ diff --git a/vi-VN/images/raspistill-help.png b/vi-VN/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/vi-VN/images/raspistill-help.png differ diff --git a/vi-VN/images/raspistill-image.png b/vi-VN/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/vi-VN/images/raspistill-image.png differ diff --git a/vi-VN/images/saturation.jpg b/vi-VN/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/vi-VN/images/saturation.jpg differ diff --git a/vi-VN/images/sketch.jpg b/vi-VN/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/vi-VN/images/sketch.jpg differ diff --git a/vi-VN/images/solarize.jpg b/vi-VN/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/vi-VN/images/solarize.jpg differ diff --git a/vi-VN/images/thonny-app-menu.png b/vi-VN/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/vi-VN/images/thonny-app-menu.png differ diff --git a/vi-VN/images/washedout.jpg b/vi-VN/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/vi-VN/images/washedout.jpg differ diff --git a/vi-VN/images/watercolor.jpg b/vi-VN/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/vi-VN/images/watercolor.jpg differ diff --git a/vi-VN/meta.yml b/vi-VN/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/vi-VN/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/vi-VN/step_1.md b/vi-VN/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/vi-VN/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/vi-VN/step_2.md b/vi-VN/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/vi-VN/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/vi-VN/step_3.md b/vi-VN/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/vi-VN/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/vi-VN/step_4.md b/vi-VN/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/vi-VN/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 Enter 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/vi-VN/step_5.md b/vi-VN/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/vi-VN/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`. \ No newline at end of file diff --git a/vi-VN/step_6.md b/vi-VN/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/vi-VN/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. \ No newline at end of file diff --git a/vi-VN/step_7.md b/vi-VN/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/vi-VN/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. + diff --git a/vi-VN/step_8.md b/vi-VN/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/vi-VN/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/vi-VN/step_9.md b/vi-VN/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/vi-VN/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/zh-CN/images/Getting_Started_With_Picamera_TILE.png b/zh-CN/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/zh-CN/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/zh-CN/images/banner.png b/zh-CN/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/zh-CN/images/banner.png differ diff --git a/zh-CN/images/blur.jpg b/zh-CN/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/zh-CN/images/blur.jpg differ diff --git a/zh-CN/images/camera-module.png b/zh-CN/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/zh-CN/images/camera-module.png differ diff --git a/zh-CN/images/cartoon.jpg b/zh-CN/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/zh-CN/images/cartoon.jpg differ diff --git a/zh-CN/images/colorbalance.jpg b/zh-CN/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/zh-CN/images/colorbalance.jpg differ diff --git a/zh-CN/images/colorpoint.jpg b/zh-CN/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/zh-CN/images/colorpoint.jpg differ diff --git a/zh-CN/images/colorswap.jpg b/zh-CN/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/zh-CN/images/colorswap.jpg differ diff --git a/zh-CN/images/connect-camera-old.gif b/zh-CN/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/zh-CN/images/connect-camera-old.gif differ diff --git a/zh-CN/images/connect-camera.gif b/zh-CN/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/zh-CN/images/connect-camera.gif differ diff --git a/zh-CN/images/connect-camera.gif.gif b/zh-CN/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/zh-CN/images/connect-camera.gif.gif differ diff --git a/zh-CN/images/connect-camera1.png b/zh-CN/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/zh-CN/images/connect-camera1.png differ diff --git a/zh-CN/images/connect-camera2.png b/zh-CN/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/zh-CN/images/connect-camera2.png differ diff --git a/zh-CN/images/connect-camera3.png b/zh-CN/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/zh-CN/images/connect-camera3.png differ diff --git a/zh-CN/images/connect-camera4.png b/zh-CN/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/zh-CN/images/connect-camera4.png differ diff --git a/zh-CN/images/connect-camera5.png b/zh-CN/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/zh-CN/images/connect-camera5.png differ diff --git a/zh-CN/images/deinterlace1.jpg b/zh-CN/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/zh-CN/images/deinterlace1.jpg differ diff --git a/zh-CN/images/deinterlace2.jpg b/zh-CN/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/zh-CN/images/deinterlace2.jpg differ diff --git a/zh-CN/images/denoise.jpg b/zh-CN/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/zh-CN/images/denoise.jpg differ diff --git a/zh-CN/images/desktop-annotated.png b/zh-CN/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/zh-CN/images/desktop-annotated.png differ diff --git a/zh-CN/images/desktop.png b/zh-CN/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/zh-CN/images/desktop.png differ diff --git a/zh-CN/images/effects.jpg b/zh-CN/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/zh-CN/images/effects.jpg differ diff --git a/zh-CN/images/emboss.jpg b/zh-CN/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/zh-CN/images/emboss.jpg differ diff --git a/zh-CN/images/film.jpg b/zh-CN/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/zh-CN/images/film.jpg differ diff --git a/zh-CN/images/gpen.jpg b/zh-CN/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/zh-CN/images/gpen.jpg differ diff --git a/zh-CN/images/hatch.jpg b/zh-CN/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/zh-CN/images/hatch.jpg differ diff --git a/zh-CN/images/negative.jpg b/zh-CN/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/zh-CN/images/negative.jpg differ diff --git a/zh-CN/images/none.jpg b/zh-CN/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/zh-CN/images/none.jpg differ diff --git a/zh-CN/images/oilpaint.jpg b/zh-CN/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/zh-CN/images/oilpaint.jpg differ diff --git a/zh-CN/images/open-terminal-annotated.png b/zh-CN/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/zh-CN/images/open-terminal-annotated.png differ diff --git a/zh-CN/images/open-terminal.png b/zh-CN/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/zh-CN/images/open-terminal.png differ diff --git a/zh-CN/images/pastel.jpg b/zh-CN/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/zh-CN/images/pastel.jpg differ diff --git a/zh-CN/images/pi-camera-attached.jpg b/zh-CN/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/zh-CN/images/pi-camera-attached.jpg differ diff --git a/zh-CN/images/pi-configuration-interfaces-annotated.png b/zh-CN/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/zh-CN/images/pi-configuration-interfaces-annotated.png differ diff --git a/zh-CN/images/pi-configuration-interfaces.png b/zh-CN/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/zh-CN/images/pi-configuration-interfaces.png differ diff --git a/zh-CN/images/pi-configuration-menu.png b/zh-CN/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/zh-CN/images/pi-configuration-menu.png differ diff --git a/zh-CN/images/pi4-camera-port.png b/zh-CN/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/zh-CN/images/pi4-camera-port.png differ diff --git a/zh-CN/images/posterise.jpg b/zh-CN/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/zh-CN/images/posterise.jpg differ diff --git a/zh-CN/images/preview.jpg b/zh-CN/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/zh-CN/images/preview.jpg differ diff --git a/zh-CN/images/raspberry-pi.png b/zh-CN/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/zh-CN/images/raspberry-pi.png differ diff --git a/zh-CN/images/raspistill-help.png b/zh-CN/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/zh-CN/images/raspistill-help.png differ diff --git a/zh-CN/images/raspistill-image.png b/zh-CN/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/zh-CN/images/raspistill-image.png differ diff --git a/zh-CN/images/saturation.jpg b/zh-CN/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/zh-CN/images/saturation.jpg differ diff --git a/zh-CN/images/sketch.jpg b/zh-CN/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/zh-CN/images/sketch.jpg differ diff --git a/zh-CN/images/solarize.jpg b/zh-CN/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/zh-CN/images/solarize.jpg differ diff --git a/zh-CN/images/thonny-app-menu.png b/zh-CN/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/zh-CN/images/thonny-app-menu.png differ diff --git a/zh-CN/images/washedout.jpg b/zh-CN/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/zh-CN/images/washedout.jpg differ diff --git a/zh-CN/images/watercolor.jpg b/zh-CN/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/zh-CN/images/watercolor.jpg differ diff --git a/zh-CN/meta.yml b/zh-CN/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/zh-CN/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/zh-CN/step_1.md b/zh-CN/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/zh-CN/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/zh-CN/step_2.md b/zh-CN/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/zh-CN/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/zh-CN/step_3.md b/zh-CN/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/zh-CN/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/zh-CN/step_4.md b/zh-CN/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/zh-CN/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 Enter 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/zh-CN/step_5.md b/zh-CN/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/zh-CN/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`. \ No newline at end of file diff --git a/zh-CN/step_6.md b/zh-CN/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/zh-CN/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. \ No newline at end of file diff --git a/zh-CN/step_7.md b/zh-CN/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/zh-CN/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. + diff --git a/zh-CN/step_8.md b/zh-CN/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/zh-CN/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/zh-CN/step_9.md b/zh-CN/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/zh-CN/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). + diff --git a/zh-TW/images/Getting_Started_With_Picamera_TILE.png b/zh-TW/images/Getting_Started_With_Picamera_TILE.png new file mode 100644 index 00000000..7c8080b1 Binary files /dev/null and b/zh-TW/images/Getting_Started_With_Picamera_TILE.png differ diff --git a/zh-TW/images/banner.png b/zh-TW/images/banner.png new file mode 100644 index 00000000..f222fe78 Binary files /dev/null and b/zh-TW/images/banner.png differ diff --git a/zh-TW/images/blur.jpg b/zh-TW/images/blur.jpg new file mode 100644 index 00000000..0a498557 Binary files /dev/null and b/zh-TW/images/blur.jpg differ diff --git a/zh-TW/images/camera-module.png b/zh-TW/images/camera-module.png new file mode 100644 index 00000000..cd5d8330 Binary files /dev/null and b/zh-TW/images/camera-module.png differ diff --git a/zh-TW/images/cartoon.jpg b/zh-TW/images/cartoon.jpg new file mode 100644 index 00000000..b1463e56 Binary files /dev/null and b/zh-TW/images/cartoon.jpg differ diff --git a/zh-TW/images/colorbalance.jpg b/zh-TW/images/colorbalance.jpg new file mode 100644 index 00000000..aba05d03 Binary files /dev/null and b/zh-TW/images/colorbalance.jpg differ diff --git a/zh-TW/images/colorpoint.jpg b/zh-TW/images/colorpoint.jpg new file mode 100644 index 00000000..fb549895 Binary files /dev/null and b/zh-TW/images/colorpoint.jpg differ diff --git a/zh-TW/images/colorswap.jpg b/zh-TW/images/colorswap.jpg new file mode 100644 index 00000000..b7192f1b Binary files /dev/null and b/zh-TW/images/colorswap.jpg differ diff --git a/zh-TW/images/connect-camera-old.gif b/zh-TW/images/connect-camera-old.gif new file mode 100644 index 00000000..3d15bbab Binary files /dev/null and b/zh-TW/images/connect-camera-old.gif differ diff --git a/zh-TW/images/connect-camera.gif b/zh-TW/images/connect-camera.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/zh-TW/images/connect-camera.gif differ diff --git a/zh-TW/images/connect-camera.gif.gif b/zh-TW/images/connect-camera.gif.gif new file mode 100644 index 00000000..00c9a95e Binary files /dev/null and b/zh-TW/images/connect-camera.gif.gif differ diff --git a/zh-TW/images/connect-camera1.png b/zh-TW/images/connect-camera1.png new file mode 100644 index 00000000..af6b07f2 Binary files /dev/null and b/zh-TW/images/connect-camera1.png differ diff --git a/zh-TW/images/connect-camera2.png b/zh-TW/images/connect-camera2.png new file mode 100644 index 00000000..62e3f53e Binary files /dev/null and b/zh-TW/images/connect-camera2.png differ diff --git a/zh-TW/images/connect-camera3.png b/zh-TW/images/connect-camera3.png new file mode 100644 index 00000000..bcb3c98a Binary files /dev/null and b/zh-TW/images/connect-camera3.png differ diff --git a/zh-TW/images/connect-camera4.png b/zh-TW/images/connect-camera4.png new file mode 100644 index 00000000..3496efbc Binary files /dev/null and b/zh-TW/images/connect-camera4.png differ diff --git a/zh-TW/images/connect-camera5.png b/zh-TW/images/connect-camera5.png new file mode 100644 index 00000000..0f7bab23 Binary files /dev/null and b/zh-TW/images/connect-camera5.png differ diff --git a/zh-TW/images/deinterlace1.jpg b/zh-TW/images/deinterlace1.jpg new file mode 100644 index 00000000..aa89ed31 Binary files /dev/null and b/zh-TW/images/deinterlace1.jpg differ diff --git a/zh-TW/images/deinterlace2.jpg b/zh-TW/images/deinterlace2.jpg new file mode 100644 index 00000000..2029922e Binary files /dev/null and b/zh-TW/images/deinterlace2.jpg differ diff --git a/zh-TW/images/denoise.jpg b/zh-TW/images/denoise.jpg new file mode 100644 index 00000000..657397cd Binary files /dev/null and b/zh-TW/images/denoise.jpg differ diff --git a/zh-TW/images/desktop-annotated.png b/zh-TW/images/desktop-annotated.png new file mode 100644 index 00000000..c3e0671a Binary files /dev/null and b/zh-TW/images/desktop-annotated.png differ diff --git a/zh-TW/images/desktop.png b/zh-TW/images/desktop.png new file mode 100644 index 00000000..58f796d7 Binary files /dev/null and b/zh-TW/images/desktop.png differ diff --git a/zh-TW/images/effects.jpg b/zh-TW/images/effects.jpg new file mode 100644 index 00000000..f2515758 Binary files /dev/null and b/zh-TW/images/effects.jpg differ diff --git a/zh-TW/images/emboss.jpg b/zh-TW/images/emboss.jpg new file mode 100644 index 00000000..4662a594 Binary files /dev/null and b/zh-TW/images/emboss.jpg differ diff --git a/zh-TW/images/film.jpg b/zh-TW/images/film.jpg new file mode 100644 index 00000000..e46fa48c Binary files /dev/null and b/zh-TW/images/film.jpg differ diff --git a/zh-TW/images/gpen.jpg b/zh-TW/images/gpen.jpg new file mode 100644 index 00000000..3dfa6742 Binary files /dev/null and b/zh-TW/images/gpen.jpg differ diff --git a/zh-TW/images/hatch.jpg b/zh-TW/images/hatch.jpg new file mode 100644 index 00000000..f89a13d0 Binary files /dev/null and b/zh-TW/images/hatch.jpg differ diff --git a/zh-TW/images/negative.jpg b/zh-TW/images/negative.jpg new file mode 100644 index 00000000..5419fadd Binary files /dev/null and b/zh-TW/images/negative.jpg differ diff --git a/zh-TW/images/none.jpg b/zh-TW/images/none.jpg new file mode 100644 index 00000000..a34fd259 Binary files /dev/null and b/zh-TW/images/none.jpg differ diff --git a/zh-TW/images/oilpaint.jpg b/zh-TW/images/oilpaint.jpg new file mode 100644 index 00000000..7e9a8acf Binary files /dev/null and b/zh-TW/images/oilpaint.jpg differ diff --git a/zh-TW/images/open-terminal-annotated.png b/zh-TW/images/open-terminal-annotated.png new file mode 100644 index 00000000..3e3cbdd3 Binary files /dev/null and b/zh-TW/images/open-terminal-annotated.png differ diff --git a/zh-TW/images/open-terminal.png b/zh-TW/images/open-terminal.png new file mode 100644 index 00000000..ba0b56ba Binary files /dev/null and b/zh-TW/images/open-terminal.png differ diff --git a/zh-TW/images/pastel.jpg b/zh-TW/images/pastel.jpg new file mode 100644 index 00000000..eee15e14 Binary files /dev/null and b/zh-TW/images/pastel.jpg differ diff --git a/zh-TW/images/pi-camera-attached.jpg b/zh-TW/images/pi-camera-attached.jpg new file mode 100644 index 00000000..c23806ef Binary files /dev/null and b/zh-TW/images/pi-camera-attached.jpg differ diff --git a/zh-TW/images/pi-configuration-interfaces-annotated.png b/zh-TW/images/pi-configuration-interfaces-annotated.png new file mode 100644 index 00000000..9e7b29f0 Binary files /dev/null and b/zh-TW/images/pi-configuration-interfaces-annotated.png differ diff --git a/zh-TW/images/pi-configuration-interfaces.png b/zh-TW/images/pi-configuration-interfaces.png new file mode 100644 index 00000000..438b4e67 Binary files /dev/null and b/zh-TW/images/pi-configuration-interfaces.png differ diff --git a/zh-TW/images/pi-configuration-menu.png b/zh-TW/images/pi-configuration-menu.png new file mode 100644 index 00000000..51384c78 Binary files /dev/null and b/zh-TW/images/pi-configuration-menu.png differ diff --git a/zh-TW/images/pi4-camera-port.png b/zh-TW/images/pi4-camera-port.png new file mode 100644 index 00000000..f3048525 Binary files /dev/null and b/zh-TW/images/pi4-camera-port.png differ diff --git a/zh-TW/images/posterise.jpg b/zh-TW/images/posterise.jpg new file mode 100644 index 00000000..0c89ad4c Binary files /dev/null and b/zh-TW/images/posterise.jpg differ diff --git a/zh-TW/images/preview.jpg b/zh-TW/images/preview.jpg new file mode 100644 index 00000000..eeb0b678 Binary files /dev/null and b/zh-TW/images/preview.jpg differ diff --git a/zh-TW/images/raspberry-pi.png b/zh-TW/images/raspberry-pi.png new file mode 100644 index 00000000..5ec0a056 Binary files /dev/null and b/zh-TW/images/raspberry-pi.png differ diff --git a/zh-TW/images/raspistill-help.png b/zh-TW/images/raspistill-help.png new file mode 100644 index 00000000..1bbde178 Binary files /dev/null and b/zh-TW/images/raspistill-help.png differ diff --git a/zh-TW/images/raspistill-image.png b/zh-TW/images/raspistill-image.png new file mode 100644 index 00000000..2f596f5c Binary files /dev/null and b/zh-TW/images/raspistill-image.png differ diff --git a/zh-TW/images/saturation.jpg b/zh-TW/images/saturation.jpg new file mode 100644 index 00000000..f26c0ac9 Binary files /dev/null and b/zh-TW/images/saturation.jpg differ diff --git a/zh-TW/images/sketch.jpg b/zh-TW/images/sketch.jpg new file mode 100644 index 00000000..28ce1889 Binary files /dev/null and b/zh-TW/images/sketch.jpg differ diff --git a/zh-TW/images/solarize.jpg b/zh-TW/images/solarize.jpg new file mode 100644 index 00000000..0ce58dc5 Binary files /dev/null and b/zh-TW/images/solarize.jpg differ diff --git a/zh-TW/images/thonny-app-menu.png b/zh-TW/images/thonny-app-menu.png new file mode 100644 index 00000000..b4e66b6c Binary files /dev/null and b/zh-TW/images/thonny-app-menu.png differ diff --git a/zh-TW/images/washedout.jpg b/zh-TW/images/washedout.jpg new file mode 100644 index 00000000..1159bf26 Binary files /dev/null and b/zh-TW/images/washedout.jpg differ diff --git a/zh-TW/images/watercolor.jpg b/zh-TW/images/watercolor.jpg new file mode 100644 index 00000000..b28e4213 Binary files /dev/null and b/zh-TW/images/watercolor.jpg differ diff --git a/zh-TW/meta.yml b/zh-TW/meta.yml new file mode 100644 index 00000000..e0b771f7 --- /dev/null +++ b/zh-TW/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/zh-TW/step_1.md b/zh-TW/step_1.md new file mode 100644 index 00000000..30c1849e --- /dev/null +++ b/zh-TW/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/zh-TW/step_2.md b/zh-TW/step_2.md new file mode 100644 index 00000000..e8dd639c --- /dev/null +++ b/zh-TW/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/zh-TW/step_3.md b/zh-TW/step_3.md new file mode 100644 index 00000000..03212a50 --- /dev/null +++ b/zh-TW/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/zh-TW/step_4.md b/zh-TW/step_4.md new file mode 100644 index 00000000..a4e375a0 --- /dev/null +++ b/zh-TW/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 Enter 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/zh-TW/step_5.md b/zh-TW/step_5.md new file mode 100644 index 00000000..cde95a05 --- /dev/null +++ b/zh-TW/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`. \ No newline at end of file diff --git a/zh-TW/step_6.md b/zh-TW/step_6.md new file mode 100644 index 00000000..7e9e881a --- /dev/null +++ b/zh-TW/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. \ No newline at end of file diff --git a/zh-TW/step_7.md b/zh-TW/step_7.md new file mode 100644 index 00000000..5583f097 --- /dev/null +++ b/zh-TW/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. + diff --git a/zh-TW/step_8.md b/zh-TW/step_8.md new file mode 100644 index 00000000..d6c00cc5 --- /dev/null +++ b/zh-TW/step_8.md @@ -0,0 +1,228 @@ +## How to change the image settings and add image effects + +The Python `picamera` software provides a number of effects and configurations to change how your images look. + +**Note:** some settings only affect the preview and not the captured image, some affect only the captured image, and many others affect both. + +### Set the image resolution + +You can change the `resolution` of the image that the Camera Module takes. + +By default, the image resolution is set to the resolution of your monitor. The maximum resolution is 2592×1944 for still photos, and 1920×1080 for video recording. + +- Use the following code to set the `resolution` to maximum and take a picture. + + **Note:** you also need to set the frame rate to `15` to enable this maximum resolution. + + ```python + camera.resolution = (2592, 1944) + camera.framerate = 15 + camera.start_preview() + sleep(5) + camera.capture('/home/pi/Desktop/max.jpg') + camera.stop_preview() + ``` + +The minimum resolution is 64×64. + +- Try taking a picture with the minimum resolution. + +### Add text to your image + +You can add text to your image using the command `annotate_text`. + +- Run this code to try it: + + ```python + camera.start_preview() + camera.annotate_text = "Hello world!" + sleep(5) + camera.capture('/home/pi/Desktop/text.jpg') + camera.stop_preview() + ``` + +### Change the look of the added text + +- Set the text size with the following code: + + ```python + camera.annotate_text_size = 50 + ``` + + You can set the text size to anything between `6` to `160`. The default size is `32`. + +It's also possible to change the text colour. + +- First of all, add `Color` to your `import` line at the top of the program: + + ```python + from picamera import PiCamera, Color + ``` + +- Then below the `import` line, amend the rest of your code so it looks like this: + + ```python + camera.start_preview() + camera.annotate_background = Color('blue') + camera.annotate_foreground = Color('yellow') + camera.annotate_text = " Hello world " + sleep(5) + camera.stop_preview() + ``` + +### Change the brightness of the preview + +You can change how bright the preview appears. The default brightness is `50`, and you can set it to any value between `0` and `100`. + +* Run the following code to try this out: + + ```python + camera.start_preview() + camera.brightness = 70 + sleep(5) + camera.capture('/home/pi/Desktop/bright.jpg') + camera.stop_preview() + ``` + +- The following loop adjusts the brightness and also adds text to display the current brightness level: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Brightness: %s" % i + camera.brightness = i + sleep(0.1) + camera.stop_preview() + ``` + +### Change the contrast of the preview + +Similarly to the preview brightness, you can change the contrast of the preview. + +- Run the following code to try this out: + + ```python + camera.start_preview() + for i in range(100): + camera.annotate_text = "Contrast: %s" % i + camera.contrast = i + sleep(0.1) + camera.stop_preview() + ``` + +### Add cool image effects + +You can use `camera.image_effect` to apply a particular image effect. + +The image effect options are: + +* `none` +* `negative` +* `solarize` +* `sketch` +* `denoise` +* `emboss` +* `oilpaint` +* `hatch` +* `gpen` +* `pastel` +* `watercolor` +* `film` +* `blur` +* `saturation` +* `colorswap` +* `washedout` +* `posterise` +* `colorpoint` +* `colorbalance` +* `cartoon` +* `deinterlace1` +* `deinterlace2` + +The default effect is `none`. + +* Pick an image effect and try it out: + + ```python + camera.start_preview() + camera.image_effect = 'colorswap' + sleep(5) + camera.capture('/home/pi/Desktop/colorswap.jpg') + camera.stop_preview() + ``` + +* Run this code to loop over **all** the image effects with `camera.IMAGE_EFFECTS`: + + ```python + camera.start_preview() + for effect in camera.IMAGE_EFFECTS: + camera.image_effect = effect + camera.annotate_text = "Effect: %s" % effect + sleep(5) + camera.stop_preview() + ``` + + ![Effects](images/effects.jpg) + +### Set the image exposure mode + +You can use `camera.exposure_mode` to set the exposure to a particular mode. + +The exposure mode options are: +* `off` +* `auto` +* `night` +* `nightpreview` +* `backlight` +* `spotlight` +* `sports` +* `snow` +* `beach` +* `verylong` +* `fixedfps` +* `antishake` +* `fireworks` + +The default mode is `auto`. + +* Pick an exposure mode and try it out: + + ```python + camera.start_preview() + camera.exposure_mode = 'beach' + sleep(5) + camera.capture('/home/pi/Desktop/beach.jpg') + camera.stop_preview() + ``` + +* You can loop over all the exposure modes with `camera.EXPOSURE_MODES`, like you did for the image effects. + +### Change the image white balance + +You can use `camera.awb_mode` to set the auto white balance to a preset mode. + +The available auto white balance modes are: +* `off` +* `auto` +* `sunlight` +* `cloudy` +* `shade` +* `tungsten` +* `fluorescent` +* `incandescent` +* `flash` +* `horizon` + +The default is `auto`. + +* Pick an auto white balance mode and try it out: + + ```python + camera.start_preview() + camera.awb_mode = 'sunlight' + sleep(5) + camera.capture('/home/pi/Desktop/sunlight.jpg') + camera.stop_preview() + ``` + +* You can loop over all the auto white balance modes with `camera.AWB_MODES`, like you did for the image effects. \ No newline at end of file diff --git a/zh-TW/step_9.md b/zh-TW/step_9.md new file mode 100644 index 00000000..c4f6a88a --- /dev/null +++ b/zh-TW/step_9.md @@ -0,0 +1,17 @@ +## What next? + +Now you know how to use your Camera Module, you could for example: +* Add buttons to control the camera with the help of [GPIO Zero](https://gpiozero.readthedocs.org/) Python code +* Integrate the camera with Minecraft Pi +* Post the camera's pictures to Twitter automatically + +Try these Camera Module projects to learn more: + +- Create a [push button stop-motion](https://projects.raspberrypi.org/en/projects/push-button-stop-motion/) film +- Make a [Minecraft photobooth](https://projects.raspberrypi.org/en/projects/minecraft-photobooth/) +- Get [Babbage bear to tweet pictures](https://projects.raspberrypi.org/en/projects/tweeting-babbage/) +- Build a [parent detector](https://projects.raspberrypi.org/en/projects/parent-detector/) +- Use the NoIR Camera Module to create an [infrared bird box](https://projects.raspberrypi.org/en/projects/infrared-bird-box/) + +For more information about writing Python code to control the Camera Module, see the extensive [picamera documentation](https://picamera.readthedocs.org/). +