<Image variable>.SaveJPEG (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Prefix syntax

Drawing functions on Image variables

SaveJPEG

Presentation

Example

See also

<Image variable>.SaveJPEG (Function)

In french: <Variable Image>.SauveJPEG

Saves an image contained in a variable of type Image:

in a JPEG file.
in memory.

Remarks:

This function can only be used to save the images for screen resolutions up to 32 bits.

Example

MyImage is Image = "Test.gif"
// Saves the image contained in MyImage in memory
ResSave = MyImage.SaveJPEG(inMemory)

MyImage is Image = "Test.gif"
// Saves the image found in MyImage in "C:\Documents\Image.JPEG"
ResSave = MyImage.SaveJPEG("C:\Documents\Image.JPEG")

Syntax

Saving an image in a JPEG file Hide the details

<Result> = <Image name>.SaveJPEG(<File name> [, <Quality> [, <Exif tag>]])

<Result>: Boolean

True if the image was saved,
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<Image name>: Image variable

Name of the Image variable to be used.

<File name>: Character string

Name and full (or relative) path of JPEG file. A UNC path can be used. The file extension is optional.
Caution:
The destination directory must exist in order for the image to be saved.
The existence of the JPEG file is not checked. This file is automatically overwritten if it already exists.

<Quality>: Optional integer

Quality of the image saved. Value between 1 and 100 (80 by default). Lower image quality translates into higher image compression rate and smaller file size.

<Exif tag>: Optional constant (or combination of constants)

Save the Exif tags modified by ImageInfoModify:
imgAddThumbnail Adds a thumbnail into the image file (<File name>).
If there is a thumbnail in the image file displayed in the Image control, this constant is not taken into account.
imgGrayScale Used to save the image in black and white ("Grayscale" display mode).
imgProgressiveJPEG Used to save the image in progressive JPEG format. This format is mainly used for the Web sites. It allows the pages to be loaded faster (the images being loaded and displayed progressively).
imgSaveTag Saves the Exif tags.
If there is a thumbnail in the image file displayed in the Image control, a new thumbnail is recalculated.

By default, the Exif tags are not saved, no operation is performed on the thumbnails.

Saving an image in memory Hide the details

<Result> = <Image name>.SaveJPEG(<inMemory> [, <Quality>])

<Result>: Buffer

Byte string containing the image in JPEG format.
Then this byte string can be assigned to an Image control, saved in a file (fSaveText), sent via a network (with the Socket functions), ...

<Image name>: Image variable

Name of the Image variable to be used.

<inMemory>: Constant

inMemory: Constant used to save an image in memory.

<Quality>: Optional integer

Quality of the image saved. Value between 1 and 100 (80 by default). Lower image quality translates into higher image compression rate and smaller file size.

Component: wd280pnt.dll