<Camera>.Capture (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Save as image
Use conditions:

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 video save formats 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

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 the Camera control to be used.

<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.
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.

viVideoCapture
(Default value)
Capture a video sequence in the format of an AVI file.

<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 a readable format (e.g., 1 s or 10 ms).
New in version 23
the duration in a readable format (e.g., 1 s or 10 ms).
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 currently transmitted must be viewed in the specified Camera control,
False otherwise.

Remarks

Save as image

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

dSaveImageBMP: the image will be saved in BMP format.
dSaveImageGIF: the image will be saved in GIF format.
dSaveImageJPEG: the image will be saved in JPEG format.

Use conditions:

To use this function, a "web camera" must be connected to the current computer.

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: wd270obj.dll