PhotoRunApp (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Mobile specific functions

Album functions

PhotoRunApp

Presentation

Example

Photos saved

Backup directories

See also

PhotoRunApp (Function)

In french: PhotoLanceAppli

Starts the native camera application of the device in order to take a photo.

Example

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

// Starts the application
PhotoRunApp(CB_PhotoRunApp)

INTERNAL PROCEDURE CB_PhotoRunApp(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 photo was saved here: " + sPath)

Syntax

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

<Result> = PhotoRunApp()

<Result>: Character string

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

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

<Result> = PhotoRunApp([<WLanguage procedure>])

<Result>: Character string

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

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called when the photo is saved.
This procedure has the following format:

PROCEDURE <Procedure name> (<Path>)

where <Path> corresponds to the backup path of the image.

Remarks

Photos saved

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

Backup directories

In Android applications:

The photo is stored on the device's SDCard and is automatically added to the album.
From Android 11, the photo is stored in the public image directory on the external storage. This location is returned by the SysDirExternalStorage function with the ssePublicPhoto constant.
For more details on allowed locations from Android 11, see Android 11: Changes in the behavior of applications.
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 VideoGenerateThumbnail.

In iPhone/iPad applications:
By default, the photos are saved in the "Documents" directory of the application.

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.

Business / UI classification: UI Code

Component: wd270android.aar