grSaveBMP (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing charts

Differences between grDestinationBMP and grSaveBMP

Related examples

See also

grScatter3DDeleteAltitudeColor

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData

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

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

New in version 15

This function is now available for the WEBDEV sites in Linux.

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

This function is now available for the WEBDEV sites in Linux.

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

Versions 16 and later

This function is now available for the WINDEV applications in Linux.

New in version 16

This function is now available for the WINDEV applications in Linux.

Versions 17 and later

This function is now available for the iPhone/iPad applications.

New in version 17

This function is now available for the 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>: Character string (with or without quotes)

Name of chart to use. This name corresponds to:
the chart name defined by programming with grCreate.
the name of Chart control found in the window editor, page editor or report editor.

<Name of BMP file>: Character string (with quotes)

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 using grDraw, the chart will be drawn in the specified file and all the modifications performed since the last chart drawing 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 modifications performed on the chart since the last call to grDraw 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 : wd240grf.dll