Main Content

snapshot

Acquire single image frame from Android device camera

collapse all in page

Syntax

[img,timestamp] = snapshot(cam,shutterMode);

Description

example

[img,timestamp] = snapshot(cam,shutterMode); acquires a single image and its timestamp from an Android™ mobile device camera cam using the specified shutter option shutterMode. The snapshot function opens a camera preview on the device and returns the current frame in MATLAB® as an RGB image. The resolution of the image is specified by the Resolution property of the camera object cam.

Preview the image using image.

Examples

collapse all

Acquire an image frame using immediate shutter mode from an Android mobile device camera. To complete this example, you must have MATLAB Mobile™ on your Android device and you must be connected to the MathWorks® Cloud. For more information, see Install MATLAB Mobile on Your Device and Sign In to the Cloud.

Start MATLAB Mobile on your Android device.

On the Commands screen of MATLAB Mobile, create a mobiledev object m.

m = mobiledev
m = 
mobiledev with properties:

                   Connected: 1
            AvailableCameras: {'back' 'front'}
                     Logging: 0
            InitialTimestamp: ''

   AccelerationSensorEnabled: 0
AngularVelocitySensorEnabled: 0
       MagneticSensorEnabled: 0
    OrientationSensorEnabled: 0
       PositionSensorEnabled: 0

Supported functions

Create a connection to the 'back' camera of the device.

cam = camera(m,'back')
cam = 
  Camera with properties:

                    Name: 'back'
    AvailableResolutions: {'640x480'  '1280x720'}
              Resolution: '640x480'
               Autofocus: 'on'
                   Flash: 'off'

Acquire a single image and timestamp from the camera. The camera preview opens on your device and immediately captures an image.

[img,t] = snapshot(cam,'immediate');

Display the acquired image in MATLAB Mobile.

image(img)

Acquire an image frame using manual shutter mode from an Android mobile device camera. To complete this example, you must have MATLAB Mobile on your Android device and you must be connected to the MathWorks Cloud. For more information, see Install MATLAB Mobile on Your Device and Sign In to the Cloud.

Start MATLAB Mobile on your Android device.

On the Commands screen of MATLAB Mobile, create a mobiledev object m.

m = mobiledev
m = 
mobiledev with properties:

                   Connected: 1
            AvailableCameras: {'back' 'front'}
                     Logging: 0
            InitialTimestamp: ''

   AccelerationSensorEnabled: 0
AngularVelocitySensorEnabled: 0
       MagneticSensorEnabled: 0
    OrientationSensorEnabled: 0
       PositionSensorEnabled: 0

Supported functions

Create a connection to the 'back' camera of the device.

cam = camera(m,'back')
cam = 
  Camera with properties:

                    Name: 'back'
    AvailableResolutions: {'640x480'  '1280x720'}
              Resolution: '640x480'
               Autofocus: 'on'
                   Flash: 'off'

Acquire a single image and timestamp from the camera using the manual shutter mode. The camera preview opens on your device. You can move your mobile device to capture the desired image in the preview. Press the shutter button on the device to acquire the image.

[img,t] = snapshot(cam,'manual');

Display the acquired image in MATLAB Mobile.

image(img)

Input Arguments

collapse all

Android mobile device camera connection, specified as a camera object.

Shutter mode, specified as 'immediate' or 'manual'.

  • 'immediate' — The specified camera opens on the device and captures an image when you call snapshot.

  • 'manual' — The specified camera opens on the device and captures an image when you tap the shutter button.

Data Types: char | string

Output Arguments

collapse all

RGB image data, returned as an n-by-n-by-3 matrix of values.

Data Types: uint8

Timestamp for image data, returned as a datetime array.

Data Types: datetime

Version History

Introduced in R2019a

See Also

|

Topics