CameraCapture (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Camera functions

Saving a photo
Use conditions:
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CameraCapture (Function)

In french: CameraCapture

Captures the images received from the camera:

as an image: take a photo.
as a video: record a video.

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

BMP images or AVI videos.
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.

Remarks:

To capture a photo or video using the device's native camera application, use CameraRunApp.
This function is equivalent to VideoCapture.

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

Example

// Enregistre la vidéo retransmise dans le champ Caméra "CAM_Cuisine"
// sous forme d'une AVI ("C:\Temp\MaVideo.AVI") de 1 minute
ResSauvegarde = CameraCapture(CAM_Cuisine, "C:\Temp\MaVideo.AVI", viVideoCapture, 60)
IF ResSauvegarde = True THEN
	Info("Vidéo correctement sauvegardée")
ELSE
	Error(ErrorInfo())
END

Syntax

<Result> = CameraCapture(<Camera control> , <Name of created file> [, <Type of capture> [, <Capture duration> [, <Images per second> [, <Preview stream>]]]])

<Result>: Boolean

True if the video has been saved correctly,
False otherwise. To get more details on the error, use ErrorInfo.

<Camera control>: Control name

Name of the Camera control to be used. There is no need to display the video in a Camera control to save it.

<Name of created file>: 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.
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.
Warning It is not possible to use a UNC path.

<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 or optional duration

Length of the video recording (in seconds). If this parameter is set to 0 or is not specified, the video recording will stop:
when VideoStop is called.
when there is no more space on the disk.
Note: This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
the duration in a readable format ('1 s' for example).

<Images per second>: Optional integer

Number of 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.
This parameter is ignored. The preview stream is always displayed in the Camera control.

Remarks

Saving a photo

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

function dSaveImageBMP: the photo will be saved in BMP format.
the dSaveImageGIF function: the photo will be saved in Gif format.
the dSaveImageJPEG function: the photo 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 equipped with a camera. It can also be used in the Android emulator (only to capture images)
To get and set the camera settings, use VideoParameter and VideoListParameter.

Required permissions

This function changes the permissions required by the application.

Required permissions:

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

Component: wd300obj.dll