dSaveImageJPEG (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Functions for handling graphic strings

Image found in a Web Camera control

See also

dSaveImageJPEG (Function)

In french: dSauveImageJPEG

Saves an image:

in a file in JPEG format.
in memory.

This image corresponds to the image found:

in an Image control.
Versions 17 and later
in an Image variable.
New in version 17
in an Image variable.
in an Image variable. in an Image variable.
This type of variable is not available.
in a Bar Code control.
The Bar Code controls are not available in this version. Therefore, no image found in a Bar Code control can be saved.
in a Web Camera control.

Remarks:

Only the visible part of 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.

Versions 16 and later

This function is now available for Android applications.

New in version 16

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

See additional examples

// Saves in memory the image found in "IMG_ImageDrawing"
ResSave = dSaveImageJPEG(IMG_ImageDrawing, inMemory)

// Saves the image found in "IMG_ImageDrawing" in "C:\Documents\Image.JPEG"
ResSave = dSaveImageJPEG(IMG_ImageDrawing, "C:\Documents\Image.JPEG")

// Saves the image found in "IMG_ImageDrawing" in "\Documents\Image.JPEG"
ResSave = dSaveImageJPEG(IMG_ImageDrawing, "\Documents\Image.JPEG")

Syntax

Saving an image in a file in JPEG format Hide the details

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

<Result>: Boolean

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

<Image name>: Character string (with or without quotes) or Image variable

Name of Image control, Bar Code control or Web Camera control to use. The Image controls found in a report cannot be used.
Name of Image control or Web Camera control to use
Name of Image control to use.
Versions 17 and later
Name of the Image variable to use.
New in version 17
Name of the Image variable to use.
Name of the Image variable to use. Name of the Image variable to use.
This type of variable is not available.

<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.
Name and full path of JPEG file to create. The file extension is optional.

<Quality>: Optional integer

Quality of the image saved. Value included 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>).
This constant is ignored if a thumbnail is found in the image file displayed in the Image control.
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.
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> = dSaveImageJPEG(<Image name> , <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 name>: Character string (with or without quotes) or Image variable

Name of Image control, Bar Code control or Web Camera control to use. The Image controls found in a report cannot be used.
Name of Image control or Web Camera control to use
Name of Image control to use.
Versions 17 and later
Name of the Image variable to use.
New in version 17
Name of the Image variable to use.
Name of the Image variable to use. Name of the Image variable to use.
This type of variable is not available.

<inMemory>: Constant

inMemory: Constant used to save an image in memory.

<Quality>: Optional integer

Quality of the image saved. Value included 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>).
This constant is ignored if a thumbnail is found in the image file displayed in the Image control.
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.
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 dSaveImageJPEG is run will be saved. To save this image, you can also use:

the function VideoCapture: the image will be saved in BMP format
the function dSaveImageBMP: the image will be saved in BMP format or in memory
the function dSaveImageGIF: the image will be saved in GIF format or in memory
the function dSaveImagePNG: the image will be saved in PNG format or in memory.

Component : wd250pnt.dll