Difference between revisions of "Chart2"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Development)
Line 1: Line 1:
 
{{ChartQuickLinks}}
 
{{ChartQuickLinks}}
  
Chart2 is the re-implementation of the [http://graphics.openoffice.org/chart/chart.html charting component] of [[OpenOffice.org]]. It is integrated in OOo 2.3.
+
The Chart module was exchanged completely on the way to OpenOffice.org 2.3 (starting with SRC680_m213).
 +
This is the basis for further enhancements and long awaited features.
  
Charts are used to illustrate data sets e.g. from spreadsheets to get a better understanding of the data. A lot of different two and three dimensional chart types are available to choose from.
+
This page documents ongoing work, implemented and still missing features. It also links to further useful information around the chart.
 
+
This page gathers information about the new chart implementation of OpenOffice.org. It is especially written to help newcomers to the process of developing for the new OOo chart module.
+
 
+
If you would like to participate, if you have comments or questions related to the chart you are welcome on the graphics mailing lists:  [http://graphics.openoffice.org/servlets/ProjectMailingListList (users,dev,features,bugs,cvs)@graphics.openoffice.org]. See also the side-box with some useful Links.
+
  
 
== Helping with the Chart ==
 
== Helping with the Chart ==
Line 30: Line 27:
 
*[http://api.openoffice.org/source/browse/api/offapi/com/sun/star/chart/ Published UNO API (com::sun::star::chart)]
 
*[http://api.openoffice.org/source/browse/api/offapi/com/sun/star/chart/ Published UNO API (com::sun::star::chart)]
 
*[http://graphics.openoffice.org/chart/chart2codestructure.html Rough overview of the code Structure in module chart2]
 
*[http://graphics.openoffice.org/chart/chart2codestructure.html Rough overview of the code Structure in module chart2]
 +
 +
The CVS module for the chart implementation is 'chart2'. It is a submodule of the graphics project. The chart implementation makes heavy use of UNO (Universal Network Objects), thus it would be good to learn about [http://udk.openoffice.org/ UNO] first. The new chart does support a stable UNO API [http://api.openoffice.org/source/browse/api/offapi/com/sun/star/chart/ com::sun::star::chart]  and a new unstable UNO API  [http://api.openoffice.org/source/browse/api/offapi/com/sun/star/chart2/?only_with_tag=MAIN com::sun::star::chart2] which is still under construction. Be aware that the chart2 API is not published and is subject to further changes in future - so don't count on it in scripts or something! For stable work please use the published standard chart API com::sun::star::chart.
 +
 +
If you have questions or comments related to the chart you have several choices:
 +
* Use the forum [http://user.services.openoffice.org/en/forum/viewforum.php?f=34 OOo Community Forum on Charts]
 +
* Use the mailing lists [http://graphics.openoffice.org/servlets/ProjectMailingListList (users,dev,features,bugs,cvs)@graphics.openoffice.org]
 +
* Use the chat [irc://freenode/chart2.openoffice.org #chart2.openoffice.org] on freenode
  
 
To find a concrete task to work on, check the issue queries of open chart bugs and features. Maybe there is something that catches your interest:
 
To find a concrete task to work on, check the issue queries of open chart bugs and features. Maybe there is something that catches your interest:

Revision as of 15:48, 7 July 2008


The Chart module was exchanged completely on the way to OpenOffice.org 2.3 (starting with SRC680_m213). This is the basis for further enhancements and long awaited features.

This page documents ongoing work, implemented and still missing features. It also links to further useful information around the chart.

Helping with the Chart

Example Chart made with OpenOffice.org 2.3 (ods-file see File:ProgrammingLanguages.ods)

Development

If you are new to OpenOffice.org development have a look at the more general pages first:

The file format used for OpenOffice.org is the ODF format.

If you like to help developing the chart, you can find useful information at the following places:

The CVS module for the chart implementation is 'chart2'. It is a submodule of the graphics project. The chart implementation makes heavy use of UNO (Universal Network Objects), thus it would be good to learn about UNO first. The new chart does support a stable UNO API com::sun::star::chart and a new unstable UNO API com::sun::star::chart2 which is still under construction. Be aware that the chart2 API is not published and is subject to further changes in future - so don't count on it in scripts or something! For stable work please use the published standard chart API com::sun::star::chart.

If you have questions or comments related to the chart you have several choices:

To find a concrete task to work on, check the issue queries of open chart bugs and features. Maybe there is something that catches your interest:

Also check the easy-to-dev issue list to see whether there are currently development opportunities for newbies: Easy to develop issues

Roadmap

Task Target Status
Display equations for regression lines OOo 2.4 done
Enable reverse scales on axes OOo 2.4 done
Display bars on different axis next to each other OOo 2.4 done
Number format for data labels OOo 2.4 done
Display both value and percentage as data point label OOo 2.4 done
Allow to display each part of a data label in a separate line OOo 2.4 done
More flexible placement of labels on data points OOo 2.4 done
Better automatic positions for lables on pie segments OOo 2.4 done
Allow removing data point labels with delete key OOo 2.4 done
resolution dependent chart prints and pdf export OOo 2.4 done
Ease editing regression lines (trendlines) OOo 3.0 done
Title for secondary y axis OOo 3.0 done
Clockwise pie chart OOo 3.0 done
Starting angle for pie charts - rotation of pie charts OOo 3.0 done
Select 'Range' for error bars OOo 3.0 done
Plotting of missing values (leave gap,assume zero,continue line) OOo 3.0 (on risk) CWS chart22 in QA
Issues for an Arabic version OOo 3.1 planned
Error Bars for X values OOo 3.x planned
Offer multiple sets of default colors for charts OOo 3.x planned
Templates OOo 3.x planned

Child-workspaces after OOo 2.4

CWS Description Target Based on/integrated into Status
chart26 Bug fixes OOo 2.4.1 and OOo 3.0 OOH680m12 and DEV300m13 Integrated
chart19 Features OOo 3.0 SRC680m248 Integrated
chart20 Features OOo 3.0 DEV300m2 Integrated
chart23 Bug fixes OOo 3.0 DEV300m6 Integrated
chart22 Features OOo 3.0 DEV300m18 Approved by QA
odfversionedexport Bug fixes OOo 3.0 DEV300m17 Integrated
chart25 Bug fixes OOo 3.0 DEV300m18 Integrated
chart28 Bug fixes OOo 2.4.2? OOH680m17 Integrated in DEV300m20
chart27 Bug fixes OOo 3.0 DEV300m23 Integrated
chart29 Bug fixes OOo 3.0 DEV300m23 In development
chart24 Features OOo 3.x DEV300m0 In development

Testing

If you want to help the QA team have a look at the QA contribution page. You can help a lot with identifying new problems or verifying fixed and integrated issues!

Download the latest developer snapshot and give it a try. When you find a bug please check whether someone else already did submit an issue for that problem. The following issue list can help you with the research:

There is also a spreadsheet document containing the open chart issues. It is nice for sorting and filtering, but it is not up-to-date. Have a look at the first line to find out when the query was done.

If the problem is unknown you are welcome to submit a new issue. Thanks a lot for your help!

Other Contributions

For other kinds of contributions like graphics, documentation, translation, marketing take a look at this page.

Chart Features

Chart features per release:

Further feature requests grouped by category:

This list is based primarily on the List of wished enhancements for Charts.

Basic Macro Examples

Technical Articles

Here you can find some technical articles about the chart, that may help for future development.

People

  • Permanent developers
  • Further code contributors
    • Daniel Rentz (Sun Microsystems, Filter)
    • Björn Milcke (Sun Microsystems)
    • Niklas Nebel (Sun Microsystems, Calc Connection)
    • Thomas Lange (Sun Microsystems, Writer Connection)
    • Regina Henschel (splines, online-help, testing)
  • Permanent tester
    • Thomas Klarhöfer (Sun Microsystems)
    • Jörg Sievers (Sun Microsystems, Test-tool automation for chart)

Note: if anybody thinks he is missing on this list or a comment is not complete, please drop me a note or modify this page

Personal tools