PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Image found in a Web Camera control
  • Drawing in browser code
  • Drawing in PHP
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
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
    WINDEVWEBDEV - Server codeReports and QueriesWindowsLinuxiPhone/iPadUser code (UMC) in an Image variable.
    New in version 17
    WINDEVWEBDEV - Server codeReports and QueriesWindowsLinuxiPhone/iPadUser code (UMC) in an Image variable.
    WINDEVWEBDEV - Server codeReports and QueriesWindowsLinuxiPhone/iPadUser code (UMC) in an Image variable.
    in an Image variable.
    WEBDEV - Browser codeWindows MobilePHP This type of variable is not available.
  • in a Bar Code control.
    WEBDEV - Server codeWINDEV MobileLinuxPHP 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.
Notes:
  • 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 modifications performed by ImageInfoModify on the Exif tags of an image.
  • Java 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.
Versions 15 and later
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
New in version 15
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
Versions 16 and later
Android This function is now available for the Android applications.
WEBDEV - Browser code This function is now available in Browser code.
WEBDEV - Browser code In browser code, this function can only be used to save an image in memory.
New in version 16
Android This function is now available for the Android applications.
WEBDEV - Browser code This function is now available in Browser code.
WEBDEV - Browser code In browser code, this function can only be used to save an image in memory.
Android This function is now available for the Android applications.
WEBDEV - Browser code This function is now available in Browser code.
WEBDEV - Browser code In browser code, this function can only be used to save an image in memory.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
// Saves in memory the image found in "IMG_ImageDrawing"
ResSave = dSaveImageJPEG(IMG_ImageDrawing, inMemory)
WINDEVWEBDEV - Server codeReports and QueriesUniversal Windows 10 AppPHPAjaxUser code (UMC)
// Saves the image found in "IMG_ImageDrawing" in "C:\Documents\Image.JPEG"
ResSave = dSaveImageJPEG(IMG_ImageDrawing, "C:\Documents\Image.JPEG")
Windows Mobile
// Saves the image found in "IMG_ImageDrawing" in "\Documents\Image.JPEG"
ResSave = dSaveImageJPEG(IMG_ImageDrawing, "\Documents\Image.JPEG")
WINDEVWEBDEV - Server codeReports and QueriesAjaxUser code (UMC)
// 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
dSaveImageJPEG(IMG_MyImageControl, "C:\Dives\Gorgone1.JPG", 100, imgSaveTag)
Syntax
WINDEVWEBDEV - Server codeReports and QueriesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaPHPAjaxUser code (UMC)

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 find out the error details, use ErrorInfo associated 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.
  • WEBDEV - Server codeWindows Mobile Name of Image control or Web Camera control to use
  • AndroidJava Name of Image control to use.
  • Versions 17 and later
    WINDEVWEBDEV - Server codeWINDEV MobileReports and QueriesiPhone/iPadUser code (UMC) Name of Image variable to use.
    New in version 17
    WINDEVWEBDEV - Server codeWINDEV MobileReports and QueriesiPhone/iPadUser code (UMC) Name of Image variable to use.
    WINDEVWEBDEV - Server codeWINDEV MobileReports and QueriesiPhone/iPadUser code (UMC) Name of Image variable to use.
    Name of Image variable to use.
    WEBDEV - Browser codeWindows MobilePHP 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.
Windows Mobile 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). 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:
imgAddThumbnailAdds 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.
Java This constant is not available.
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).
imgGrayScaleUsed to save the image in black and white ("Grayscale" display mode).
imgSaveTagSaves the Exif tags.
A new thumbnail is calculated if a thumbnail is found in the image file displayed in the Image control.
Java 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.
AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppPHP This parameter is not available.
Universal Windows 10 App 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), ...
WEBDEV - Browser code In browser code, this byte string can only be assigned to another image ("Localize the image in the _WEB directory in browser code" must be unchecked). It cannot be saved in a file to build an image file.
<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.
  • WEBDEV - Server codeWindows Mobile Name of Image control or Web Camera control to use
  • AndroidJava Name of Image control to use.
  • Versions 17 and later
    WINDEVWEBDEV - Server codeWINDEV MobileReports and QueriesiPhone/iPadUser code (UMC) Name of Image variable to use.
    New in version 17
    WINDEVWEBDEV - Server codeWINDEV MobileReports and QueriesiPhone/iPadUser code (UMC) Name of Image variable to use.
    WINDEVWEBDEV - Server codeWINDEV MobileReports and QueriesiPhone/iPadUser code (UMC) Name of Image variable to use.
    Name of Image variable to use.
    WEBDEV - Browser codeWindows MobilePHP 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). 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:
imgAddThumbnailAdds 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.
Java This constant is not available.
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.
A new thumbnail is calculated if a thumbnail is found in the image file displayed in the Image control.
Java 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.
AndroidiPhone/iPadWindows MobilePHP 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.
Versions 16 and later
WEBDEV - Browser code

Drawing in browser code

The image saved in memory can be directly assigned to an Image control. Depending on the browser used, the result may not be the expected one.
For JPEG with the current version of FireFox and Opera (available when this documentation was published), the images in GIF format are not displayed properly (they are displayed on a black background).
This operating mode may be improved during the next upgraded versions of these browsers.
New in version 16
WEBDEV - Browser code

Drawing in browser code

The image saved in memory can be directly assigned to an Image control. Depending on the browser used, the result may not be the expected one.
For JPEG with the current version of FireFox and Opera (available when this documentation was published), the images in GIF format are not displayed properly (they are displayed on a black background).
This operating mode may be improved during the next upgraded versions of these browsers.
WEBDEV - Browser code

Drawing in browser code

The image saved in memory can be directly assigned to an Image control. Depending on the browser used, the result may not be the expected one.
For JPEG with the current version of FireFox and Opera (available when this documentation was published), the images in GIF format are not displayed properly (they are displayed on a black background).
This operating mode may be improved during the next upgraded versions of these browsers.
PHP

Drawing in PHP

In PHP, the drawing functions are based on the graphic library GD. This library is commonly used by the PHP hosting companies and therefore it is always enabled. The version of the GD library must be version 2.0.28 (or later). This library can be downloaded from the PHP site.
To enable (if necessary) this library locally, the following elements are required:
  • PHP installed.
  • the PHP.INI file found in the Windows directory must contain the following line: "extension=php_gd2.dll" (instead of ";extension=php_gd2.dll").
  • the php_gd2.dll file must exist in the directory of PHP extensions. This directory is defined in the PHP.INI file by the "extension_dir" variable.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230pnt.dll
Windows Mobile wp230pnt.dll
WEBDEV - Browser code WDJS.DLL
Java wd230java.jar
Linux wd230pnt.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment