dSaveImageGIF (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Graphic strings management functions

Image found in a Web Camera control

See also

dSaveImageGIF (Function)

In french: dSauveImageGIF

Saves an image:

in a file in GIF format.
in memory.

This image corresponds to the image found:

in an Image control.
in an Image variable.
in a Bar Code control.
in a Web Camera 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.

Versions 17 and later

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

New in version 17

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

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 = dSaveImageGIF(IMG_ImageDrawing, inMemory)

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

Syntax

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

<Result> = dSaveImageGIF(<Image name> , <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 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.
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.

<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.

<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.

Syntax not available

Saving an image in memory Hide the details

<Result> = dSaveImageGIF(<Image name> , <inMemory> [, <Number of colors>])

<Result>: Buffer

Byte string containing the image in GIF 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 the Image control, Bar Code control or Web Camera control to save. The Image controls found in a report cannot be used.
Name of the Image variable 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 dSaveImageGIF is run will be saved in GIF format. To save this image, you can also use:

VideoCapture: the image will be saved in BMP format.
dSaveImageBMP: the image will be saved in BMP format or in memory.
dSaveImageJPEG: the image will be saved in JPEG format or in memory.
dSaveImagePNG: the image will be saved in PNG format or in memory.

Component: wd260pnt.dll