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

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

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

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.

Component: wd270obj.dll