CameraRunApp (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Camera functions

Prefix syntax

WLanguage procedure

CameraRunApp

Presentation

Example

Photos and videos saved

Backup directories

Required application feature

See also

CameraRunApp (Function)

In french: CaméraLanceAppli

Starts the device's native camera application to record a video or to take a photo.

Remarks:

Remark: Syntax 2, which uses a non-locking call, is recommended, especially from iOS 8.
CameraRunApp must be executed in a thread.
In a WINDEV application, CameraCapture can be used to record a video or to take a photo with the camera of the device.
This function is equivalent to VideoStartApp.

Example

sPhoto is string
sPhoto = CameraRunApp(viPictureCapture)
IF sPhoto <> "" THEN
Info("Photo saved in the file " + sPhoto)
END

nRecordingType is int

// Let the user choose the type of capture
FI Dialog("Do you want to take a photo or record a video?", ["A photo", ...
"A video"], 1, 2, dlgIconQuestion) = 1 THEN
nRecordingType = viPictureCapture
ELSE
nRecordingType = viVideoCapture
END

// Starts the application
CameraRunApp(nRecordingType, CameraRunApp_Callback)

INTERNAL PROCEDURE CameraRunApp_Callback(sPath is string)

// If the return is an empty string vide (""), an error occurred
IF sPath ~= "" THEN
Error(ErrorInfo())
RETURN
END

// Message for end of recording
Info("The file was saved here: " + sPath)
END

Syntax

Starting the native camera application (locking call) Hide the details

<Result> = CameraRunApp([<Type of capture>])

<Result>: Character string

Full path of file where the photo or the video was saved,
Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo.

<Type of capture>: Optional integer constant

Type of capture:
viPictureCapture Saving a photo.
viVideoCapture
(Default value) Capture a video sequence.

Starting the native camera application (non-locking call) Hide the details

<Result> = CameraRunApp([<Type of capture> [, <WLanguage procedure>]])

<Result>: Boolean

True if the photo or video was saved.
False otherwise. To get more details on the error, use ErrorInfo.

<Type of capture>: Optional integer constant

Type of capture:
viPictureCapture Saving a photo.
viVideoCapture
(Default value) Capture a video sequence.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called when the photo or video is recorded.
For more details on this procedure, see Parameters of the procedure used by CameraRunApp.

Remarks

Photos and videos saved

The photo and video settings (format, resolution, size) are the ones defined in the native camera application.

To display the photo in an Image control, open the Image control description, go to the "Details" tab and check "Orientate according to the image's Exif data".

Backup directories

In Android applications, the photo or video is stored on the SD Card of the device and is automatically added to the album.
If photos must be used in your Android applications, we advise you to work with thumbnails and not with the initial photos taken by the device. To generate the thumbnails, use CameraGenerateThumbnail.

In iPhone/iPad applications:
By default:

the photos are saved in the "Documents" directory of application.
the videos are saved in the "tmp" directory of application.

For the images, you can also:

store the binary content of the image in a database, via a Memo item.
add the photo to the photo album of the device with AlbumSave. In this case, the image can be re-used via AlbumPicker.

In the applications in Windows Store apps mode, the photos and the videos are saved in the "TempState" directory of the application.

Required application feature

The use of this function triggers the declaration of several application features in the application generation wizard.

Required features:

Microphone: This feature allows the applications to perform audio recordings.
WebCam: This feature allows the applications to capture videos or photos.

Business / UI classification: UI Code

Component: wd270android.aar