Correo: [email protected] - Teléfono: +56979962128

Esta guía es una introducción a la  biblioteca

Picamera2

para la placa Raspberry Pi. muestra cómo instalar

Picamera2

, tomar fotos y grabar video en un archivo .

file mp4

. Esta guía es compatible con la cámara Raspberry Pi V2 y V3. 

Setup Python Picamera2 on a Raspberry Pi Take Photos and Capture Video
 

Tabla de contenidos

  En esta guía te enseñaremos a:  

Prerrequisitos 

Antes de continuar, asegúrate de comprobar lo siguiente:

  1. Necesitas una placa Raspberry Pi y una cámara Raspberry Pi 
  2. Debe tener una Raspberry Pi con el sistema operativo Raspberry Pi (32 bits o 64 bits). 
  3. Deberías poder establecer una conexión SSH con tu Raspberry Pi. 
 

Librería de Python Picamera2 

Picamera2

 es una librería de Python para interactuar con la cámara de Raspberry Pi. Se basa en la arquitectura de cámaras  

libcamera

 y la mantiene la fundación Raspberry Pi. No es recomendable usar la antigua librería Picamera

 con las últimas versiones del sistema operativo Raspberry Pi.

La librería de Picamera2 es compatible con todos los modelos de Raspberry Pi, desde Pi Zero hasta RPi 5.

Una vez establecida una conexión SSH con tu Raspberry Pi, actualiza y mejora tu Raspberry Pi si es que hay actualizaciones disponibles. Ejecuta el siguiente comando:

sudo apt update && sudo apt upgrade -y

Ejecute el siguiente comando para instalar la librería Picamera2

en tu Raspberry Pi.

sudo apt install -y python3-picamera2

Se recomienda encarecidamente instalar y actualizar

Picamera2

utilizando el comando apt

descrito anteriormente para evitar problemas de compatibilidad. Suelen ocurrir problemas de compilación al intentar instalar la librería

Picamera2

con comando PIP

mediante un entorno virtual.

Preparación de la cámara Raspberry Pi

La cámara Raspberry Pi es un módulo de cámara pequeño y de bajo costo compatible con las placas Raspberry Pi. Si bien puede ser lo suficientemente bueno para la mayoría de los proyectos, también existen otras cámaras USB compatibles con nuestra Raspberry que pueden resultar una gran opción.

 Para esta guía, utilizaremos el módulo Raspberry Pi Camera V2 que se muestra en la siguiente imagen:

Raspberry Pi Camera Module V2

Esta guía también funciona con la Raspberry Pi Camera V3 y la cámara es compatible con todos los modelos de Raspberry Pi.

Habilitar el módulo de cámara Raspberry Pi

Si estas corriendo la ultima versión del OS de Raspberry pi, las cámaras oficiales serán detectadas y activadas automáticamente.

Conectando la cámara

Conectar el módulo de cámara Raspberry Pi es muy sencillo. Con la Pi apagada, conecta la cámara al puerto CSI de la Pi como se muestra en la siguiente figura.

Raspberry Pi 5 Pi Camera Module v2 connected cable
 

Ejemplo de cómo tomar una foto de Picamera2 – Script de Python 

Tomar una foto con la cámara de la Raspberry Pi es sencillo gracias a la

librería Picamera2

Python. Cree un nuevo archivo llamado

take_photo.py

:

nano take_photo.py
Copie

el siguiente código en el archivo recién creado: 

from picamera2 import Picamera2, Preview import time picam2 = Picamera2() camera_config = picam2.create_preview_configuration() picam2.configure(camera_config) picam2.start_preview(Preview.QTGL) picam2.start() time.sleep(2) picam2.capture_file("test_photo.jpg")

Presione

Ctrl+X

para guardar el archivo, escribe Y

 y pulsa ENTER.

 

Script para tomar fotos 

Echemos un vistazo rápido a cómo funciona el código.

Comienza por importar las librerías necesarias.

from picamera2 import Picamera2, Preview

import time
Crea un objeto Picamera2() llamado picam2.
picam2 = Picamera2()
A continuación, genera una configuración de cámara adecuada para la vista previa y configure el sistema de cámara con la configuración anterior.
camera_config = picam2.create_preview_configuration()

picam2.configure(camera_config)
Inicia la ventana de vista previa.
picam2.start_preview(Preview.QTGL)
Finalmente, enciende la cámara, espera dos segundos y toma una foto. Se almacenará con el nombre de archivo test_photo.jpg. 
picam2.start()

time.sleep(2)

picam2.capture_file("test_photo.jpg")
 

Ejecución del script 

Ejecute el script para tomar una foto ejecutando el siguiente comando en el directorio del proyecto:
python take_photo.py
Picamera2 Python Take Photo Command
Toma una foto con la cámara Raspberry Pi y la guarda con el nombre test_photo.jpg. El archivo de imagen se guardará en la misma carpeta que el script de Python. Picamera2 Python take photo folder files Puedes acceder a su escritorio Raspberry Pi de forma remota y abrir el archivo de imagen para echar un vistazo a la imagen. Take Photo Picamera2 Python Example Script

Ejemplo de grabación de video de Picamera2 – Script de Python

El siguiente script de Python también utiliza el paquete PiCamera para capturar vídeo en un archivo .mp4. Crea un nuevo archivo llamado record_video.py:
nano capture_video.py
Copia el siguiente código en el archivo recién creado:
from picamera2 import Picamera2 

 picam2 = Picamera2() 

 picam2.start_and_record_video("test_video.mp4", duration=5) 
Presione Ctrl+X para guardar el archivo, escribe Y y pulsa Enter.

Secuencia de comandos de captura de vídeo

Echemos un vistazo rápido al Script.Comienza por importar las librerías necesarias
from picamera2 import Picamera2
El siguiente comando graba video durante 5 segundos con la cámara Raspberry Pi y lo guarda con el  nombre test_video.mp4. Puede modificar el script para cambiar el nombre del archivo y ampliar la duración de la grabación de vídeo.
picam2.start_and_record_video("test_video.mp4", duration=5)
 

Ejecución del script

Ejecute el script para grabar un video. Puede utilizar el siguiente comando:
python3 capture_video.py
Picamera2 Python Capture Video Command Capturará un video de 5 segundos con la cámara Raspberry Pi y lo guardará con el nombre test_video.mp4. Picamera2 Python capture video folder files Puede acceder a su escritorio Raspberry Pi de forma remota y abrir el archivo de video con el reproductor VLC para verlo. Capture Video Picamera2 Python Example Script
 

Solución de problemas 

  1. Si está utilizando una Raspberry Pi 3 o un dispositivo más antiguo, deberá habilitar Glamor para este script de ejemplo. Para ello, ejecute sudo raspi-config en una ventana de comandos, elija Opciones avanzadas y, a continuación, habilite la aceleración gráfica Glamor. Finalmente, reinicie su dispositivo. 
  1. Si está utilizando una conexión a escritorio remoto, a veces la vista previa de la imagen y la grabación de video se mostrarán borrosas como las capturas de pantalla a continuación. Sin embargo, si descarga los archivos a su PC con Windows o Mac OS habitual, los archivos están bien. 

Finalizando

Esta publicación fue una guía de introducción rápida a la cámara Raspberry Pi con la

librería Picamera2

Python.

Ahora puedes tomar fotos y grabar videos en un archivo. 

Preguntas frecuentes

¿Qué es Picamera2?

Es la biblioteca de Python para manejar la cámara de la Raspberry Pi. Permite tomar fotos y grabar video en archivos mp4, y es compatible con las cámaras Raspberry Pi V2 y V3.

¿Hay que habilitar la cámara en la Raspberry Pi?

Sí. Antes de usarla hay que habilitar el módulo de cámara en la configuración del sistema y conectar físicamente la cámara al conector correspondiente de la placa.

¿Qué cámaras son compatibles con esta guía?

La guía es compatible con la cámara Raspberry Pi V2 y con la V3. Para otros módulos, como la AI Camera, el procedimiento de instalación es distinto.

¿Se puede grabar video con Picamera2?

Sí. Además de tomar fotos, la biblioteca permite grabar video y guardarlo directamente en un archivo mp4 desde código Python.

Aprende esto en un curso

Si prefieres verlo en vivo y con alguien que resuelva tus dudas, estos cursos presenciales de MCI Educación cubren el tema de este tutorial: