You are viewing documentation for an older version. For current documentation - click here.

The entire FusionCharts export process is a multi-step process involving various elements, including:

  • The chart itself - This is the SWF file that you embed in your page to generate the chart. The chart is responsible to take its own snapshot so that further processes can take place.
  • FusionCharts JavaScript class (FusionCharts.js) - The JavaScript class used to embed the chart.
  • FusionCharts Export Handlers (Server-side)- In case of server-side export, these server-side scripts accept and convert the bitmap snapshot of charts into images/PDFs.
  • FusionCharts Export Component (Client-side) - In case of client-side export, FusionCharts Export Component accepts the bitmap snapshot of chart and converts into the required export format. This is present as a Flash 10 SWF file.
  • FusionCharts Export Component JavaScript class (FusionChartsExportComponent.js) - This JavaScript class helps you initiate the FusionCharts Export Component object and to set the JavaScript communication channel between the chart and FusionCharts Export Component. It has additional logic for cross-browser compatibility and error handling.

These elements combined provide an elegant approach that allow you to export FusionCharts as images.

FusionCharts is Flash. So how does it generate an image?

Yes - we agree that FusionCharts is a set of SWF files that take in XML data and render charts. It uses Adobe Flash Player to do the same. Remember that all of this happens in your browser - the SWF is downloaded, XML is downloaded and then parsed and finally rendered as a chart.

So, after the chart has rendered in your browser, you can now invoke the export process of FusionCharts using either context menu of chart, or JavaScript API. This is called the Trigger phase. When you do this, the following processes take place:

  1. First, the chart reads the export process related parameters from the XML data. These parameters help you configure whether to export at client side, or server side. You can also configure cosmetic properties of the Export chart dialog box.
  2. The chart now enters into what is called the Capture Phase. In this phase, the chart takes a bitmap snapshot of itself. It takes a few seconds to do that depending on the size of the chart. During this time, the chart displays a "Capturing data" dialog box, the cosmetics of which are totally customizable.
  3. Once the "Capture Phase" is over, the chart now sends this data to FusionCharts Export handlers, as explained later. This is the start of Process Phase.
  4. The Export handlers accept the data, process it, and finally return an image/PDF based on the choice of user, which marks the end of Process Phase.
  5. In the final phase called Callback phase, the export handler can now invoke callback JavaScript functions to notify you that the export process has completed.

The entire process can be visualized as under:

We wish to lay emphasis on one point again - Whenever a chart needs to export as image/PDF (either server-side or client-side), it first necessarily needs to render itself in browser. Once it has rendered in the browser, you can then invoke the JavaScript API to automatically start the export process, without needing any user action.

While the list looks scary at the first sight, let us assure you that setting up all these things is just a matter of minutes, involving just copying-pasting some files here and there, and configuring your XML for export related parameters. You do NOT need to write any of your own code to handle any of this - we've done the hard work so that you can relish it!

With that assurance, let's first quickly learn the various terminologies associated with FusionCharts Export process for once and for all!