AlbumSave (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Mobile specific functions

Album functions

AlbumSave

Presentation

Example

Adding an image to the photo album

Photos found on an external memory

Required application feature

See also

AlbumSave (Function)

In french: AlbumSauve

Saves an image, a photo or a video in the photo album of the mobile device. This image can be re-used by AlbumPicker.

Example

// Save an image found in an image variable
MyImage is Image = "Test.png"
AlbumSave(MyImage)

// Save a photo
IF AlbumSave(VideoStartApp(viPictureCapture)) = False THEN
Info("Image not saved")
END

// Save a video
IF AlbumSave(VideoStartApp(viVideoCapture)) = False THEN
Info("Video not saved")
END

Syntax

Saves an image found in an Image variable Hide the details

<Result> = AlbumSave(<Image>)

<Result>: Boolean

True if the image was successfully saved,
False otherwise.

<Image>: Image variable

Name of the Image variable that corresponds to the image to be added to the album.

Saving an image displayed in an Image or Chart control Hide the details

<Result> = AlbumSave(<Control name>)

<Result>: Boolean

True if the image was successfully saved,
False otherwise.

<Control name>: Character string

Name of the Image control or name of the Chart control containing the image to add into the album.

Saves an image found in a file Hide the details

<Result> = AlbumSave(<Image file name>)

<Result>: Boolean

True if the image was successfully saved,
False otherwise.

<Image file name>: Character string

Full name or relative name of the image or video file that will be added into the album (name of the file returned by VideoStartApp for example).
The videos that can be added to the photo album correspond to files with the following extension: ".mp4", ".mov", ".avi" and ".mpg".

Remarks

Adding an image to the photo album

When adding an image to the photo album, the image is saved in the public image or video directory, then it is referenced in the albums of the device.

The public image directory corresponds to an external memory (SD Card for example). The function will fail if this directory is not available.

Photos found on an external memory

In Android, the images and the videos found on the external memory (SDCard for example) of the device are automatically scanned by the system in order to be added to the albums.

When adding an image found in a file (syntax 3):

if the specified file is found on the external memory, the function will have no effect.
if the file is found in another directory, the file will be copied into the public directory for storing images or videos and referenced in the albums of the device.

Required application feature

When this function is used, an application feature is declared in the application generation wizard.

Required features:

Video library.
Image library.

Component: wd270android.jar