<Camera>.Capture (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Save in image format
Use conditions:
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Camera>.Capture (Function)

In french: <Caméra>.Capture

Saves the video currently transmitted by a "camera" as an image or a video sequence.

The formats in which the video is saved are:

an image in BMP format or a video sequence in AVI format.
If the file extension is.jpg or.jpeg, the image is saved in JPEG format
an image in JPEG format or a video sequence in ASF format.
an image in JPEG format or a video sequence. The format and quality of captured video depend on the default setting of device and they can differ between the different devices.
an image in JPEG format or a video sequence. The format and quality of captured video depend on the default setting of device and they can differ between the different devices.

Remark: To directly get a photo or a video by using the native video application found on the device, use VideoStartApp.

Versions 16 and later

This function is now available for Android applications.

New in version 16

This function is now available for Android applications.

Versions 21 and later

This function is now available for iPhone/iPad applications.

New in version 21

This function is now available for iPhone/iPad applications.

Example

// Save the video transmitted in the "CAM_Kitchen" control
// in the format of a 1-minute AVI ("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 successfully saved,
False otherwise. To get the details of the error, use ErrorInfo.

<Camera control>: Control name

Name of Camera control to use.

<File to create>: Character string (with quotes)

Name and full (or relative) path of file to create.
If an image is saved, a BMP file is created. If a video sequence is saved, an AVI file is created.
If an image is saved, a JPEG file is created. If a video sequence is saved, an ASF file is created.
Versions 16 and later
If an image is saved, a JPEG file is created. If a video sequence is saved, the format and quality of captured video depend on the default setting of device and they can differ between the different devices..
New in version 16
If an image is saved, a JPEG file is created. If a video sequence is saved, the format and quality of captured video depend on the default setting of device and they can differ between the different devices..
If an image is saved, a JPEG file is created. If a video sequence is saved, the format and quality of captured video depend on the default setting of device and they can differ between the different devices..
Caution: No UNC path can be used.

<Type of capture>: Optional integer constant

Type of capture:
viPictureCapture
Capture an image in the format of a BMP file.

The capture is performed in a JPEG file.

Versions 16 and later
The capture is performed in a JPEG file.
New in version 16
The capture is performed in a JPEG file.
The capture is performed in a JPEG file.
viVideoCapture
(Default value)
Capture a video sequence in the format of an AVI file.

The capture is performed in ASF format.

Versions 16 and later
If a video sequence is saved, the format and quality of captured video depend on the default setting of device and they can differ between the different devices..
New in version 16
If a video sequence is saved, the format and quality of captured video depend on the default setting of device and they can differ between the different devices..
If a video sequence is saved, the format and quality of captured video depend on the default setting of device and they can differ between the different devices..

<Capture duration>: Optional integer

Duration of capture (in seconds). If this parameter is set to 0 or if it is not specified, the capture will stop:
during the call to <Camera>.Stop.
when the specified disk is full.
This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
Versions 23 and later
the duration in text format (e.g., 1 s or 10 ms).
New in version 23
the duration in text format (e.g., 1 s or 10 ms).
the duration in text 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.
This parameter is ignored.

<Display during capture>: Optional boolean

True (by default) if the video currently transmitted must be viewed in the specified Camera control,
False otherwise.
Versions 16 and later
This parameter is ignored. The video saved is always viewed in the Camera control.
New in version 16
This parameter is ignored. The video saved is always viewed in the Camera control.
This parameter is ignored. The video saved is always viewed in the Camera control.

Remarks

Save in image format

Only the image displayed when running <Camera>.Capture will be saved in BMP format. To save this image, you can also use:

the function <Image>.SaveBMP: the image will be saved in BMP format.
<Image>.SaveGIF: the image will be saved in GIF format.
<Image>.SaveJPEG: the image will be saved in JPEG format.

Use conditions:

To use this function, a "web camera" must be connected to the current computer.
This function requires a device that operates in Windows CE version 5.0 (or later) and that is equipped with a camera.
Versions 16 and later
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).
New in version 16
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).
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).
Versions 17 and later
The camera setting can be identified and modified by VideoParameter and VideoListParameter.
New in version 17
The camera setting can be identified and modified by VideoParameter and VideoListParameter.
The camera setting can be identified and modified by VideoParameter and VideoListParameter.

Versions 16 and later

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.

New in version 16

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.

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.

Related Examples:

Unit examples (WINDEV Mobile): The Camera functions

[ + ] Using the WLanguage "Camera" functions to start the native video camera application of the device in order to record a video or to take a photo.

Cross-platform examples (WINDEV Mobile): WM_System

[ + ] This application is an example of some of the features of WINDEV Mobile available for Android/iOS.
The following system functions are used:
- NFC
- Multimedia control
- Brightness
- Volume
- Wi-Fi
- Bluetooth
- Toast
- Compass
- Accelerometer
- Camera control
- LED
- Vibration
- Notifications
- Drawing functions
- Internet

Component: wd260obj.dll