Difference between revisions of "Chart2"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Child-workspaces after OOo 2.4)
Line 23: Line 23:
 
If you like to help developing the chart, you can find useful information at the following places:
 
If you like to help developing the chart, you can find useful information at the following places:
 
*[http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Charts/Charts Chart chapter in the Developers Guide]
 
*[http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Charts/Charts Chart chapter in the Developers Guide]
*[http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts Chart chapter in the BASIC Gevelopers Guide]
+
*[http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts Chart chapter in the BASIC Developers Guide]
 
*[[FAQ about Chart API Compatibility]]
 
*[[FAQ about Chart API Compatibility]]
 
*[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]
 +
*[[Chart2/Open Technical Issue in Chart2|Notes on some technical issues]]
  
 
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.
 
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.
Line 79: Line 80:
 
| Select 'Range' for error bars || 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
+
| Plotting of missing values (leave gap,assume zero,continue line) || OOo 3.1 || done
 
|-
 
|-
| Issues for an Arabic version || OOo 3.1 || planned
+
| RTL Chart (Issues for an Arabic version) || OOo 3.1 || in process
 
|-
 
|-
 
| Placement of axes and axes lables || OOo 3.1 || planned
 
| Placement of axes and axes lables || OOo 3.1 || planned
Line 109: Line 110:
 
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart27&OpenOnly=false&Section=All chart27] || Bug fixes || OOo 3.0 || DEV300m23 || Integrated
 
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart27&OpenOnly=false&Section=All chart27] || Bug fixes || OOo 3.0 || DEV300m23 || Integrated
 
|-
 
|-
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart29&OpenOnly=false&Section=All chart29] || Bug fixes || OOo 3.0 || DEV300m23 || In testing
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart29&OpenOnly=false&Section=All chart29] || Bug fixes || OOo 3.0 || DEV300m27 || Integrated
 
|-
 
|-
 
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=OOH680%2Fchart28&OpenOnly=false&Section=All chart28] || Bug fixes || OOo 2.4.2? || OOH680m17 || Integrated in DEV300m20
 
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=OOH680%2Fchart28&OpenOnly=false&Section=All chart28] || Bug fixes || OOo 2.4.2? || OOH680m17 || Integrated in DEV300m20
 
|-
 
|-
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart22&OpenOnly=false&Section=All chart22] || Features || OOo 3.1 || DEV300m18 || Approved by QA
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart22&OpenOnly=false&Section=All chart22] || Features || OOo 3.1 || DEV300m29 || Integrated
 
|-
 
|-
 
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart30&OpenOnly=false&Section=All calcchartrtl01] || Arabic Issues || OOo 3.1 || DEV300m26 || In development
 
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart30&OpenOnly=false&Section=All calcchartrtl01] || Arabic Issues || OOo 3.1 || DEV300m26 || In development
Line 143: Line 144:
 
For other kinds of contributions like graphics, documentation, translation, marketing take a look at [http://contributing.openoffice.org/index.html this page].
 
For other kinds of contributions like graphics, documentation, translation, marketing take a look at [http://contributing.openoffice.org/index.html this page].
  
== Chart Features ==
+
== Implemented Chart Features ==
  
Chart features per release:
+
* [[Chart2/Features3.0  | Additional Features in OOo 3.0 ]]
* [[Chart2/Features3.0_changed_compared_to_2.0  | Additional Features in OOo 3.0 compared to OOo 2.0 ]]
+
* [[Chart2/Features2.4  | Additional Features in OOo 2.4 ]]
 +
* [[Chart2/Features2.3  | Additional Features in OOo 2.3 ]]
  
Further feature requests grouped by category:
+
== Open Chart Features ==
 
* [[Chart2/ChartTypes      | Chart-Types ]]
 
* [[Chart2/ChartTypes      | Chart-Types ]]
 
* [[Chart2/Legend          | Legend ]]
 
* [[Chart2/Legend          | Legend ]]
Line 158: Line 160:
 
* [[Chart2/ChartAnnotation | Chart annotation ]]
 
* [[Chart2/ChartAnnotation | Chart annotation ]]
 
* [[Chart2/Miscellaneous  | Miscellaneous ]]
 
* [[Chart2/Miscellaneous  | Miscellaneous ]]
 
This list is based primarily on the [http://graphics.openoffice.org/files/documents/12/3278/List_of_whished_enhancements_for_Charts.odt List of wished enhancements for Charts].
 
  
 
== Basic Macro Examples ==
 
== Basic Macro Examples ==
Line 167: Line 167:
 
* [[API/Samples/StarBasic/Impress/Insert_a_Chart | Create Chart in a presentation document ]]
 
* [[API/Samples/StarBasic/Impress/Insert_a_Chart | Create Chart in a presentation document ]]
  
== Technical Articles ==
+
Also have a look at the [http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts BASIC Developers Guide]!
 
+
Here you can find some technical articles about the chart, that may help for future development.
+
 
+
* There still some [[Chart2/Open Technical Issue in Chart2|architectural issues]] left that have to be solved. (article by [[User:bm@openoffice.org|Björn Milcke]])
+
 
+
* [[Extending Chart by external components|Why not implement everything in OOo]] (article by [[User:Discoleo|Leonard Mada]])
+
 
+
== People ==
+
 
+
* Permanent developers
+
** [[User:Iha|Ingrid Halama]] (Sun Microsystems)
+
** Wei Zhao (Redflag CH2000)
+
 
+
* Further code contributors
+
** Daniel Rentz (Sun Microsystems, Filter)
+
** [[User:bm|Björn Milcke]] (Sun Microsystems)
+
** [[User:Nn|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)
+
 
+
* Documentation
+
** [[User:Ufi|Uwe Fischer]] (Sun Microsystems)
+
  
* Other contributors
+
== Contact ==
** [[User:Tonygalmiche|Tony Galmiche]] (feature document, Wiki, testing)
+
** [[User:Pagalmes|Pierre-André Galmes]] (StarXpert, testing, Wiki)
+
** Jörg Wartenberg (specification)
+
** [[User:Discoleo|Leonard Mada]] (Wiki)
+
  
''Note: if anybody thinks he is missing on this list or a comment is not complete, please drop [mailto:bjoern.milcke@sun.com me] a note or modify this page''
+
* Development Contact: [[User:Iha|Ingrid Halama (iha)]]
  
 
[[Category:Chart2]]
 
[[Category:Chart2]]
 
[[Category:Source directories]]
 
[[Category:Source directories]]

Revision as of 16:11, 30 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.1 done
RTL Chart (Issues for an Arabic version) OOo 3.1 in process
Placement of axes and axes lables OOo 3.1 planned
Error Bars for X values OOo 3.x planned
Bubble Charts 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
odfversionedexport Bug fixes OOo 3.0 DEV300m17 Integrated
chart25 Bug fixes OOo 3.0 DEV300m18 Integrated
chart27 Bug fixes OOo 3.0 DEV300m23 Integrated
chart29 Bug fixes OOo 3.0 DEV300m27 Integrated
chart28 Bug fixes OOo 2.4.2? OOH680m17 Integrated in DEV300m20
chart22 Features OOo 3.1 DEV300m29 Integrated
calcchartrtl01 Arabic Issues OOo 3.1 DEV300m26 In development
chart30 3.1 Issues OOo 3.1 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.

Implemented Chart Features

Open Chart Features

Basic Macro Examples

Also have a look at the BASIC Developers Guide!

Contact

Personal tools