dSaveImageGIF (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions

Image found in a Web Camera control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

dSaveImageGIF (Function)

In french: dSauveImageGIF

Saves an image:

in a GIF file.
in memory.

This image corresponds to the image found:

in an Image control.
in a variable of type Image.
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 reports.

Caution: In Linux, this function requires a specific configuration. For more details, see Drawing in WINDEV, WEBDEV and WINDEV Mobile.

Example

See additional examples

// Sauve en mémoire l'image présente dans "IMG_ImageDessin"
ResSauvegarde = dSaveImageGIF(IMG_ImageDessin, inMemory)

// Sauve l'image présente dans "IMG_ImageDessin" sur "C:\Documents\Image.GIF"
ResSauvegarde = dSaveImageGIF(IMG_ImageDessin, "C:\Documents\Image.GIF")

Syntax

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

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

<Result>: Boolean

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

<Image>: Name of the Image control or variable

Name of the Image, Bar Code or Web Camera control to be used. Image controls in a report cannot be used.
Name of the Image variable to be used.
Name of the Image variable to be used.

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

Saving an image in memory Hide the details

<Result> = dSaveImageGIF(<Image> , <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 of the Image control or variable

Name of the Image, Bar Code or Web Camera control to be saved. Image controls in a report cannot be used.
Name of the Image variable to be used.

<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 executed is saved as a GIF image. To save this image, you can also use:

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

Component: wd300pnt.dll