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

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

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

Name of chart to use, defined by grCreate.

<Name of BMP file>: Character string

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 through 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,
- grDestinationImage,
- grDestinationWMF.
draw the chart (grDraw).

Differences between grDestinationBMP and grSaveBMP

grDestinationBMP is used to define the destination of the next chart drawing. 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 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 (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: wd280grf.dll