Acquire Webcam Image

Acquire snapshot from webcam in the Live Editor

Description

The Acquire Webcam Image task enables you to interactively connect to a webcam, set properties based on the live video, and capture images. The task automatically generates MATLAB^® code for your live script. For more information about Live Editor tasks, see Add Interactive Tasks to a Live Script.

To get started with the Acquire Webcam Image task, select the webcam that is connected to your computer. The task gives you controls that help you set webcam resolution values and other properties:

• Image-specific properties — Set the values for webcam brightness, contrast, white balance, and so on.

• Device-specific properties — Set the values of webcam backlight compensation, tilt, zoom, and so on.

The default settings of the image and device properties are based on the selected webcam. When you adjust a property, the task updates the corresponding property and captures an image. You can view the property change in real time in the live video preview.

×

Open the Task

To add the Acquire Webcam Image task to a live script in the MATLAB Editor:

• On the Live Editor tab, select Task > Acquire Webcam Image.

• In a code block in your script, type a relevant keyword, such as camera, webcam, snapshot, preview and so on. Select Acquire Webcam Image from the suggested command completions.

Examples

Related Examples

• Detect and Plot Water Level Change with USB Webcam Live Editor Task
• Add Interactive Tasks to a Live Script

Parameters

Note

The Acquire Webcam Image task supports setting resolution, image, and device properties only onWindows^®.

Webcam — Webcam to acquire snapshot

Choose from the list of available webcams connected to your computer. The image and device properties available in the Acquire Webcam Image task depend on the webcam.

Resolution — Resolution of incoming video stream from webcam

Choose the resolution (width-by-height) to acquire the snapshot. The list of available resolutions depends on the selected webcam. The Acquire Webcam Image task currently supports only the default resolution in MATLAB Online™.

Live preview — Preview incoming video stream from webcam

Select Live preview to view the incoming video stream from the webcam. The width and height of the preview depends on the chosen resolution.

Image Properties

Brightness — Adjust image brightness

Adjust the amount of light in the image.

Contrast — Adjust image contrast

Adjust the difference between the darkest and brightest areas in the image.

Exposure — Adjust image exposure

on (default) | off

Adjust the exposure to adjust the highlight and shadow details in the image. Clear the Auto check box to adjust the setting manually.

Gamma — Adjust image gamma

Adjust the gamma measurement of the image.

Hue — Adjust image hue

Adjust the color tint of the image through the red-yellow-blue spectrum.

Saturation — Adjust image saturation

Adjust the amount of color in the image.

Sharpness — Adjust image sharpness

Adjust the sharpness to adjust image clarity.

White balance — Adjust image white balance

on (default) | off

Adjust the white balance based on lighting conditions. Clear the Auto check box to adjust the setting manually.

Device Properties

Backlight Compensation — Adjust camera backlight compensation

Adjust the backlight compensation to capture images per the environmental conditions.

Focus — Adjust camera focus

Adjust the focus to enhance the image clarity.

Gain — Adjust camera gain

Adjust the gain to brighten the image.

Pan — Adjust camera pan

Adjust the viewing angle of the camera in the horizontal plane.

Roll — Adjust camera roll

Adjust the viewing angle to rotate the image.

Tilt — Adjust camera tilt

Adjust the viewing angle of the camera in the vertical plane.

Zoom — Adjust camera zoom

Adjust the zoom of the camera.

Display results

Show image — View captured image

Select Show image to view the captured image.