grSaveBMP (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Chart management functions

Differences between grDestinationBMP and grSaveBMP

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grRBRotationDirection

grScatter3DAltitudeColor

grScatter3DDeleteAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel (Example)

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData (Example)

grSurfaceAddData

grSurfaceAltitudeColor (Example)

grSurfaceAltitudeColor

grSurfaceDeleteAltitudeColor

grSurfaceDeleteMarkCaption

grSurfaceGetData

grSurfaceGridlines

grSurfaceMarksCaption

grWaterfallCategoryType

grWaterfallColor

grWndSize

grZoom

Saving a chart
Backup in BMP format
Differences between grDestinationBMP and grSaveBMP

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grSaveBMP (Function)

In french: grSauveBMP

Saves a chart that was previously drawn in a file in BMP format.

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. For more details, see The charts.

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. For more details, see The charts.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. For more details, see The charts.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

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.

Example

// Saves the chart named CHART_MyChart in the "C:\Charts\Chart.BMP" file
grSaveBMP(CHART_MyChart, "C:\Charts\Chart.BMP")

Syntax

<Result> = grSaveBMP(<Chart name> , <Name of BMP file>)

<Result>: Boolean

True if the chart was saved,
False otherwise.

<Chart name>: Control name or character string

Name of the chart to be used. This name corresponds to:
the chart name defined through programming with grCreate.
the name of the Chart control in the window, page or report editor.

<Name of BMP file>: Character string

Name and full path of BMP file to create. The file extension is mandatory. This BMP file is created during the call to grSaveBMP. The file is overwritten and re-created if it already existed.

Remarks

Saving a chart

To save a chart, the chart must have been drawn beforehand (grDraw). The modifications performed since the last call to grDraw will be ignored.
The default size of the image is set to 639 x 479. These dimensions are taken into account if the chart was never drawn or if it is not visible.

If the chart was created by grCreate, the dimensions can be specified with grWndSize.

Backup in BMP format

This file can be read by a tool that recognizes the BMP format.
The size of the file is identical to the size of the destination (size of window size, control or file).
We recommend that you preview the chart before it is saved in a file.

Differences between grDestinationBMP and grSaveBMP

grDestinationBMP is used to define the destination for the next drawing of the chart. When grDraw is used, the chart will be drawn in the specified file and all the changes made since the chart was last drawn will be taken into account.
grSaveBMP is used to directly save the chart in a file in BMP format. The image saved corresponds to the chart during the last call to grDraw. The changes made to the chart since grDraw was last called will be ignored.

Related Examples:

Unit examples (WINDEV): The Chart functions

[ + ] Using the main chart designer features of WINDEV:
- Create a Pie, Column or Line chart
- Define the display area of a chart
- Define the chart options (legend, percentage, ...)
- Draw a line on a chart

Component: wd270grf.dll