<Camera>.Capture (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Video functions

Prefix syntax

Capture

Presentation

Example

Saving a photo

Use conditions:

Required permissions

See also

<Camera>.Capture (Function)

In french: <Caméra>.Capture

Captures the images received from the camera:

as an image: takes a photo.
as a video: records a video.

Warning
Starting with version 27, this function is deprecated for Android and iOS applications. This function is kept only for Camera controls created with earlier versions and with the "Version-26-compatible mode" option enabled ("General" tab of the control description window).

Depending on the platform, the following photo and video formats are used:

BMP images or AVI videos.
If the file extension is .jpg or .jpeg, the image is saved in JPEG format
JPEG images or videos. The format and quality of the video depend on the default device settings and may differ from one device to another.
JPEG images or videos. The format and quality of the video depend on the default device settings and may differ from one device to another.

Remark: To get a photo or video using the device's native camera application, use VideoStartApp.

Example

// Records the video captured in the "CAM_Kitchen" control
// as a 1-minute AVI file ("C:\Temp\MyVideo.AVI")
ResSave = CAM_Kitchen.Capture("C:\Temp\MyVideo.AVI", viVideoCapture, 60)
IF ResSave = True THEN
Info("Video successfully saved")
ELSE
Error(ErrorInfo())
END

Syntax

<Result> = <Camera control>.Capture(<File to create> [, <Type of capture> [, <Capture duration> [, <Number of images per second> [, <Display during capture>]]]])

<Result>: Boolean

True if the video was recorded successfully,
False otherwise. To get more details on the error, use ErrorInfo.

<Camera control>: Control name

Name of the Camera control to be used.

<File to create>: Character string

Name and full (or relative) path of the file to create.
When a photo is taken, a JPEG file is created. If a video is recorded, the format and quality of the video will depend on the default settings of the device and may differ from one device to another.
When a photo is taken, a BMP file is created. When a video is recorded, an AVI file is created
Caution: No UNC path can be used.

<Type of capture>: Optional integer constant

Type of capture:
viPictureCapture
Captures an image and saves it as a BMP file.

Captures an image and saves it as a JPEG file.
viVideoCapture
(Default value)
Captures a video and saves it as an AVI file.

If a video is recorded, the format and quality of the video will depend on the default settings of the device and may differ from one device to another.

<Capture duration>: Optional integer

Length of the video recording (in seconds). If this parameter is set to 0 or is not specified, the video recording will stop:
when <Camera>.Stop is called.
when the specified disk is full.
This parameter can be:
an integer corresponding to the number of seconds,
a Duration variable,
the duration in a readable format (e.g., 1 s or 10 ms).

<Number of images per second>: Optional integer

Number of images saved per second (15 by default). This parameter is taken into account only if <Type of capture> is equal to viVideoCapture.

<Display during capture>: Optional boolean

True (by default) if the video captured must be shown in the specified Camera control,
False otherwise.
This parameter is ignored. The video saved is always displayed in the Camera control.

Remarks

Saving a photo

Only the image displayed when <Camera>.Capture is executed is saved as a BMP image. To save this image, you can also use:

the <Image>.SaveBMP function: the photo will be saved as a BMP file.
the <Image>.SaveGIF function: the photo will be saved as a GIF file.
the <Image>.SaveJPEG function: the photo will be saved as a JPEG file.

Use conditions:

To use this function, a "web camera" must be connected to the current computer.
This function requires a device equipped with a camera. It can also be used during an execution in the Android emulator (for the capture of images only).
To get and set the camera settings, use VideoParameter and VideoListParameter.

Required permissions

The call to this function modifies the permissions required by the application.

Required permissions:

CAMERA: This permission allows the applications to access the camera.
RECORD_AUDIO: This permission allows the applications to record the sound.

Component: wd270obj.dll