<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

Saving a photo
Use conditions:

WINDEV

WEBDEV

WINDEV Mobile

Others

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.

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

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> [, <Preview stream>]]]])

<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 BMP file is created. When a video is recorded, an AVI file is created
Warning: 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.

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

<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 there is no more space on the disk.
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 frames per second (15 by default). This parameter is taken into account only if <Type of capture> is equal to viVideoCapture.

<Preview stream>: Optional boolean

True (by default) if the video stream must be displayed in the specified Camera control,
False otherwise.

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.

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