<Image variable>.SavePNG (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Displaying a PNG image
Transparent image in PNG format

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image variable>.SavePNG (Function)

In french: <Variable Image>.SauvePNG

Saves an image found in an Image variable:

in a file in PNG format.
in memory.

Versions 15 and later

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 15

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 WEBDEV sites in Linux.

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

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

MyImage is Image = "Test.gif"
// Saves the image found in MyImage in "C:\Documents\Image.PNG"
ResSave = Mymage.SavePNG("C:\Documents\Image.PNG")

MyImage is Image = "Test.gif"
// Saves the image contained in MyImage in memory
ResSave = MyImage.SavePNG(inMemory)

Syntax

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

<Result> = <Image variable>.SavePNG(<File name> [, <Transparency color>])

<Result>: Boolean

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

<Image variable>: Image variable

Name of an Image variable to use.

<File name>: Character string (with quotes)

Name and full (or relative) path of PNG 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 PNG file is not checked. This file is automatically overwritten if it already exists.

<Transparency color>: Optional integer

Color that will be considered as being transparent in the image. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color of WLanguage.
If this parameter is not specified, the generated image is not transparent.

Syntax not available

Saving an image in memory Hide the details

<Result> = <Image variable>.SavePNG(<inMemory> [, <Transparency color>])

<Result>: Buffer

Byte string containing the image in PNG 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 variable>: Image variable

Name of the Image variable to use.

<inMemory>: Constant

inMemory: Constant used to save an image in memory.

<Transparency color>: Optional integer

Color that will be considered as being transparent in the image. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color of WLanguage.
If this parameter is not specified, the generated image is not transparent.
This parameter is ignored.

Remarks

Displaying a PNG image

Caution: If the image in PNG format is semi-transparent, the display of the image is slower.

Transparent image in PNG format

To save a transparent image in PNG format, the Image control must be filled with the transparent color beforehand.

Example used to draw a transparent line and to save it in PNG format:

MyImage is Image = "Test.gif"
MyImage.StartDrawing(dWithOpacity)
MyImage.ChangeMode(drawDefault)
FOR nI = 0 _À_ MyImage..Width
FOR nJ = 0 _À_ MyImage1..Height
MyImage.DrawPoint(nI, nJ, RGB(255,255,255), 0)
END
END
MyImage.Pen(RGB(100, 020, 200), 0,10, 100)
MyImage.DrawLine(10, 10, 100, 10)
MyImage.SavePNG(CompleteDir(fExeDir()) + "img.png")

Component: wd260pnt.dll