record

Record video from camera board or ArduCam Multi Camera Adapter Module camera

collapse all in page

Add-On Required: This feature requires the MATLAB Support Package for Raspberry Pi Hardware add-on.

Syntax

record(mycamera,filename,duration)
record(aCamObj,filename,duration)

Description

record(mycamera,filename,duration) records a video from the camera board to a file on the Raspberry Pi® hardware.

record(aCamObj,filename,duration) records a video from the selected camera on ArduCam Multi Camera Adapter Module to a file on the Raspberry Pi hardware.

Note

record is a non-blocking function. Wait for the recording to complete before executing any further statements.

Examples

collapse all

Create a connection from the MATLAB® to the Raspberry Pi board. If you encounter errors after running the above command, try using additional arguments (as listed in raspi) or refer to Troubleshoot Connecting Issues to Raspberry Pi Hardware.

mypi = raspi;

Create a connection, mycamera, from the MATLAB software to the camera board on the Raspberry Pi hardware, and set the image resolution. The connection displays the camera board properties.

mycamera = cameraboard(mypi,"Resolution","1280x720")
mycamera = 

Cameraboard with Properties:

                    Name: Camera Board   
              Resolution: "1280x720"      (View available resolutions)
                 Quality: 10              (1 to 100)
                Rotation: 0               (0 or 180)
          HorizontalFlip: 0              
            VerticalFlip: 0              
               FrameRate: 30              (2 to 90)
               Recording: 0              

   Picture Settings
              Brightness: 50              (0 to 100)
                Contrast: 0               (-100 to 100)
              Saturation: 0               (-100 to 100)
               Sharpness: 0               (-100 to 100)

   Exposure and AWB
            ExposureMode: "normal"        (View available exposure modes)
    ExposureCompensation: 0               (-10 to 10)
                 AWBMode: "indoor"        (View available AWB modes)
            MeteringMode: "average"       (View available metering modes)

   Effects
                     ROI: [0.00 0.00 1.00 1.00] (0.0 to 1.0 [top, left, width, height])

Capture and display a sequence of 10 snapshots on your computer. 

for ii = 1:10
img = snapshot(mycamera);
    imagesc(img)
    drawnow
end

Each of the 10 snapshots is the latest image captured by the camera.

If the image is upside down, change its orientation.

mycamera.Rotation = 180

You can use the same approach to change the values of other cameraboard properties.

Record a 60 second video.

record(mycamera,"myvideo.h264",60)

Stop the recording immediately.

stop(mycamera)

Copy the video from the board to your computer.

getFile(mypi,"myvideo.h264","C:\MATLAB")

Delete the video file from the hardware to free up space.

deleteFile(mypi,"myvideo.h264")

Create a connection from the MATLAB to the Raspberry Pi board. If you encounter errors after running the above command, try using additional arguments (as listed in raspi) or refer to Troubleshoot Connecting Issues to Raspberry Pi Hardware.

mypi = raspi;

Create a connection from MATLAB to the ArduCam module attached to the Raspberry Pi board. Set the image resolution. The connection displays the ArduCam properties.

aCamObj = arducam(mypi,"MultiCamAdapter","Resolution","1280x720")
aCamObj = 

ArduCam with Properties:

              ModuleName: "Multi Camera Adapter"  
          SelectedCamera: "Camera A" 
              Resolution: "1280x720"       (View available resolutions)
               Recording: 0

Record a 10-second video.

record(aCamObj,"myvideocamA.h264",10);
while(aCamObj.Recording)
% Wait for the recording to complete
end

Select "Camera B" and record for 10 seconds.

selectCamera(aCamObj,"Camera B");
record(aCamObj,"myvideocamB.h264",10);
while(aCamObj.Recording)
% Wait for the recording to complete
end

Select "Camera C" and record for 10 seconds.

selectCamera(aCamObj,"Camera C");
record(aCamObj,"myvideocamC.h264",10);
while(aCamObj.Recording)
% Wait for the recording to complete
end

Select "Camera D" and record for 10 seconds.

selectCamera(aCamObj,"Camera D");
record(aCamObj,"myvideocamD.h264",10);

Stop the recording.

stop(aCamObj)

Copy the videos recorded from all four cameras to your computer.

getFile(mypi,"myvideocamA.h264","C:\MATLAB");
getFile(mypi,"myvideocamB.h264","C:\MATLAB");
getFile(mypi,"myvideocamC.h264","C:\MATLAB");
getFile(mypi,"myvideocamD.h264","C:\MATLAB");

Delete all the video files from the hardware to free up space.

deleteFile(mypi,"myvideocamA.h264");
deleteFile(mypi,"myvideocamB.h264");
deleteFile(mypi,"myvideocamC.h264");
deleteFile(mypi,"myvideocamD.h264");

Input Arguments

collapse all

Connection to camera board on the Raspberry Pi hardware, specified as a cameraboard object.

Example: mycamera

Connection to a camera on the ArduCam Multi Camera Adapter Module, specified as an arducam object.

Example: aCamObj

Video file name, specified as a string. The only file extension supported is .h264. The recorded video by default gets stored in these locations:

  • For MATLAB Online™ - /home/matlabrpi.

  • For installed MATLAB - /home/rpi.

Note

You can also provide the exact location where you want to save the video. For example, setting the filename to "/home/pi/Documents/myvideo.h264" will save the video in the folder "/home/pi/Documents".

Example: "myvideo.h264"

Data Types: char

Duration of recording, specified in seconds.

Example:

Data Types: double

Extended Capabilities

expand all

See Also

| | | | | | |

Topics

External Websites