What chart features and attributes are supported by Chart Themes?

Issue:

[toc on_off::hide=1]

I am trying to learn what exact chart attributes and features are supported in JasperReports chart themes. It appears as though some are, and they are visible in the iReport designer (ex: domainGridlineVisible, backgroundPaint), but others are not. How do I know which are supported?

Resolution:

You can find the available options for chart theme definitions by examining the following XML definition file:

(in your ireport installation) ireportdemosampleschartthemessrcnetsfjasperreportschartthemessimplechart.theme.mapping.xml

For example, for iReport Designer and JasperReports Library v4.2, the list of supported attributes and elements for Plot charts looks like this: (the map-to xml value indicates the chart type)

<class name="net.sf.jasperreports.chartthemes.simple.PlotSettings">
  <map-to xml="plot"/>
  <field name="orientation" type="org.jfree.chart.plot.PlotOrientation" handler="net.sf.jasperreports.chartthemes.simple.handlers.PlotOrientationFieldHandler">
   <bind-xml node="attribute"/>
  </field>
  <field name="foregroundAlpha" type="java.lang.Float">
   <bind-xml node="attribute"/>
  </field>
  <field name="backgroundPaint" type="net.sf.jasperreports.chartthemes.simple.PaintProvider">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="backgroundAlpha" type="java.lang.Float">
   <bind-xml node="attribute"/>
  </field>
  <field name="backgroundImage" type="net.sf.jasperreports.chartthemes.simple.ImageProvider">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="backgroundImageAlpha" type="java.lang.Float">
   <bind-xml node="attribute"/>
  </field>
  <field name="backgroundImageAlignment" type="java.lang.String" handler="net.sf.jasperreports.chartthemes.simple.handlers.ImageAlignmentFieldHandler">
   <bind-xml node="attribute"/>
  </field>
  <field name="labelRotation" type="java.lang.Double">
   <bind-xml node="attribute"/>
  </field>
  <field name="padding" type="org.jfree.ui.RectangleInsets">
   <bind-xml node="element"/>
  </field>
  <field name="outlineVisible" type="java.lang.Boolean">
   <bind-xml node="attribute"/>
  </field>
  <field name="outlinePaint" type="net.sf.jasperreports.chartthemes.simple.PaintProvider">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="outlineStroke" type="java.awt.Stroke">
   <bind-xml auto-naming="deriveByClass" node="element"/>
  </field>
  <field name="seriesColorSequence" type="net.sf.jasperreports.chartthemes.simple.PaintProvider" collection="arraylist">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="seriesGradientPaintSequence" type="net.sf.jasperreports.chartthemes.simple.PaintProvider" collection="arraylist">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="seriesOutlinePaintSequence" type="net.sf.jasperreports.chartthemes.simple.PaintProvider" collection="arraylist">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="seriesStrokeSequence" type="java.awt.Stroke" collection="arraylist">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="seriesOutlineStrokeSequence" type="java.awt.Stroke" collection="arraylist">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="domainGridlineVisible" type="java.lang.Boolean">
   <bind-xml node="attribute"/>
  </field>
  <field name="domainGridlinePaint" type="net.sf.jasperreports.chartthemes.simple.PaintProvider">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="domainGridlineStroke" type="java.awt.Stroke">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="rangeGridlineVisible" type="java.lang.Boolean">
   <bind-xml node="attribute"/>
  </field>
  <field name="rangeGridlinePaint" type="net.sf.jasperreports.chartthemes.simple.PaintProvider">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="rangeGridlineStroke" type="java.awt.Stroke">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="tickLabelFont" type="net.sf.jasperreports.engine.JRFont">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
  <field name="displayFont" type="net.sf.jasperreports.engine.JRFont">
   <bind-xml auto-naming="deriveByField" node="element"/>
  </field>
</class>

Ref. Case #00020302 -- 20:02, 6 October 2011 (UTC)