Difference between revisions of "Chart2"

Latest revision as of 16:28, 6 June 2011

Chart Quick Links

New Features in OOo 3.3
New Features in OOo 3.2 or look at the GullFOSS Blog
New Features in OOo 3.1 or look at the GullFOSS Blog
New Features in OOo 3.0
New Features in OOo 2.4
New Features in OOo 2.3

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:

Open chart bugs (defects and tasks)
Requested chart features (enhancements and features)

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:

Open chart issues.
Or create your own query.

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

Change title formatting for all charts in a spreadsheet

Get the position of a chart within a spreadsheet

Create Chart in a presentation document

Export Charts from a Calc spreadsheet

Also have a look at the BASIC Developers Guide!

Contact

Development Contact: iha

@@ Line 1: / Line 1: @@
-This page gathers information about the new chart implementation of OpenOffice.org.
+{{ChartQuickLinks}}
+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.
-HERE - ADD some more information to make it look less empty...
+This page documents ongoing work, implemented and still missing features. It also links to further useful information around the chart.
+== Helping with the Chart ==
-== Compiling the new chart module ==
+[[Image:ProgrammingLanguage2s.png|frame|right|Example Chart made with OpenOffice.org 2.3 (ods-file see [[Image:ProgrammingLanguages.ods]])]]
-The first step anyone need to achieve before starting to develop on the chart module
+=== Development ===
-is compiling OpenOffice.org with the needed modifications for the new chart module.
-OpenOffice.org provides two main ways to compile it : the "Vanilla" way and the
-"OOoBuild" way. Let's explain what they are and the differences between those two
-ways.
-=== Compiling OpenOffice.org : the theory ===
+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]].
-==== Vanilla ====
+The file format used for OpenOffice.org is the ODF format.
+* [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 (look for the latest announcements and available documents [http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office here]).
+* [[Chart2/Proposals| Proposals]]
-Vanilla is the "standard" way to compile OOo. To compile OOo the "Vanilla" way,
+If you like to help developing the chart, you can find useful information at the following places:
-you only need to download the sources, unzip them, and follow the instructions given
+*[http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Charts/Charts Chart chapter in the Developers Guide]
-on the page [Add a link to the build steps from]. We will give Chart-specific details
+*[http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts Chart chapter in the BASIC Developers Guide]
-about this in the following sections.
+*[[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]]
-==== OOoBuild ====
+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.
-To make it simple, OOoBuild is a "wrapper" around the OpenOffice.org build process
+If you have questions on the chart development please use the mailing list [http://openoffice.org/projects/graphics/lists dev@graphics.openoffice.org].
-to make compiling OOo more straight-forward. Some of the enhancements added are :
-* patches for known compiling problems
+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:
-* integration with "[[ccache]]" and "[[icecream]]" to speed-up the process
+* [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)
-* linux distribution specific compiling steps (specific splash screen for Fedora...)
+* [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)
-So, to compile OOo with OOoBuild, just just need to download OOoBuild and put the
+=== Testing ===
-OOo standard sources in a specific directory.
-=== Compiling OpenOffice.org : the practice ===
+You can help a lot with identifying new problems or verifying fixed and integrated issues!
-==== Commmon steps ====
+[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:
-First of all before starting to compile anything, you will need to install all the
+* [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].
-dependencies and tools needed for the compiling steps. On the Tools project page,
+* 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].
-you should find all the information on the "Building the source" section :
-http://tools.openoffice.org/
+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!
-There, you should read the different sub-sections, they will give you a nice
+== Implemented Chart Features ==
-introduction on how everything works. You should also notice that the steps are
-different on each OS.
-==== Vanilla ====
+* [[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 ]]
-TODO : Describing the vanilla build process.
+== Open Chart Features ==
+* [[Chart2/ChartTypes      | Chart-Types ]]
+* [[Chart2/Legend          | Legend ]]
+* [[Chart2/DataLabels      | Data Labels ]]
+* [[Chart2/Axis            | Axis ]]
+* [[Chart2/ChartFormatting | Chart formatting ]]
+* [[Chart2/TrendLines      | Trend lines and error bars ]]
+* [[Chart2/Range           | Range and data series ]]
+* [[Chart2/ChartAnnotation | Chart annotation ]]
+* [[Chart2/Miscellaneous   | Miscellaneous ]]
-==== OOoBuild ====
+== Basic Macro Examples ==
-TODO : Describing the OOoBuild build process.
+* [[Chart2/ChangeTitleFormattingForAllChartsInACalc | Change title formatting for all charts in a spreadsheet ]]
+* [[Chart2/GetPositionOfAChart | Get the position of a chart within a spreadsheet ]]
-==== The bugs reported and the solutions. ====
+* [[API/Samples/StarBasic/Impress/Insert_a_Chart | Create Chart in a presentation document ]]
-During the compiling step, you will not be able to compile the whole code
+* [http://www.ooowiki.de/DiagrammExport Export Charts from a Calc spreadsheet ]
-== Developping for the new chart module ==
+Also have a look at the [http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide/Charts BASIC Developers Guide]!
-The common steps.
+== Contact ==
-== Documentation ==
+* Development Contact: [[User:Iha|iha]]
-== Some useful information ==
+[[Category:Chart2]]
+[[Category:Source directories]]
-* Web page : http://graphics.openoffice.org/chart/chart.html
-* specs : http://specs.openoffice.org/chart/index.html
-* Current CWS Name : [[http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Id=1074&Path=SRC680%2Fchart2mst3 chart2mst3]]
-[[Category:Calc issues]]

Difference between revisions of "Chart2"

Latest revision as of 16:28, 6 June 2011

Contents

Helping with the Chart

Development

Testing

Implemented Chart Features

Open Chart Features

Basic Macro Examples

Contact

Views

Personal tools

Navigation

Search

Tools