Difference between revisions of "Chart2"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (People)
 
(167 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<!-- LinkBox -->
+
{{ChartQuickLinks}}
<div style="float:right; padding-left:5px;">
+
{| style="text-align:left; border:1px solid #aaaaaa; background-color:#f9f9f9;"
+
|- padding:5px;padding-top:0.5em;font-size: 90%;
+
|
+
<center>'''Quick Links'''</center>
+
  
* [http://graphics.openoffice.org/chart/chart.html Chart Project Page on OOo]
+
The Chart module was exchanged completely on the way to OpenOffice.org 2.3.
* [http://specs.openoffice.org/chart/index.html Chart Specifications on OOo]
+
This is the basis for further enhancements and long awaited features.
* [irc://freenode/chart2.openoffice.org #chart2.openoffice.org]
+
* [http://blogs.sun.com/GullFOSS/tags/chart GullFOSS Blog]
+
----
+
* [[Chart2/Features2.3|Features in OOo 2.3]]
+
* [[Chart2/Features2.4|Features in OOo 2.4]]
+
|}
+
</div>
+
<!-- End of LinkBox -->
+
  
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.
+
This page documents ongoing work, implemented and still missing features. It also links to further useful information around the chart.
  
Charts are used for visualizing data sets from e.g. spreadsheets by two and three dimensional diagrams. There are a lot of different two- and three-dimensional chart types you can choose from. 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.
+
== Helping with the Chart ==
  
If you would like to participate, if you have comments or questions related to the chart you are welcome on the graphics mailing lists: (users,dev,features,bugs,cvs)@graphics.openoffice.org. See also the side-box with some useful Links.
+
[[Image:ProgrammingLanguage2s.png|frame|right|Example Chart made with OpenOffice.org 2.3 (ods-file see [[Image:ProgrammingLanguages.ods]])]]
  
== Helping with the Chart ==
 
 
=== Development ===
 
=== Development ===
  
If you like to help developing the chart, you can find useful information here.
+
If you are new to OpenOffice.org development have a look at the more general pages first:
 +
*[[Documentation/Building_Guide/Getting_the_source|  Getting the source code]]
 +
*[[Documentation/Building_Guide/Building_on_Windows| Building on Windows]]
 +
*[[Cpp_Coding_Standards|C++ Coding Standards]].
  
* [[Compiling the new chart module]]
+
The file format used for OpenOffice.org is the ODF format.
* [[Developing for the new chart module]]
+
* [http://www.oasis-open.org/specs/index.php#opendocumentv1.1 ODF 1.1] is final.
* [[FAQ about Chart API Compatibility]] If you have problems with Macros or extensions that use the com.sun.star.chart API you may find answers or ask questions on this page.
+
* 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]]
  
== Features ==
+
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/BASIC_Guide/Charts Chart chapter in the BASIC Developers Guide]
 +
*[[FAQ about Chart API Compatibility]]
 +
*[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]
 +
*[[Chart2/Open Technical Issue in Chart2|Notes on some technical issues]]
  
This section gives an overview over new features that are either integrated, planned for a future release or not yet planned to implement for a specific version.
+
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.
  
=== Past Releases ===
+
If you have questions on the chart development please use the mailing list [http://openoffice.org/projects/graphics/lists dev@graphics.openoffice.org].
  
The features listed here are integrated in the product, so they are available for download. ''Note: OOo 2.3 is not released yet, but will be very soon''
+
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://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://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)
  
* [[Chart2/Features2.3  | Features in OOo 2.3 ]]
+
=== Testing ===
  
=== Future Releases ===
+
You can help a lot with identifying new problems or verifying fixed and integrated issues!
  
The features listed here are planned for one of the upcoming releases.
+
[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:
  
* [[Chart2/Features2.4  | Features in OOo 2.4 ]]
+
* [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].
* [[Chart2/Features3.0  | Features in OOo 3.0 ]]
+
* 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].
  
=== Unplanned Features ===
+
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!
  
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''].
+
== 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/Features2.4  | Additional Features in OOo 2.4 ]]
 +
* [[Chart2/Features2.3  | Additional Features in OOo 2.3 ]]
 +
 +
== Open Chart Features ==
 
* [[Chart2/ChartTypes      | Chart-Types ]]
 
* [[Chart2/ChartTypes      | Chart-Types ]]
 
* [[Chart2/Legend          | Legend ]]
 
* [[Chart2/Legend          | Legend ]]
Line 63: Line 71:
 
* [[Chart2/Miscellaneous  | Miscellaneous ]]
 
* [[Chart2/Miscellaneous  | Miscellaneous ]]
  
== Technical Articles ==
+
== Basic Macro Examples ==
 
+
Here you can find some technical articles about the chart, that may help for future development.
+
 
+
* There still some [[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 ==
+
 
+
* working permanently on the code
+
** [[User:bm@openoffice.org|Björn Milcke]]
+
** [[User:Iha|Ingrid Halama]]
+
 
+
* code contributors
+
** Daniel Rentz (Calc)
+
** [[User:Nn|Niklas Nebel]] (Calc)
+
** Thomas Lange (Writer)
+
** Regina Henschel (splines, online-help, testing)
+
  
* other contributors
+
* [[Chart2/ChangeTitleFormattingForAllChartsInACalc | Change title formatting for all charts in a spreadsheet ]]
** [[User:Tonygalmiche|Tony Galmiche]] (feature document, Wiki, testing)
+
** [[User:Pagalmes|Pierre-André Galmes]] (testing, Wiki)
+
** Jörg Wartenberg (specification)
+
** [[User:Discoleo|Leonard Mada]] (Wiki)
+
  
* working permanently on chart QA
+
* [[Chart2/GetPositionOfAChart | Get the position of a chart within a spreadsheet ]]
** Thomas Klarhöfer (QA for chart)
+
** Jörg Sievers (Test-tool automation for chart)
+
  
* User Experience
+
* [[API/Samples/StarBasic/Impress/Insert_a_Chart | Create Chart in a presentation document ]]
** [[User:Mmp|Matthias Müller-Prove]]
+
  
* Documentation
+
* [http://www.ooowiki.de/DiagrammExport Export Charts from a Calc spreadsheet ]
** [[User:Ufi|Uwe Fischer]]
+
  
''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''
+
Also have a look at the [http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts BASIC Developers Guide]!
  
== Some useful information ==
+
== Contact ==
  
* Chart Project Page: http://graphics.openoffice.org/chart/chart.html
+
* Development Contact: [[User:Iha|iha]]
* Chart Specifications: http://specs.openoffice.org/chart/index.html
+
* IRC channel: [irc://freenode/chart2.openoffice.org #chart2.openoffice.org] on freenode
+
* Chart-related Entries on OOo Sun Developers Weblog: [http://blogs.sun.com/GullFOSS/tags/chart GullFOSS]
+
  
 
[[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