Difference between revisions of "Chart2"

From Apache OpenOffice Wiki
Jump to: navigation, search
 
(49 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{ChartQuickLinks}}
 
{{ChartQuickLinks}}
  
The Chart module was exchanged completely on the way to OpenOffice.org 2.3 (starting with SRC680_m213).
+
The Chart module was exchanged completely on the way to OpenOffice.org 2.3.
 
This is the basis for further enhancements and long awaited features.
 
This is the basis for further enhancements and long awaited features.
  
Line 13: Line 13:
  
 
If you are new to OpenOffice.org development have a look at the more general pages first:
 
If you are new to OpenOffice.org development have a look at the more general pages first:
*[[Main Page#Getting started with OOo development|  Getting started with OOo development]]
+
*[[Documentation/Building_Guide/Getting_the_source|  Getting the source code]]
*[http://contributing.openoffice.org/programming.html Participate in OpenOffice.org Programming]
+
*[[Documentation/Building_Guide/Building_on_Windows| Building on Windows]]
 
*[[Cpp_Coding_Standards|C++ Coding Standards]].
 
*[[Cpp_Coding_Standards|C++ Coding Standards]].
  
 
The file format used for OpenOffice.org is the ODF format.
 
The file format used for OpenOffice.org is the ODF format.
* Currently, [http://www.oasis-open.org/specs/index.php#opendocumentv1.1 ODF 1.1] is in use.
+
* [http://www.oasis-open.org/specs/index.php#opendocumentv1.1 ODF 1.1] is final.
* The upcoming format ODF 1.2 is still in progress (see [http://wiki.oasis-open.org/office/OpenDocument_v1.2_Action_Items open action items]).
+
* The upcoming format ODF 1.2 is still in progress (look for the latest announcements and available documents [http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office here]).
 +
* [[Chart2/Proposals| Proposals]]
  
 
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:
Line 25: Line 26:
 
*[http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts Chart chapter in the BASIC Developers 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/docs/common/ref/com/sun/star/chart/module-ix.html 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]]
 
*[[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 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 published stable UNO API [http://api.openoffice.org/docs/common/ref/com/sun/star/chart/module-ix.html com::sun::star::chart] for external use.
 +
There is also an internal API com::sun::star::chart2. The internal API is not published and is not guaranteed to be stable. It is subject to further changes - so don't count on it in scripts or something! Furthermore several things you can set with the internal API will not be saved by the application. So 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:
+
If you have questions on the chart development please use the mailing list [http://openoffice.org/projects/graphics/lists dev@graphics.openoffice.org].
* 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:
* [http://graphics.openoffice.org/issues/buglist.cgi?issue_type=DEFECT&issue_type=TASK&issue_type=PATCH&issue_status=UNCONFIRMED&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED&email1=&emailtype1=exact&emailassigned_to1=1&email2=&emailtype2=exact&emailreporter2=1&issueidtype=include&issue_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&issue_file_loc=&issue_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anytokens&field0-0-0=component&type0-0-0=equals&value0-0-0=Chart&field0-0-1=short_desc&type0-0-1=substring&value0-0-1=chart&field0-0-2=short_desc&type0-0-2=substring&value0-0-2=diagram&field0-1-0=short_desc&type0-1-0=noop&value0-1-0=&cmdtype=doit&order=Reuse+same+sort+as+last+time&Submit+query=Submit+query Open chart bugs] (defects and tasks)
+
* [http://openoffice.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=STARTED&bug_status=REOPENED&cf_bug_type=DEFECT&cf_bug_type=TASK&cf_bug_type=PATCH&columnlist=short_desc%2Ccf_bug_type&field-1-0-0=bug_status&field0-0-0=product&field0-0-1=short_desc&query_format=advanced&type-1-0-0=anyexact&type0-0-0=equals&type0-0-1=anywordssubstr&value-1-0-0=UNCONFIRMED%2CNEW%2CSTARTED%2CREOPENED%2CRESOLVED%2CVERIFIED&value0-0-0=Chart&value0-0-1=chart%20diagram&order=bugs.bug_id%20desc&query_based_on= Open chart bugs] (defects and tasks)
* [http://graphics.openoffice.org/issues/buglist.cgi?Submit+query=Submit+query&issue_type=ENHANCEMENT&issue_type=FEATURE&component=Chart&issue_status=UNCONFIRMED&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED Requested chart features] (enhancements and features)
+
* [http://openoffice.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=STARTED&bug_status=REOPENED&cf_bug_type=FEATURE&cf_bug_type=ENHANCEMENT&columnlist=votes%2Cshort_desc%2Ccf_bug_type&field-1-0-0=bug_status&field0-0-0=product&field0-0-1=short_desc&query_format=advanced&type-1-0-0=anyexact&type0-0-0=equals&type0-0-1=anywordssubstr&value-1-0-0=UNCONFIRMED%2CNEW%2CSTARTED%2CREOPENED%2CRESOLVED%2CVERIFIED&value0-0-0=Chart&value0-0-1=chart%20diagram&order=bugs.bug_id%20desc&query_based_on= Requested chart features] (enhancements and features)
 
+
=== Roadmap ===
+
 
+
{| class="wikitable"
+
|-
+
! 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 ===
+
 
+
{| class="wikitable"
+
! CWS !! Description !! Target !! Based on/integrated into !! Status
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=OOH680%2Fchart26&OpenOnly=false&Section=All chart26] || Bug fixes || OOo 2.4.1 and OOo 3.0 || OOH680m12 and DEV300m13 || Integrated
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fchart19 chart19] || Features || OOo 3.0 || SRC680m248 || Integrated
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fchart20 chart20] || Features || OOo 3.0 || DEV300m2 || Integrated
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart23&OpenOnly=false&Section=All chart23] || Bug fixes || OOo 3.0 || DEV300m6 || Integrated
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fodfversionedexport&OpenOnly=false&Section=All odfversionedexport] || Bug fixes || OOo 3.0 || DEV300m17 || Integrated
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart25&OpenOnly=false&Section=All chart25] || Bug fixes || OOo 3.0 || DEV300m18 || 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 || 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=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 chart30] || 3.1 Issues || OOo 3.1 || DEV300m23 || In development
+
|-
+
| [http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=DEV300%2Fchart24&OpenOnly=false&Section=All chart24] || Features || OOo 3.x || DEV300m0 || In development
+
|}
+
  
 
=== Testing ===
 
=== Testing ===
  
If you want to help the QA team have a look at the [http://contributing.openoffice.org/qa.html QA contribution page].
 
 
You can help a lot with identifying new problems or verifying fixed and integrated issues!
 
You can help a lot with identifying new problems or verifying fixed and integrated issues!
  
[http://download.openoffice.org/680/index.html 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:
+
[http://download.openoffice.org/next/ Download] the latest developer build 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:
  
* [http://graphics.openoffice.org/issues/buglist.cgi?issue_type=DEFECT&issue_type=TASK&issue_type=PATCH&issue_status=UNCONFIRMED&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED&email1=&emailtype1=exact&emailassigned_to1=1&email2=&emailtype2=exact&emailreporter2=1&issueidtype=include&issue_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&issue_file_loc=&issue_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anytokens&field0-0-0=component&type0-0-0=equals&value0-0-0=Chart&field0-0-1=short_desc&type0-0-1=substring&value0-0-1=chart&field0-0-2=short_desc&type0-0-2=substring&value0-0-2=diagram&field0-1-0=short_desc&type0-1-0=noop&value0-1-0=&cmdtype=doit&order=Reuse+same+sort+as+last+time&Submit+query=Submit+query Open chart bugs].
+
* [http://openoffice.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=STARTED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&columnlist=votes%2Cshort_desc%2Ccf_bug_type&field-1-0-0=bug_status&field0-0-0=product&field0-0-1=short_desc&query_format=advanced&type-1-0-0=anyexact&type0-0-0=equals&type0-0-1=anywordssubstr&value-1-0-0=UNCONFIRMED%2CNEW%2CSTARTED%2CREOPENED%2CRESOLVED%2CVERIFIED&value0-0-0=Chart&value0-0-1=chart%20diagram&order=bugs.bug_id%20desc&query_based_on= Open chart issues].
* [http://graphics.openoffice.org/issues/buglist.cgi?issue_type=DEFECT&issue_type=ENHANCEMENT&issue_type=FEATURE&issue_type=TASK&issue_type=PATCH&component=Chart&issue_status=RESOLVED&resolution=FIXED Fixed issues] that have not been verified or closed yet
+
* Or create your [http://openoffice.org/bugzilla/query.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=STARTED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&field-1-0-0=bug_status&field0-0-0=product&field0-0-1=short_desc&query_format=advanced&type-1-0-0=anyexact&type0-0-0=equals&type0-0-1=anywordssubstr&value-1-0-0=UNCONFIRMED%2CNEW%2CSTARTED%2CREOPENED%2CRESOLVED%2CVERIFIED&value0-0-0=Chart&value0-0-1=chart%20diagram own query].
* [http://graphics.openoffice.org/issues/buglist.cgi?Submit+query=Submit+query&issue_type=DEFECT&issue_type=ENHANCEMENT&issue_type=FEATURE&issue_type=TASK&issue_type=PATCH&component=Chart&issue_status=VERIFIED Verified issues] that have not been closed yet (checked in the master)
+
* Or create your [http://graphics.openoffice.org/issues/query.cgi own query].
+
  
If the problem is unknown you are welcome to [http://qa.openoffice.org/issue_handling/pre_submission.html submit a new issue].
+
If the problem is unknown you are welcome to [http://openoffice.org/bugzilla/enter_bug.cgi?product=Chart&component=ui&rep_platform=All&op_sys=All&cc=iha@openoffice.org submit a new issue]. Please describe only one problem per issue.
 
Thanks a lot for your help!
 
Thanks a lot for your help!
 
=== Other Contributions ===
 
 
For other kinds of contributions like graphics, documentation, translation, marketing take a look at [http://contributing.openoffice.org/index.html this page].
 
  
 
== Implemented Chart Features ==
 
== Implemented Chart Features ==
  
 +
* [[Chart2/Features3.3  | Additional Features in OOo 3.3 ]]
 +
* [[Chart2/Features3.2  | Additional Features in OOo 3.2 ]]
 +
* [[Chart2/Features3.1  | Additional Features in OOo 3.1 ]]
 
* [[Chart2/Features3.0  | Additional Features in OOo 3.0 ]]
 
* [[Chart2/Features3.0  | Additional Features in OOo 3.0 ]]
 
* [[Chart2/Features2.4  | Additional Features in OOo 2.4 ]]
 
* [[Chart2/Features2.4  | Additional Features in OOo 2.4 ]]
Line 158: Line 74:
  
 
* [[Chart2/ChangeTitleFormattingForAllChartsInACalc | Change title formatting for all charts in a spreadsheet ]]
 
* [[Chart2/ChangeTitleFormattingForAllChartsInACalc | Change title formatting for all charts in a spreadsheet ]]
 +
 +
* [[Chart2/GetPositionOfAChart | Get the position of a chart within a spreadsheet ]]
  
 
* [[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 ]]
 +
 +
* [http://www.ooowiki.de/DiagrammExport Export Charts from a Calc spreadsheet ]
  
 
Also have a look at the [http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts BASIC Developers Guide]!
 
Also have a look at the [http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts BASIC Developers Guide]!
Line 165: Line 85:
 
== Contact ==
 
== Contact ==
  
* Development Contact: [[User:Iha|Ingrid Halama (iha)]]
+
* Development Contact: [[User:Iha|iha]]
  
 
[[Category:Chart2]]
 
[[Category:Chart2]]
 
[[Category:Source directories]]
 
[[Category:Source directories]]

Latest revision as of 16:28, 6 June 2011


The Chart module was exchanged completely on the way to OpenOffice.org 2.3. 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.

  • ODF 1.1 is final.
  • The upcoming format ODF 1.2 is still in progress (look for the latest announcements and available documents here).
  • Proposals

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

The 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 published stable UNO API com::sun::star::chart for external use. There is also an internal API com::sun::star::chart2. The internal API is not published and is not guaranteed to be stable. It is subject to further changes - so don't count on it in scripts or something! Furthermore several things you can set with the internal API will not be saved by the application. So for stable work please use the published standard chart API com::sun::star::chart.

If you have questions on the chart development please use the mailing list dev@graphics.openoffice.org.

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:

Testing

You can help a lot with identifying new problems or verifying fixed and integrated issues!

Download the latest developer build 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:

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

Implemented Chart Features

Open Chart Features

Basic Macro Examples

Also have a look at the BASIC Developers Guide!

Contact

  • Development Contact: iha
Personal tools