ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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.
Linux Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.
Example
MyImage is Image = "Test.gif"
// Saves the image contained in MyImage in memory
ResSave = MyImage.SaveJPEG(inMemory)
WEBDEV - Server codeAjax
MyImage is Image = "Test.gif"
// Saves the image found in MyImage in "C:\Documents\Image.JPEG"
ResSave = MyImage.SaveJPEG("C:\Documents\Image.JPEG")
Syntax
WEBDEV - Server codeAjax

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:
imgAddThumbnailAdds 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.
imgGrayScaleUsed to save the image in black and white ("Grayscale" display mode).
imgProgressiveJPEGUsed 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).
imgSaveTagSaves 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: wd290pnt.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help