grDestinationBMP (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Chart management functions

BMP file as destination

Creating and drawing a chart by programming

Differences between grDestinationBMP and grSaveBMP

Related examples

See also

ComparativePositionSeries

gr3DSParameter

grAddData

grAddTimeData

grAutoRefreshCategoryLabel

grComparativeSeriesPosition

grDonutHolePercentage

grScatter3DAltitudeColor

grScatter3DDeleteAltitudeColor

grScatter3DDeleteMarkCaption

grScatter3DGridlines

grScatter3DLinkPoint

grScatter3DMarkCaption

grScatter3DProjection

grSeriesSecondaryAxis

grSeriesType

grSmoothing

grSourceCategoryLabel

grSunburstRootSection

grSunburstSectionColor

grSunburstStartAngle

grSurfaceAddData

grSurfaceAltitudeColor

grSurfaceDeleteAltitudeColor

grSurfaceDeleteMarkCaption

grSurfaceGetData

grSurfaceGridlines

grSurfaceMarksCaption

grWaterfallCategoryType

grWaterfallColor

grWndSize

grZoom

BMP file as destination
Creating and drawing a chart by programming
Differences between grDestinationBMP and grSaveBMP

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

grDestinationBMP (Function)

In french: grDestinationBMP

Defines a BitMap file as destination of a chart (BMP means BitMap). This file will be created during the next chart drawing (grDraw).

Remarks:

This function cannot be used with the Chart controls.
This function cannot be used in the report editor.
This function cannot be used to draw a cylinder chart in 3D.

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

// Define the "C:\Charts\Chart.BMP" file
// as destination of "MyChart"
grDestinationBMP("MyChart", "C:\Charts\Chart.BMP")

Syntax

grDestinationBMP(<Chart name> , <Name of BMP file>)

<Chart name>: Character string (with quotes)

Name of chart to use, defined by grCreate.

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

Name of the BMP file where the chart will be saved. This file is created during the call to grDraw.

Remarks

BMP file as destination

During the next call to grDraw, the chart will be drawn in the <Name of BMP file> file.
This file can be read by a tool that recognizes the BMP format.
The size of this file can be defined by grWndSize.
We recommend that you preview the chart before it is saved in a file.

Creating and drawing a chart by programming

To draw a chart:

create the chart (grCreate),
add data (grAddData, grStockAddData and grScatterAddDataXY),
define the chart destination with the following functions:
- grDestinationBMP,
- grDestinationControl,
- grDestinationEMF,
- grDestinationWnd,
- Versions 19 and later
  grDestinationImage,
  New in version 19
  grDestinationImage,
  grDestinationImage,
- grDestinationWMF.
Only grDestinationBMP and grDestinationControl are available.
draw the chart (grDraw).

Differences between grDestinationBMP and grSaveBMP

grDestinationBMP is used to define the destination of next chart drawing. 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 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 (WEBDEV): The Chart functions

[ + ] This example presents the main features of the chart designer of WEBDEV and it allows you to:
- Create a chart: Pie, Column or Line
- Define the display area of a chart
- Define the options of the chart (legend, percentage, ...)

Component: wd260grf.dll