PhotoRunApp (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Specific Mobile functions

See also

PhotoRunApp (Function)

In french: PhotoLanceAppli

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

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

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

Versions 21 and later

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

New in version 21

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 the details of the error, use ErrorInfo.

Versions 21 and later

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 the details of 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.

New in version 21

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 the details of 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.

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 the details of 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: wd260android.jar