<Image variable>.SaveJPEG (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

New WINDEV, WEBDEV, WINDEV Mobile 24 feature!

Image found in a Web Camera control
Drawing in browser code
Drawing in PHP

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image variable>.SaveJPEG (Function)

In french: <Variable Image>.SauveJPEG

Saves an image found in an Image variable:

in a file in JPEG format.
in memory.

Notes:

This function can only be used to save the images for screen resolutions up to 32 bits.
The backup of images in JPEG format is supported only if the application is run by the Java virtual machine (JVM) distributed by SUN. This backup does not operate with the other Java virtual machines.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

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 file in JPEG format Hide the details

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

<Result>: Boolean

True if the image was saved,
False otherwise. To know the error details, use ErrorInfo associated with errMessage.

<Image variable>: Image variable

Name of Image variable to use.

<File name>: Character string (with quotes)

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 included between 1 and 100 (80 by default). The lower the image quality will be, the higher the compression rate of the image will be and the smaller the file size will be.

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

Saves the Exif tags modified by ImageInfoModify:
imgAddThumbnail Adds a thumbnail into the image file (<File name>).
This constant is ignored if a thumbnail is found in the image file displayed in the Image control.
This constant is not available.
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).
imgGrayScale Used to save the image in black and white ("Grayscale" display mode).
imgSaveTag Saves the Exif tags.
A new thumbnail is calculated if a thumbnail is found in the image file displayed in the Image control.
This constant is not available.
By default, the Exif tags are not saved, no operation is performed on the thumbnails.
This parameter is available only if <Control name> corresponds to the name of an Image control.
This parameter is not available.

Syntax not available

Saving an image in memory Hide the details

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

<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 variable>: Image variable

Name of the Image variable to use.

<Quality>: Optional integer

Quality of the image saved. Value included between 1 and 100 (80 by default). The lower the image quality will be, the higher the compression rate of the image will be and the smaller the file size will be.

<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>).
This constant is ignored if a thumbnail is found in the image file displayed in the Image control.
This constant is not available.
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.
A new thumbnail is calculated if a thumbnail is found in the image file displayed in the Image control.
This constant is not available.
By default, the Exif tags are not saved, no operation is performed on the thumbnails.
This parameter is available only if <Control name> corresponds to the name of an Image control.
This parameter is not available.

Remarks

Image found in a Web Camera control

Only the image displayed when <Image variable>.SaveJPEG is run will be saved. To save this image, you can also use:

the function <Camera>.Capture: the image will be saved in BMP format
the function <Image variable>.SaveBMP: the image will be saved in BMP format or in memory
the function <Image variable>.SaveGIF: the image will be saved in GIF format or in memory
the function <Image variable>.SavePNG: the image will be saved in PNG format or in memory.

Component : wd240pnt.dll