PC SOFT

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • 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 GIF format.
  • 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 enables you to save images for screen resolutions up to 32 bits.
  • This function cannot be used with the Image controls found in the reports.
WEBDEV - Browser code In browser code, this function can only be used to save an image in memory.
Versions 16 and later
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
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.
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
WINDEVLinux This function is now available for WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for 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 17
WINDEVLinux This function is now available for WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
WINDEVLinux This function is now available for WINDEV applications in Linux.
WEBDEV - Server codeLinux This function is now available for WEBDEV sites in Linux.
Linux Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.
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.
Example
// Saves in memory the image found in "IMG_ImageDrawing"
ResSave = IMG_ImageDrawing.SaveGIF(inMemory)
WINDEVWEBDEV - Server codeReports and QueriesWindows MobilePHPAjaxUser code (UMC)
// Saves the image found in "IMG_ImageDrawing" in "C:\Documents\Image.GIF"
ResSave = IMG_ImageDrawing.SaveGIF("C:\Documents\Image.GIF")
Windows Mobile
// Saves the image found in "IMG_ImageDrawing" in "\Documents\Image.GIF"
ResSave = IMG_ImageDrawing.SaveGIF("\Documents\Image.GIF")
Syntax
WINDEVWEBDEV - Server codeReports and QueriesWindows MobileUniversal Windows 10 AppPHPAjaxUser code (UMC)

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

<Result> = <Image control>.SaveGIF(<File name> [, <Number of colors>])
<Result>: Boolean
  • True if the image was saved,
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
<Image control>: Control name
Name of Image control to use.
<File name>: Character string
Name and full (or relative) path of GIF 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 GIF file is not checked. This file is automatically overwritten if it already exists.
Windows Mobile Name and full path of GIF file to create. The file extension is optional.
<Number of colors>: Optional integer
Number of colors for the image saved. Value included between 16 and 256 (256 by default). This parameter corresponds to the number of colors proposed in the color palette when using the GIF file.
Universal Windows 10 App Syntax not available

Saving an image in memory Hide the details

<Result> = <Image control>.SaveGIF(<inMemory> [, <Number of colors>])
<Result>: Buffer
Byte string containing the image in GIF format.
This byte string can then be assigned to a Image control, saved in a file (fSaveText function), sent through a network (thanks to 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 control>: Control name
Name of Image control to use.
<inMemory>: Constant
inMemory: Constant used to save an image in memory.
<Number of colors>: Optional integer
Number of colors for the image saved. Value included between 16 and 256 (256 by default). This parameter corresponds to the number of colors proposed in the color palette when using the GIF file.
Remarks

Image found in a Web Camera control

Only the image displayed when <Image>.SaveGIF is run will be saved in GIF format. To save this image, you can also use:
  • the function <Camera>.Capture: the image will be saved in BMP format
  • the function <Image>.SaveBMP: the image will be saved in BMP format or in memory
  • the function <Image>.SaveJPEG: the image will be saved in JPEG format or in memory
  • the function <Image>.SavePNG: 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 example, with the current version of FireFox (available when this documentation was published), the images in GIF format are not displayed properly.
This operating mode may be improved during the next upgraded versions of this browser.
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 example, with the current version of FireFox (available when this documentation was published), the images in GIF format are not displayed properly.
This operating mode may be improved during the next upgraded versions of this browser.
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 example, with the current version of FireFox (available when this documentation was published), the images in GIF format are not displayed properly.
This operating mode may be improved during the next upgraded versions of this browser.
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.
Component : wd250pnt.dll
See also
Minimum version required
  • Version 24
This page is also available for…
Comments
Click [Add] to post a comment