ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
  • Image found in a Web Camera control
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:
  • in a JPEG file.
  • in memory.
This image corresponds to the image contained in a Image control.
Remarks:
  • Only the visible part of the Image control is saved.
  • This function can only be used to save the images for screen resolutions up to 32 bits.
  • This function cannot be used with the Image controls found in the reports.
  • This function can also be used to save the changes made by ImageInfoModify on the Exif tags of an image.
Example
// Saves in memory the image found in "IMG_ImageDrawing"
ResSave = IMG_ImageDrawing.SaveJPEG(inMemory)
Reports and Queries
// Saves the image found in "IMG_ImageDrawing" in "C:\Documents\Image.JPEG"
ResSave = IMG_ImageDrawing.SaveJPEG("C:\Documents\Image.JPEG")
Reports and Queries
// Modify the comments of the image
// displayed in the "IMG_MyImageControl" control
ImageInfoModify(IMG_MyImageControl, imgComment, "Coral Reef")
// Save the modification in the
// "C:\Diving\Coral.JPG" file
IMG_MyImageControl.SaveJPEG("C:\Dives\Gorgone1.JPG", 100, imgSaveTag)
Syntax
Reports and Queries

Saving an image in a JPEG file Hide the details

<Result> = <Image control>.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 control>: Control name
  • Name of the Image, Bar Code or Web Camera control to be used. Image controls in a report cannot 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 control>.SaveJPEG(<inMemory> [, <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 control>: Control name
  • Name of the Image, Bar Code or Web Camera control to be used. Image controls in a report cannot 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.
<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.
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.
This parameter is available only if <Control name> corresponds to the name of an Image control.
Remarks

Image found in a Web Camera control

Only the image displayed when <Image>.SaveJPEG is executed is saved. To save this image, you can also use:
  • the <Camera>.Capture function: the image will be saved as a BMP file
  • the <Image>.SaveBMP function: the image will be saved in BMP format or in memory
  • the <Image>.SaveGIF function: the image will be saved in GIF format or in memory
  • the <Image>.SavePNG function: the image will be saved in PNG format or in memory.
Component: wd290pnt.dll
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/15/2024

Send a report | Local help